Bluetooth: Controller: Clean up HCI macros
Bluetooth: Controller: Clean up HCI macros

Clean up, document and remove the macros used in hci.c
to access the different parameters and calculate lengths
of events and data structures.

Jira: ZEP-726

Change-Id: I476aa9e061dfe429b5181265167bffa203ed151b
Signed-off-by: Carles Cufi <853081dc8dca4fe6a7e3c984752718b5db36e060@nordicsemi.no>

rsalveti/zephyr,explora26/zephyr,ldts/zephyr,punitvara/zephyr,mbolivar/zephyr,ldts/zephyr,rsalveti/zephyr,aceofall/zephyr-iotos,punitvara/zephyr,runchip/zephyr-cc3200,ldts/zephyr,ldts/zephyr,runchip/zephyr-cc3220,fractalclone/zephyr-riscv,runchip/zephyr-cc3200,zephyrproject-rtos/zephyr,runchip/zephyr-cc3220,fractalclone/zephyr-riscv,zephyriot/zephyr,fractalclone/zephyr-riscv,tidyjiang8/zephyr-doc,galak/zephyr,kraj/zephyr,galak/zephyr,kraj/zephyr,GiulianoFranchetto/zephyr,bigdinotech/zephyr,rsalveti/zephyr,explora26/zephyr,bboozzoo/zephyr,mbolivar/zephyr,Vudentz/zephyr,rsalveti/zephyr,kraj/zephyr,bboozzoo/zephyr,sharronliu/zephyr,GiulianoFranchetto/zephyr,holtmann/zephyr,fbsder/zephyr,erwango/zephyr,runchip/zephyr-cc3220,runchip/zephyr-cc3200,galak/zephyr,fbsder/zephyr,kraj/zephyr,holtmann/zephyr,fbsder/zephyr,aceofall/zephyr-iotos,tidyjiang8/zephyr-doc,pklazy/zephyr,rsalveti/zephyr,holtmann/zephyr,fbsder/zephyr,nashif/zephyr,nashif/zephyr,bigdinotech/zephyr,aceofall/zephyr-iotos,zephyrproject-rtos/zephyr,sharronliu/zephyr,sharronliu/zephyr,bboozzoo/zephyr,zephyriot/zephyr,galak/zephyr,finikorg/zephyr,holtmann/zephyr,bigdinotech/zephyr,Vudentz/zephyr,ldts/zephyr,runchip/zephyr-cc3200,erwango/zephyr,runchip/zephyr-cc3220,GiulianoFranchetto/zephyr,fractalclone/zephyr-riscv,zephyriot/zephyr,bboozzoo/zephyr,sharronliu/zephyr,Vudentz/zephyr,explora26/zephyr,fbsder/zephyr,tidyjiang8/zephyr-doc,erwango/zephyr,finikorg/zephyr,zephyrproject-rtos/zephyr,mbolivar/zephyr,sharronliu/zephyr,punitvara/zephyr,Vudentz/zephyr,punitvara/zephyr,explora26/zephyr,fractalclone/zephyr-riscv,bigdinotech/zephyr,punitvara/zephyr,zephyrproject-rtos/zephyr,galak/zephyr,runchip/zephyr-cc3220,Vudentz/zephyr,nashif/zephyr,pklazy/zephyr,zephyriot/zephyr,erwango/zephyr,finikorg/zephyr,Vudentz/zephyr,pklazy/zephyr,erwango/zephyr,tidyjiang8/zephyr-doc,aceofall/zephyr-iotos,bboozzoo/zephyr,mbolivar/zephyr,nashif/zephyr,bigdinotech/zephyr,aceofall/zephyr-iotos,GiulianoFranchetto/zephyr,mbolivar/zephyr,finikorg/zephyr,explora26/zephyr,zephyrproject-rtos/zephyr,zephyriot/zephyr,holtmann/zephyr,finikorg/zephyr,pklazy/zephyr,runchip/zephyr-cc3200,GiulianoFranchetto/zephyr,pklazy/zephyr,kraj/zephyr,tidyjiang8/zephyr-doc,nashif/zephyr