zephyr/drivers
Florian Grandel 32e1213b0c net: l2: ieee802154: improve inline documentation
Over time, some non-standard concepts and extensions were introduced
into the stack (in KConfig, in drivers, in the internal API and into the
implementation) which makes introduction of additional standard-
compliant extensions like TSCH (and others) unnecessarily difficult.

To introduce extensions like TSCH it is required for the IEEE 802.15.4
stack to become more structurally aligned with the standard again which
will be the focus of some of the upcoming preparatory changes.

One way to check and prove standard compliance is to reference the
standard from within the source code. This change therefore introduces
inline references to the IEEE 802.15.4-2020 standard wherever possible.
Deviations from the standard are documented with TODO or deprecation
labels to be addressed in future changes.

In the future, new code introduced to the IEEE 802.15.4 stack should
be documented and reviewed for standard-compliance to avoid further
divergence. Most importantly:
* MAC/PHY configuration (via net mgmt, radio API, devicetree or
  KConfig) should always be directly linked to well-defined MAC/PHY
  PIB attributes if visible to the MAC API or the end user.
* Net management/shell/radio API commands should have a documented
  reference to the corresponding MLME action from the standard.

Signed-off-by: Florian Grandel <fgrandel@code-for-humans.de>
2023-05-24 16:41:57 +02:00
..
adc drivers: adc: stm32: allow to use multiple ADCs with STM32F3 series 2023-05-22 15:26:26 +02:00
audio sys/util: extend usage of DIV_ROUND_UP 2023-04-12 16:42:29 +02:00
bbram device: remove redundant init functions 2023-04-19 10:00:25 +02:00
bluetooth drivers: bluetooth: Add Infineon Bluetooth driver 2023-05-17 09:59:36 +03:00
cache
can can: mcan: fix setup configuration ram 2023-05-22 08:03:58 +00:00
clock_control drivers: clock_control: stm32u5: fix chain-load with asserts 2023-05-23 08:55:00 +02:00
console drivers console native_posix: Do not set buffering mode anymore 2023-05-23 12:56:38 +02:00
coredump
counter counter: counter_nrfx_rtc: Align to renamed nrfx symbols 2023-05-05 11:47:53 +02:00
crypto dts: arm: stm32h5: Add aes node 2023-05-16 18:19:26 +02:00
dac drivers: dac: make output buffer for STM32 DAC configurable 2023-05-23 13:02:25 +02:00
dai drivers: dai: ssp: fix power-up flow for Intel cAVS platforms 2023-04-21 14:02:02 -04:00
disk drivers: disk: sdmmc_stm32 support for clock divisor 2023-04-12 17:44:48 +02:00
display drivers: display: ili9342c display driver 2023-05-19 15:24:56 +02:00
dma drivers: dma: esp32xx: Fix get interrupts from DT 2023-05-23 08:55:51 +02:00
edac shell: fix MISRA 5.7 violations on struct shell 2023-04-14 12:21:08 +02:00
eeprom drivers: all: mchp_xec: remove conditional support for pinctrl 2023-04-24 13:34:22 +02:00
entropy drivers: entropy_mcux_caam: Add semaphore 2023-05-09 13:24:00 -05:00
espi intc: miwu: npcx: improve interrupt latency of miwu input events 2023-05-17 09:48:54 +02:00
ethernet drivers: ethernet: eth_stm32_hal: Configurable speed and duplex 2023-05-23 13:02:05 +02:00
flash drivers: flash: fix memcpy and invalidate dcache in hyperflash 2023-05-22 10:15:03 +02:00
fpga drivers: spi: make SPI dt-spec macros compatible with C++ 2023-04-24 21:29:55 +02:00
fuel_gauge drivers: sbs_gauge: Fix buffer overflow 2023-05-23 08:55:43 +02:00
gpio drivers: gpio: npm1300: Added status readback 2023-05-22 10:15:46 +02:00
hwinfo drivers: hwinfo: esp32_net: add support for esp32_net 2023-04-28 14:49:08 +02:00
i2c drivers: i2c: stm32: Add I2C support for STM32C0-series 2023-05-24 16:40:07 +02:00
i2s drivers: i2s_mcux_flexcomm: Fix instance macro 2023-05-12 06:21:13 -05:00
i3c drivers: i3c: mcux: fix issues when only i2c devices are on the bus 2023-05-17 09:34:31 -05:00
ieee802154 net: l2: ieee802154: improve inline documentation 2023-05-24 16:41:57 +02:00
input input: npcx_kbd: set the thread name 2023-05-18 09:32:33 +02:00
interrupt_controller intc: miwu: npcx: improve interrupt latency of miwu input events 2023-05-17 09:48:54 +02:00
ipm init: remove the need for a dummy device pointer in SYS_INIT functions 2023-04-12 14:28:07 +00:00
kscan input: convert the Nuvoton npcx keyboard scan driver to input 2023-05-18 09:32:33 +02:00
led drivers: led: shell: Correct command help of set_brightness 2023-04-24 16:29:30 +02:00
led_strip sys: util: migrate all files to DIV_ROUND_UP 2023-04-11 12:00:37 +02:00
lora drivers: lora: sx126x: Support fine-grained STM32WL PA config 2023-04-24 13:33:25 +02:00
mbox
mdio
memc drivers: memc: add update clock function 2023-05-22 10:15:03 +02:00
mipi_dsi drivers: display: update MCUX ELCDIF driver to use new lcdif binding 2023-05-11 10:04:24 +02:00
misc drivers: misc: Add driver for RaspberryPi Pico PIO 2023-04-25 13:12:02 +02:00
mm xtensa: use sys_cache API instead of custom interfaces 2023-04-26 07:31:22 -04:00
modem modem: modem_iface_uart_async: handle RX errors 2023-05-08 16:42:58 +02:00
net
neural_net xtensa: use sys_cache API instead of custom interfaces 2023-04-26 07:31:22 -04:00
pcie iterable_sections: move to specific header 2023-05-22 10:42:30 +02:00
peci drivers: all: mchp_xec: remove conditional support for pinctrl 2023-04-24 13:34:22 +02:00
pinctrl drivers: pinctrl_nrf: Fix disconnecting of pins 2023-05-22 12:02:45 +02:00
pm_cpu_ops
power_domain
ps2 drivers: all: mchp_xec: remove conditional support for pinctrl 2023-04-24 13:34:22 +02:00
ptp_clock
pwm drivers: pwm: pwm_nrfx: Apply workaround for stopping PWM instance 2023-05-18 12:01:30 +02:00
regulator drivers: regulator: adp5360: initial version 2023-05-24 11:54:30 +00:00
reset device: remove redundant init functions 2023-04-19 10:00:25 +02:00
retained_mem retention: Add optional mutex disablement 2023-04-24 13:27:53 +02:00
rtc drivers: rtc: rtc_mc146818: Added RTC driver for Motorola MC146818B 2023-04-27 14:15:22 +02:00
sdhc drivers: sdhc: add support for using CPOL/CPHA SPI clock modes 2023-04-26 20:07:53 +02:00
sensor drivers: sensor: mcp9600 add intial driver support 2023-05-23 13:33:45 -05:00
serial driver: uart: pl011: fix interrupt driven API 2023-05-17 09:49:03 +02:00
sip_svc subsystem: sip_svc: Add ARM SiP SVC subsystem 2023-05-09 08:46:50 -04:00
smbus smbus: Change init priority from DEVICE to DEFAULT 2023-04-21 16:26:28 +02:00
spi drivers: spi: add SPI device statistics 2023-05-23 22:15:25 -04:00
syscon
timer drivers: timer: nxp: Conditionally compile the wakeup source 2023-05-17 14:35:10 -05:00
usb iterable_sections: move to specific header 2023-05-22 10:42:30 +02:00
usb_c
video video: mt9m114: YUV pixel format support 2023-05-19 15:45:50 +02:00
virtualization drivers: virtualization: Add implementation for ivshmem-v2 2023-05-14 18:17:33 -04:00
w1 drivers: w1: Make 1-Wire Skip ROM cmd. optional 2023-05-19 16:29:35 +02:00
watchdog drivers: watchdog: add Xilinx AXI Timebase WDT driver 2023-05-19 16:14:24 +02:00
wifi driver: wifi: esp32: add wifi statistics info 2023-05-11 10:05:04 +02:00
xen init: remove the need for a dummy device pointer in SYS_INIT functions 2023-04-12 14:28:07 +00:00
CMakeLists.txt drivers: sip_svc: Add driver for SiP Supervisory call 2023-05-09 08:46:50 -04:00
Kconfig drivers: sip_svc: Add driver for SiP Supervisory call 2023-05-09 08:46:50 -04:00