include/zephyr: Add 'version' and 'since' tag to groups

Based on information from doc/develop/api/overview.rst, add current
version for some groups representing APIs, following the following
table:

  - Experimental:   0.1.0
  - Unstable:       0.8.0
  - Stable:         1.0.0

Also based on doc/develop/api/overview.rst, add 'since' tag to the
groups.

Signed-off-by: Ederson de Souza <[email protected]>
Signed-off-by: Anas Nashif <[email protected]>

doc/_doxygen/groups.dox

@@ -68,6 +68,8 @@
 
 @brief Modem APIs
 @defgroup modem Modem APIs
+@since 3.5
+@version 0.1.0
 @{
 @}
 

include/zephyr/audio/codec.h

@@ -18,6 +18,8 @@
  * @brief Abstraction for audio codecs
  *
  * @defgroup audio_codec_interface Audio Codec Interface
+ * @since 1.13
+ * @version 0.1.0
  * @ingroup audio_interface
  * @{
  */

include/zephyr/audio/dmic.h

@@ -28,6 +28,8 @@
  * @brief Abstraction for digital microphones
  *
  * @defgroup audio_dmic_interface Digital Microphone Interface
+ * @since 1.13
+ * @version 0.1.0
  * @ingroup audio_interface
  * @{
  */

include/zephyr/bluetooth/bluetooth.h

@@ -34,6 +34,8 @@ extern "C" {
 /**
  * @brief Generic Access Profile (GAP)
  * @defgroup bt_gap Generic Access Profile (GAP)
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup bluetooth
  * @{
  */

include/zephyr/crypto/crypto.h

@@ -27,6 +27,8 @@
 /**
  * @brief Crypto APIs
  * @defgroup crypto Crypto
+ * @since 1.7
+ * @version 1.0.0
  * @ingroup os_services
  * @{
  */

include/zephyr/device.h

@@ -24,6 +24,8 @@ extern "C" {
 /**
  * @brief Device Model
  * @defgroup device_model Device Model
+ * @since 1.0
+ * @version 1.0.0
  * @{
  */
 

include/zephyr/devicetree.h

@@ -28,6 +28,8 @@
 /**
  * @brief devicetree.h API
  * @defgroup devicetree Devicetree
+ * @since 2.2
+ * @version 1.0.0
  * @{
  * @}
  */

include/zephyr/drivers/adc.h

@@ -24,6 +24,8 @@ extern "C" {
 /**
  * @brief ADC driver APIs
  * @defgroup adc_interface ADC driver APIs
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/auxdisplay.h

@@ -15,6 +15,8 @@
 /**
  * @brief Auxiliary (Text) Display Interface
  * @defgroup auxdisplay_interface Text Display Interface
+ * @since 3.4
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/can.h

@@ -30,6 +30,8 @@ extern "C" {
 /**
  * @brief CAN Interface
  * @defgroup can_interface CAN Interface
+ * @since 1.12
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/can/transceiver.h

@@ -17,6 +17,8 @@ extern "C" {
 /**
  * @brief CAN Transceiver Driver APIs
  * @defgroup can_transceiver CAN Transceiver
+ * @since 3.1
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/clock_control.h

@@ -17,6 +17,8 @@
 /**
  * @brief Clock Control Interface
  * @defgroup clock_control_interface Clock Control Interface
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/counter.h

@@ -16,6 +16,8 @@
 /**
  * @brief Counter Interface
  * @defgroup counter_interface Counter Interface
+ * @since 1.14
+ * @version 0.8.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/dac.h

@@ -21,6 +21,8 @@ extern "C" {
 /**
  * @brief DAC driver APIs
  * @defgroup dac_interface DAC driver APIs
+ * @since 2.3
+ * @version 0.8.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/dai.h

@@ -14,6 +14,8 @@
 
 /**
  * @defgroup dai_interface DAI Interface
+ * @since 3.1
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @brief DAI Interface
  *

include/zephyr/drivers/disk.h

@@ -21,6 +21,8 @@
 /**
  * @brief Disk Driver Interface
  * @defgroup disk_driver_interface Disk Driver Interface
+ * @since 1.6
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/display.h

@@ -15,6 +15,8 @@
 /**
  * @brief Display Interface
  * @defgroup display_interface Display Interface
+ * @since 1.14
+ * @version 0.8.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/dma.h

@@ -24,6 +24,8 @@ extern "C" {
 /**
  * @brief DMA Interface
  * @defgroup dma_interface DMA Interface
+ * @since 1.5
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/edac.h

@@ -18,6 +18,8 @@
 
 /**
  * @defgroup edac EDAC API
+ * @since 2.5
+ * @version 0.8.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/eeprom.h

@@ -19,6 +19,8 @@
 /**
  * @brief EEPROM Interface
  * @defgroup eeprom_interface EEPROM Interface
+ * @since 2.1
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/entropy.h

@@ -16,6 +16,8 @@
 /**
  * @brief Entropy Interface
  * @defgroup entropy_interface Entropy Interface
+ * @since 1.10
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/flash.h

@@ -45,6 +45,8 @@ struct flash_pages_layout {
 /**
  * @brief FLASH Interface
  * @defgroup flash_interface FLASH Interface
+ * @since 1.2
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/fuel_gauge.h

@@ -11,6 +11,8 @@
 /**
  * @brief Fuel Gauge Interface
  * @defgroup fuel_gauge_interface Fuel Gauge Interface
+ * @since 3.3
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/gnss.h

@@ -15,6 +15,8 @@
 /**
  * @brief GNSS Interface
  * @defgroup gnss_interface GNSS Interface
+ * @since 3.6
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/gpio.h

@@ -32,6 +32,8 @@ extern "C" {
 /**
  * @brief GPIO Driver APIs
  * @defgroup gpio_interface GPIO Driver APIs
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/hwinfo.h

@@ -16,6 +16,8 @@
 /**
  * @brief Hardware Information Interface
  * @defgroup hwinfo_interface Hardware Info Interface
+ * @since 1.14
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/i2c.h

@@ -15,6 +15,8 @@
 /**
  * @brief I2C Interface
  * @defgroup i2c_interface I2C Interface
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/i2c/target/eeprom.h

@@ -15,6 +15,8 @@
 /**
  * @brief I2C EEPROM Target Driver API
  * @defgroup i2c_eeprom_target_api I2C EEPROM Target Driver API
+ * @since 1.13
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/i2s.h

@@ -14,6 +14,8 @@
 
 /**
  * @defgroup i2s_interface I2S Interface
+ * @since 1.9
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @brief I2S (Inter-IC Sound) Interface
  *

include/zephyr/drivers/i3c.h

@@ -11,6 +11,8 @@
 /**
  * @brief I3C Interface
  * @defgroup i3c_interface I3C Interface
+ * @since 3.2
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/ipm.h

@@ -16,6 +16,8 @@
 /**
  * @brief IPM Interface
  * @defgroup ipm_interface IPM Interface
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/kscan.h

@@ -28,6 +28,8 @@ extern "C" {
 /**
  * @brief KSCAN APIs
  * @defgroup kscan_interface Keyboard Scan Driver APIs
+ * @since 2.1
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/led.h

@@ -15,6 +15,8 @@
 /**
  * @brief LED Interface
  * @defgroup led_interface LED Interface
+ * @since 1.12
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/lora.h

@@ -15,6 +15,8 @@
  * @file
  * @brief Public LoRa APIs
  * @defgroup lora_api LoRa APIs
+ * @since 2.2
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/mbox.h

@@ -20,6 +20,8 @@ extern "C" {
 /**
  * @brief MBOX Interface
  * @defgroup mbox_interface MBOX Interface
+ * @since 1.0
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  *

include/zephyr/drivers/mipi_dbi.h

@@ -24,6 +24,8 @@
 /**
  * @brief MIPI-DBI driver APIs
  * @defgroup mipi_dbi_interface MIPI-DBI driver APIs
+ * @since 3.6
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/mipi_dsi.h

@@ -15,6 +15,8 @@
 /**
  * @brief MIPI-DSI driver APIs
  * @defgroup mipi_dsi_interface MIPI-DSI driver APIs
+ * @since 3.1
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/misc/timeaware_gpio/timeaware_gpio.h

@@ -14,6 +14,8 @@
 /**
  * @brief Time-aware GPIO Interface
  * @defgroup tgpio_interface Time-aware GPIO Interface
+ * @since 3.5
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/peci.h

@@ -15,6 +15,8 @@
 /**
  * @brief PECI Interface 3.0
  * @defgroup peci_interface PECI Interface
+ * @since 2.1
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/pinctrl.h

@@ -14,6 +14,8 @@
 /**
  * @brief Pin Controller Interface
  * @defgroup pinctrl_interface Pin Controller Interface
+ * @since 3.0
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/pwm.h

@@ -16,6 +16,8 @@
 /**
  * @brief PWM Interface
  * @defgroup pwm_interface PWM Interface
+ * @since 1.0
+ * @version 1.0.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/regulator.h

@@ -13,6 +13,8 @@
 /**
  * @brief Regulator Interface
  * @defgroup regulator_interface Regulator Interface
+ * @since 2.4
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/reset.h

@@ -15,6 +15,8 @@
 /**
  * @brief Reset Controller Interface
  * @defgroup reset_controller_interface Reset Controller Interface
+ * @since 3.1
+ * @version 0.1.0
  * @ingroup io_interfaces
  * @{
  */

include/zephyr/drivers/retained_mem.h

@@ -30,6 +30,8 @@ BUILD_ASSERT(!(sizeof(off_t) > sizeof(size_t)),
 /**
  * @brief Retained memory driver interface
  * @defgroup retained_mem_interface Retained memory driver interface
+ * @since 3.4
+ * @version 0.8.0
  * @ingroup io_interfaces
  * @{
  */