samples: sensor: use zephyr:code-sample directive

Describe the samples using code-sample directive in preparation for
upcoming changes to the Zephyr documentation that will be leveraging
the provided description and metadata.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
This commit is contained in:
Benjamin Cabé 2024-09-02 17:06:55 +02:00 committed by Carles Cufí
parent 20fb6b6d24
commit ee77704715
60 changed files with 247 additions and 176 deletions

View file

@ -376,7 +376,7 @@ The green lightwell LED can be tested with the :zephyr:code-sample:`blinky` exam
Also the temperature and humidity sensor can be tested with the :ref:`hts221` Also the temperature and humidity sensor can be tested with the :zephyr:code-sample:`hts221`
sample. sample.
.. zephyr-app-commands:: .. zephyr-app-commands::

View file

@ -43,8 +43,8 @@ Pin Assignment of the FRDM-STBC-AGM01 Shield
For more information about the FXOS8700, FXAS21002, and FRDM-STBC-AGM01 For more information about the FXOS8700, FXAS21002, and FRDM-STBC-AGM01
board: board:
- :ref:`fxos8700` - :zephyr:code-sample:`fxos8700`
- :ref:`fxas21002` - :zephyr:code-sample:`fxas21002`
- `FRDM-STBC-AGM01 Website`_ - `FRDM-STBC-AGM01 Website`_
- `FRDM-STBC-AGM01 Quick Reference Card`_ - `FRDM-STBC-AGM01 Quick Reference Card`_
- `FRDM-STBC-AGM01 Schematics`_ - `FRDM-STBC-AGM01 Schematics`_

View file

@ -58,7 +58,7 @@ External links
Samples Samples
******* *******
The sample :ref:`vl53l0x` demonstrates how to use the ranging sensor VL53L0X The sample :zephyr:code-sample:`vl53l0x` demonstrates how to use the ranging sensor VL53L0X
using the center sensor only. using the center sensor only.
The sample :zephyr:code-sample:`x-nucleo-53l0a1` sample demonstrates how to use the three The sample :zephyr:code-sample:`x-nucleo-53l0a1` sample demonstrates how to use the three

View file

@ -1,7 +1,8 @@
.. _accel_polling: .. zephyr:code-sample:: accel_polling
:name: Generic 3-Axis accelerometer polling
:relevant-api: sensor_interface
Generic 3-Axis accelerometer polling sample Get 3-Axis accelerometer data from a sensor (polling mode).
###########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _adc_cmp_npcx: .. zephyr:code-sample:: adc_cmp_npcx
:name: NPCX ADC Comparator
:relevant-api: sensor_interface
NPCX ADC Comparator Detect upper/lower voltage limits using NPCX ADC Comparator driver.
###################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _adt7420: .. zephyr:code-sample:: adt7420
:name: ADT7420 high-accuracy digital I2C temperature sensor
:relevant-api: sensor_interface
ADT7420: High accuracy digital I2C temperature sensor Get temperature data from an ADT7420 sensor using polling and window mode.
#####################################################
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _amg88xx: .. zephyr:code-sample:: amg88xx
:name: AMG88XX infrared array sensor
:relevant-api: sensor_interface
AMG88XX Infrared Array Sensor Get temperature data from an AMG88XX 8x8 thermal camera sensor.
#############################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _ams_iaqcore: .. zephyr:code-sample:: ams_iaqcore
:name: ams iAQcore indoor air quality sensor
:relevant-api: sensor_interface
ams iAQcore Indoor air quality sensor Get CO2 equivalent and VOC data from an ams iAQcore sensor.
#####################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _apds9960: .. zephyr:code-sample:: apds9960
:name: APDS9960 RGB, ambient light, and gesture sensor
:relevant-api: sensor_interface
APDS9960 RGB, Ambient Light, Gesture Sensor Get ambient light, RGB, and proximity/gesture data from an APDS9960 sensor.
###########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _bme280: .. zephyr:code-sample:: bme280
:name: BME280 humidity and pressure sensor
:relevant-api: sensor_interface
BME280 Humidity and Pressure Sensor Get temperature, pressure, and humidity data from a BME280 sensor.
###################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _bmi270: .. zephyr:code-sample:: bmi270
:name: BMI270 6-axis IMU sensor
:relevant-api: sensor_interface
BMI270: 6 axis inertial measurement unit Configure and read accelerometer and gyroscope data from a BMI270 sensor.
########################################
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _bq274xx-sample: .. zephyr:code-sample:: bq274xx
:name: BQ274XX fuel gauge sensor
:relevant-api: sensor_interface
BQ274XX Sensor Sample Get various fuel gauge parameters from a BQ274XX sensor.
#####################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _ccs811: .. zephyr:code-sample:: ccs811
:name: CCS811 indoor air quality sensor
:relevant-api: sensor_interface
CCS811 Indoor Air Quality Sensor Get CO2 equivalent and VOC data from a CCS811 sensor.
################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. co2: .. zephyr:code-sample:: co2
:name: Generic CO2 polling sample
:relevant-api: sensor_interface
Generic CO2 polling sample Get CO2 data from a sensor (polling mode).
##########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _dht_polling: .. zephyr:code-sample:: dht_polling
:name: Generic digital humidity temperature sensor polling
:relevant-api: sensor_interface
Generic Digital Humidity Temperature sensor polling sample Get temperature and humidity data from a DHT sensor (polling mode).
##########################################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _die_temp_polling: .. zephyr:code-sample:: die_temp_polling
:name: CPU die temperature polling
:relevant-api: sensor_interface
CPU Die Temperature polling Get CPU die temperature data from a sensor using polling.
###########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _ds18b20_sample: .. zephyr:code-sample:: ds18b20
:name: DS18B20 1-Wire Temperature Sensor
:relevant-api: sensor_interface w1_sensor
DS18B20 1-Wire Temperature Sensor Get ambient temperature data from a DS18B20 sensor (polling mode).
#################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _fdc2x1x: .. zephyr:code-sample:: fdc2x1x
:name: FDC2X1X Capacitance-to-Digital Converter
:relevant-api: sensor_interface
FDC2X1X: Capacitance-to-Digital Converter Get capacitance and frequency data from a FDC2X1X sensor (polling & trigger).
#########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _fxas21002: .. zephyr:code-sample:: fxas21002
:name: FXAS21002 Gyroscope Sensor
:relevant-api: sensor_interface
FXAS21002 Gyroscope Sensor Get gyroscope data synchronously from an FXAS21002 sensor.
##########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _fxos8700: .. zephyr:code-sample:: fxos8700
:name: FXOS8700 Accelerometer/Magnetometer Sensor
:relevant-api: sensor_interface
FXOS8700 Accelerometer/Magnetometer Sensor Get accelerometer and magnetometer data from an FXOS8700 sensor (polling & trigger mode).
##########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _grove_light: .. zephyr:code-sample:: grove_light
:name: Grove Light Sensor
:relevant-api: sensor_interface
Grove Light Sensor Get illuminance data from a Grove Light Sensor.
##################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _grove_temperature: .. zephyr:code-sample:: grove_temperature
:name: Grove Temperature Sensor
:relevant-api: sensor_interface
Grove Temperature Sensor Get temperature data from a Grove temperature sensor and display it on an LCD display.
########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _grow_r502a: .. zephyr:code-sample:: grow_r502a
:name: GROW R502-A Fingerprint Sensor
:relevant-api: sensor_interface
GROW_R502A Fingerprint Sensor Store and match fingerprints using the GROW R502-A fingerprint sensor.
#############################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _hts221: .. zephyr:code-sample:: hts221
:name: HTS221 Temperature and Humidity Monitor
:relevant-api: sensor_interface
HTS221: Temperature and Humidity Monitor Get temperature and humidity data from an HTS221 sensor (polling & trigger mode).
########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _i3g4250d: .. zephyr:code-sample:: i3g4250d
:name: I3G4250D 3-axis gyroscope sensor
:relevant-api: sensor_interface
I3G4250D: 3-axis digital output gyroscope Get gyroscope data from an I3G4250D sensor.
#########################################
Description Description
*********** ***********

View file

@ -1,7 +1,9 @@
.. _icm42605: .. zephyr:code-sample:: icm42605
:name: MPU6050 Invensense Motion Tracking Device
:relevant-api: sensor_interface
MPU6050: Invensense Motion Tracking Device Get temperature, acceleration, and angular velocity from an ICM42605 sensor (polling & trigger
########################################## mode).
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _ina219: .. zephyr:code-sample:: ina219
:name: INA219 Bidirectional Power/Current Monitor
:relevant-api: sensor_interface
INA219 Bidirectional Power/Current Monitor Get shunt voltage, bus voltage, power and current from an INA219 sensor.
##########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _isl29035: .. zephyr:code-sample:: isl29035
:name: ISL29035 Digital Light Sensor
:relevant-api: sensor_interface
ISL29035: Digital Light Sensor Get light intensity data from an ISL29035 sensor (polling & trigger mode).
##############################
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _jc42-sample: .. zephyr:code-sample:: jc42
:name: JEDEC JC 42.4 compliant Temperature Sensor
:relevant-api: sensor_interface
JEDEC JC 42.4 compliant Temperature Sensor Get ambient temperature from a JEDEC JC 42.4 compliant temperature sensor (polling & trigger
########################################## mode).
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _lis2dh: .. zephyr:code-sample:: lis2dh
:name: LIS2DH Motion Sensor
:relevant-api: sensor_interface
LIS2DH: Motion Sensor Monitor Get accelerometer data from an LIS2DH sensor (polling & trigger mode).
#############################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _lps22hb: .. zephyr:code-sample:: lps22hb
:name: LPS22HB Temperature and Pressure Sensor
:relevant-api: sensor_interface
LPS22HB: Temperature and Pressure Monitor Get pressure and temperature data from an LPS22HB sensor (polling mode).
#########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _lps22hh: .. zephyr:code-sample:: lps22hh
:name: LPSS22HH Temperature and Pressure Sensor
:relevant-api: sensor_interface
LPS22HH: Temperature and Pressure Monitor Get pressure and temperature data from an LPS22HH sensor (polling & trigger mode).
#########################################
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _lps22hh_i3c: .. zephyr:code-sample:: lps22hh_i3c
:name: LPSS22HH Temperature and Pressure Sensor (I3C)
:relevant-api: sensor_interface
LPS22HH: Temperature and Pressure Monitor (I3C) Get pressure and temperature data from an LPS22HH sensor over I3C (polling &
############################################### trigger mode).
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _lsm303dlhc: .. zephyr:code-sample:: lsmd303dlhc
:name: LSM303DLHC Magnetometer and Accelerometer sensor
:relevant-api: sensor_interface
LSM303DLHC: Magnetometer and Accelerometer data Monitor Get magnetometer and accelerometer data from an LSM303DLHC sensor (polling
####################################################### mode).
Overview Overview
******** ********

View file

@ -1,10 +1,13 @@
.. _lsm6dsl: .. zephyr:code-sample:: lsmd6dsl
:name: LSM6DSL IMU sensor
:relevant-api: sensor_interface
LSM6DSL: IMU sensor Monitor Get accelerometer and gyroscope data from an LSM6DSL sensor (polling & trigger
########################### mode).
Overview Overview
******** ********
This sample sets the LSM6DSL accelerometer and gyroscope to 104Hz This sample sets the LSM6DSL accelerometer and gyroscope to 104Hz
and enable a trigger on data ready. It displays on the console the and enable a trigger on data ready. It displays on the console the
values for accelerometer and gyroscope, plus optionally the values of values for accelerometer and gyroscope, plus optionally the values of

View file

@ -1,7 +1,9 @@
.. _lsm6dso: .. zephyr:code-sample:: lsmd6dso
:name: LSM6DSO IMU sensor
:relevant-api: sensor_interface
LSM6DSO: IMU Sensor Monitor Get accelerometer and gyroscope data from an LSM6DSO sensor (polling & trigger
########################### mode).
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _lsm6dso_i2c_on_i3c: .. zephyr:code-sample:: lsmd6dso_i2c_on_i3c
:name: LSM6DSO IMU sensor (I2C on I3C bus)
:relevant-api: sensor_interface
LSM6DSO: IMU Sensor Monitor (I2C on I3C bus) Get accelerometer and gyroscope data from an LSM6DSO sensor using I2C on I3C
############################################ bus (polling & trigger mode).
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _magn-polling-sample: .. zephyr:code-sample:: magn_polling
:name: Magnetometer Sensor
:relevant-api: sensor_interface
BMC150 Magnetometer Sample Get magnetometer data from a magnetometer sensor (polling mode).
##########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _max17262: .. zephyr:code-sample:: max17262
:name: MAX17262 Fuel Gauge Sensor
:relevant-api: sensor_interface
MAX17262 Fuel Gauge Sensor Get voltage, current and temperature data from a MAX17262 sensor (polling mode).
###################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _max30101: .. zephyr:code-sample:: max30101
:name: MAX30101 Heart Rate Sensor
:relevant-api: sensor_interface
MAX30101 Heart Rate Sensor Get heart rate data from a MAX30101 sensor (polling mode).
##########################
Overview Overview
******** ********

View file

@ -1,5 +1,9 @@
MAX6675 K-thermocouple to digital converter .. zephyr:code-sample:: max6675
########################################### :name: MAX6675 K-thermocouple to digital converter
:relevant-api: sensor_interface
Get temperature from a MAX6675 K-thermocouple to digital converter (polling
mode).
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _mcux_acmp: .. zephyr:code-sample:: mcux_acmp
:name: NXP MCUX Analog Comparator (ACMP)
:relevant-api: sensor_interface
NXP MCUX Analog Comparator (ACMP) Get analog comparator data from an NXP MCUX Analog Comparator (ACMP).
#################################
Overview Overview
******** ********

View file

@ -1,12 +1,13 @@
.. _mcux_lpcmp: .. zephyr:code-sample:: mcux_lpcmp
:name: NXP MCUX Low-power Analog Comparator (LPCMP)
:relevant-api: sensor_interface
NXP MCUX Low-power Analog Comparator (LPCMP) Get analog comparator data from an NXP MCUX Low-power Analog Comparator (LPCMP).
############################################
Overview Overview
******** ********
This sample show how to use the NXP MCUX Analog Comparator (LPCMP) driver. This sample show how to use the NXP MCUX Low-power Analog Comparator (LPCMP) driver.
In this application, the negative input port of the LPCMP is set to 7 which In this application, the negative input port of the LPCMP is set to 7 which
means the input voltage comes from the LPCMP internal DAC, the reference means the input voltage comes from the LPCMP internal DAC, the reference

View file

@ -1,7 +1,8 @@
.. _mpr-sample: .. zephyr:code-sample:: mpr
:name: MPR Pressure Sensor
:relevant-api: sensor_interface
MPR Pressure Sensor Get atmospheric pressure data from an MPR pressure sensor.
###################
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _mpu6050: .. zephyr:code-sample:: mpu6050
:name: MPU6050 motion tracking device
:relevant-api: sensor_interface
MPU6050: Invensense Motion Tracking Device Get temperature, acceleration, and angular velocity from an MPU6050 sensor (polling & trigger
########################################## mode).
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _ms5837-sample: .. zephyr:code-sample:: ms5837
:name: MS5837 Digital Pressure Sensor
:relevant-api: sensor_interface
MS5837 Sensor Sample Get pressure and temperature data from an MS5837 sensor (polling mode).
####################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _tmd2620: .. zephyr:code-sample:: proximity_polling
:name: Proximity sensor
:relevant-api: sensor_interface
Generic Proximity Sensor Sample Get proximity data from up to 10 proximity sensors (polling mode).
###############################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _qdec_sensor: .. zephyr:code-sample:: qdec
:name: Quadrature Decoder Sensor
:relevant-api: sensor_interface
Quadrature Decoder Sensor Get rotation data from a quadrature decoder sensor.
#########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _sensor_shell_sample: .. zephyr:code-sample:: sensor_shell
:name: Sensor shell
:relevant-api: sensor_interface
Sensor Shell Module Sample Interact with sensors using the shell module.
##########################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _sgp40_sht4x: .. zephyr:code-sample:: sgp40_sht4x
:name: SGP40 and SHT4X digital humidity and multipixel gas sensor
:relevant-api: sensor_interface
SGP40 and SHT4X: High accuracy digital I2C humidity sensor and multipixel gas sensor Get temperature, humidity and gas sensor data from SGP40 and SHT4X sensors (polling mode).
####################################################################################
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _sht3xd: .. zephyr:code-sample:: sht3xd
:name: SHT3XD humidity sensor
:relevant-api: sensor_interface
SHT3XD: High accuracy digital I2C humidity sensor Get temperature and humidity from a SHT3XD sensor (polling & trigger mode).
#################################################
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _sm351lt: .. zephyr:code-sample:: sm351lt
:name: SM351LT Magnetoresistive Sensor
:relevant-api: sensor_interface
SM351LT: Magnetoresistive Sensor Example Detect a magnet's presence using the SM351LT magnetoresistive sensor (polling & trigger mode).
########################################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _soc_voltage: .. zephyr:code-sample:: soc_voltage
:name: SoC Voltage Sensor
:relevant-api: sensor_interface
SoC voltage sensor measurement Get voltage data from an SoC's voltage sensor(s).
##############################
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _th02-sample: .. zephyr:code-sample:: th02
:name: TH02 Temperature and Humidity Sensor
:relevant-api: sensor_interface
TH02: Temperature and Humidity Monitor Get temperature and humidity data from a TH02 sensor (polling mode).
######################################
Overview Overview
******** ********

View file

@ -1,7 +1,9 @@
.. _thermometer-sample: .. zephyr:code-sample:: thermometer
:name: Thermometer
:relevant-api: sensor_interface
Thermometer sample Get ambient temperature data from a temperature sensor and get alerts when temperature drifts
################## above a threshold. (polling & trigger mode).
Overview Overview
******** ********

View file

@ -1,7 +1,8 @@
.. _tmp108_sample: .. zephyr:code-sample:: tmp108
:name: TMP108 Temperature Sensor
:relevant-api: sensor_interface
TMP108 sample Get temperature data from a TMP108 sensor (polling & trigger mode).
#############
Description Description
*********** ***********

View file

@ -1,7 +1,8 @@
.. _tmp112_sample: .. zephyr:code-sample:: tmp112
:name: TMP112 Temperature Sensor
:relevant-api: sensor_interface
TMP112 sample Get temperature data from a TMP112 sensor (polling & trigger mode).
#############
Overview Overview
******** ********

View file

@ -1,10 +1,12 @@
.. _vcnl4040_sample: .. zephyr:code-sample:: vcml4040
:name: VCNL4040 Proximity and Ambient Light Sensor
:relevant-api: sensor_interface
VCNL4040: proximity and ambient light sensor Get proximity and ambient light data from a VCNL4040 sensor (polling & trigger mode).
############################################
Overview Overview
******** ********
This sample periodically measures proximity and light for This sample periodically measures proximity and light for
5 sec in the interval of 300msec in polling mode. Then threshold trigger mode 5 sec in the interval of 300msec in polling mode. Then threshold trigger mode
is enabled with the high threshold value of 127 and data is fetched based is enabled with the high threshold value of 127 and data is fetched based

View file

@ -1,7 +1,8 @@
.. veaa_x_3: .. zephyr:code-sample:: veea_x_3
:name: VEAA-X-3 proportional pressure control valve
:relevant-api: sensor_interface
VEAA-X-3 sample Control a VEAA-X-3 proportional pressure control valve.
##########################
Overview Overview
******** ********

View file

@ -1,15 +1,16 @@
.. _vl53l0x: .. zephyr:code-sample:: vl53l0x
:name: VL53L0X Time Of Flight sensor
:relevant-api: sensor_interface
VL53L0X: Time Of Flight sensor Get distance data from a VL53L0X sensor (polling mode).
##############################
Overview Overview
******** ********
This sample periodically measures distance between vl53l0x sensor This sample periodically measures distance between vl53l0x sensor
and target. The result is displayed on the console. and target. The result is displayed on the console.
It also shows how we can use the vl53l0x as a proximity sensor. It also shows how we can use the vl53l0x as a proximity sensor.
Requirements Requirements
************ ************