# Device datapoint reference

Devices provide configurable items, sensor items and/or actuator items.
Configurable items can be given values in the peripheral .ini files.
Sensor and actuator items are operated on through the peripheral interface and
can be either read out (sensors), or written to (actuators).

For configuration items only the device-specific items are shown.



## AD533x (parts ``ad5337``, ``ad5338``, ``ad5339``)

AD5337/AD5338/AD5339 8-/10-/12-bit dual DAC


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> ref_voltage </td>
<td>float</td>
<td>2.048</td>
<td>V</td>
<td>Reference voltage</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> powerdown_a </td>
<td>bool</td>
<td></td>
<td></td>
<td>Powerdown state of DAC channel A</td>
</tr>
<tr>
<td> powerdown_b </td>
<td>bool</td>
<td></td>
<td></td>
<td>Powerdown state of DAC channel B</td>
</tr>
<tr>
<td> voltage_a </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Output voltage channel A</td>
</tr>
<tr>
<td> voltage_b </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Output voltage channel B</td>
</tr>
</table>




### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> powerdown_a </td>
<td>
        bool
        </td>
<td>True</td>
<td></td>
<td>Power down DAC channel A</td>
</tr>
<tr>
<td> powerdown_b </td>
<td>
        bool
        </td>
<td>True</td>
<td></td>
<td>Power down DAC channel B</td>
</tr>
<tr>
<td> voltage_a </td>
<td>float</td>
<td>0.0</td>
<td>V</td>
<td>Set output voltage channel A</td>
</tr>
<tr>
<td> voltage_b </td>
<td>float</td>
<td>0.0</td>
<td>V</td>
<td>Set output voltage channel B</td>
</tr>
</table>





## AD799x (parts ``ad7991``, ``ad7995``, ``ad7999``)

AD7991/AD7995/AD7999 12-/10-/8-bit 4- or 3-chan ADC


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> in3_is_ref </td>
<td>
        bool
        </td>
<td>True</td>
<td></td>
<td>If true, will use IN3 as reference voltage; otherwise VDD</td>
</tr>
<tr>
<td> ref_voltage </td>
<td>float</td>
<td>2.048</td>
<td>V</td>
<td>Reference voltage</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> voltage_0 </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured on Vin0</td>
</tr>
<tr>
<td> voltage_1 </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured on Vin1</td>
</tr>
<tr>
<td> voltage_2 </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured on Vin2</td>
</tr>
<tr>
<td> voltage_3 </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured on Vin3 (if not used as Vref)</td>
</tr>
</table>







## BME280 (part ``bme280``)

Bosch BME280 humidity/pressure/temperature sensor




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> humidity </td>
<td>float</td>
<td></td>
<td>%RH</td>
<td>Humidity</td>
</tr>
<tr>
<td> pressure </td>
<td>float</td>
<td></td>
<td>hPa</td>
<td>Pressure</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
</table>







## Display (part ``display``)

Display module connected to the SPIDR4









## DS125BR800 (part ``ds125br800``)

12.5-Gbps 8-channel repeater with input equalization


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> datafile </td>
<td>string</td>
<td></td>
<td></td>
<td>Data-file to load, in addressable data format; automatically reloaded when overwritten</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> chans_sig_detect </td>
<td>int</td>
<td></td>
<td></td>
<td>Bit per channel, whether or not a channel is detected</td>
</tr>
</table>




### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> chans_powerdown </td>
<td>int
        </td>
<td>255</td>
<td></td>
<td>Bit per channel, when set channel is powered down</td>
</tr>
</table>





## Firefly (part ``firefly``)

Electrical to optical transmitter


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> tx_invert </td>
<td>int
        </td>
<td>0</td>
<td></td>
<td>Bitmask of channels to invert 11..0</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> laser_fault </td>
<td>int</td>
<td></td>
<td></td>
<td>Laser fault status</td>
</tr>
<tr>
<td> temp </td>
<td>int</td>
<td></td>
<td>degC</td>
<td>Internal temperature</td>
</tr>
<tr>
<td> temp_alarm </td>
<td>bool</td>
<td></td>
<td></td>
<td>Temperature alarm</td>
</tr>
<tr>
<td> tx_enabled </td>
<td>int</td>
<td></td>
<td></td>
<td>Transmit channel enabled status (12 bits)</td>
</tr>
<tr>
<td> vcc </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Module voltage</td>
</tr>
<tr>
<td> vcc_alarm </td>
<td>bool</td>
<td></td>
<td></td>
<td>VCC alarm</td>
</tr>
</table>




### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> tx_disable </td>
<td>int
        </td>
<td>4095</td>
<td></td>
<td>Transmit disable bits for 12 channels, also disables laser</td>
</tr>
</table>





## INA2xx (parts ``ina219``, ``ina220``)

INA219/220 current/power monitor


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> gain </td>
<td>int
        </td>
<td>1</td>
<td></td>
<td>PGA gain as x/N, either 1, /2, /4 or /8 (shunt v range = 40, 80, 160 and 320 mV)</td>
</tr>
<tr>
<td> max_a </td>
<td>float</td>
<td>5.0</td>
<td>A</td>
<td>Maximum expected current: too high will cause loss or resolution, too low can cause overflow</td>
</tr>
<tr>
<td> overs </td>
<td>int
        </td>
<td>128</td>
<td></td>
<td>Oversampling</td>
</tr>
<tr>
<td> shunt_r </td>
<td>float</td>
<td>10.0</td>
<td>mOhm</td>
<td>Shunt resistor value in milli-Ohm</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> bus_v </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Bus voltage</td>
</tr>
<tr>
<td> current </td>
<td>float</td>
<td></td>
<td>A</td>
<td>Current</td>
</tr>
<tr>
<td> power </td>
<td>float</td>
<td></td>
<td>W</td>
<td>Power</td>
</tr>
<tr>
<td> shunt_v </td>
<td>float</td>
<td></td>
<td>mV</td>
<td>Voltage over the shunt</td>
</tr>
</table>







## LTC2495 (part ``ltc2495``)

Flexible driver for the LTC2495 16-bit 8-/16-chan Delta-Sigma ADC. It allows detailed configuration of the device, and assignment of custom names to channels









## MCP3x21 (parts ``mcp3021``, ``mcp3221``)

MCP3021/3221 single-channel 10-/12-bit ADC


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> ref_volt </td>
<td>float</td>
<td>3.3</td>
<td>V</td>
<td>Reference voltage (see ref_voltage)</td>
</tr>
<tr>
<td> ref_voltage </td>
<td>float</td>
<td>3.3</td>
<td>V</td>
<td>Reference voltage</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> volt </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured (see voltage)</td>
</tr>
<tr>
<td> voltage </td>
<td>float</td>
<td></td>
<td>V</td>
<td>Voltage measured</td>
</tr>
</table>







## MPL3115A2 (part ``mpl3115a2``)

MPL3115A2 precision altimeter




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> pressure </td>
<td>float</td>
<td></td>
<td>hPa</td>
<td>Pressure</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
</table>







## MS5637 (part ``ms5637``)

MS5637 pressure sensor


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> ovs </td>
<td>int
        </td>
<td>1024</td>
<td></td>
<td>Oversampling (256, 512, 1024, 2048, 4096 or 8192)</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> pressure </td>
<td>float</td>
<td></td>
<td>hPa</td>
<td>Pressure</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
</table>







## PCA9548 (part ``pca9548``)

PCA9548A 8-channel I2C-bus switch with reset


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> reset_pin </td>
<td>int</td>
<td></td>
<td></td>
<td>Reset pin</td>
</tr>
</table>






### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> select </td>
<td>int</td>
<td></td>
<td></td>
<td>Which mux to select (0..7, or -1 to disable all)</td>
</tr>
</table>





## SFPPlus (part ``sfp+``)

Generic SFP+ (SFF-8472 compatible) driver




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> rx_power </td>
<td>float</td>
<td></td>
<td>mW</td>
<td>Received power</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Module temperature</td>
</tr>
<tr>
<td> tx_bias </td>
<td>float</td>
<td></td>
<td>A</td>
<td>Transmission bias</td>
</tr>
<tr>
<td> tx_power </td>
<td>float</td>
<td></td>
<td>mW</td>
<td>Transmitted power</td>
</tr>
</table>




### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> tx_disable </td>
<td>
        bool
        </td>
<td>True</td>
<td></td>
<td>Transmission disable</td>
</tr>
</table>





## SHT3x (part ``sht3x``)

Sensirion humidity and temperature sensor




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> humidity </td>
<td>float</td>
<td></td>
<td>%RH</td>
<td>Humidity</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
</table>







## SI534x (parts ``si5344``, ``si5346``)

SI534x clock generator


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> cfgfile </td>
<td>string</td>
<td>si5344clock.csv</td>
<td></td>
<td>Configuration file, exported by clock-builder (no header)</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> los </td>
<td>int</td>
<td></td>
<td></td>
<td>Loss of signal for channels 0..3, where each bit is a channel number</td>
</tr>
<tr>
<td> losxaxb </td>
<td>bool</td>
<td></td>
<td></td>
<td>There is a problem locking to the XAXB input signal.</td>
</tr>
<tr>
<td> oof </td>
<td>int</td>
<td></td>
<td></td>
<td>Out of frequency for channels 0..3, where each bit is a channel number</td>
</tr>
<tr>
<td> sysincal </td>
<td>bool</td>
<td></td>
<td></td>
<td>The device is calibrating.</td>
</tr>
<tr>
<td> xaxb_err </td>
<td>bool</td>
<td></td>
<td></td>
<td>There is no signal at the XAXB pins.</td>
</tr>
</table>







## SI7021 (part ``si7021``)

Silicon Labs Si7021 temperature/humidity sensor




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> humidity </td>
<td>float</td>
<td></td>
<td>%RH</td>
<td>Humidity</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
</table>







## System (part ``system``)

System device provided board information




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> fan_pwm </td>
<td>int</td>
<td></td>
<td></td>
<td>PWM control code</td>
</tr>
<tr>
<td> fan_speed </td>
<td>int</td>
<td></td>
<td>rpm</td>
<td>Fan rotation speed</td>
</tr>
</table>







## TCA9534 (part ``tca9534``)

TCA9534A 8-bit I/O expander


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> direction_out </td>
<td>int
        </td>
<td>0</td>
<td></td>
<td>I/O direction 8 bits: output=1, input=0</td>
</tr>
<tr>
<td> output </td>
<td>int
        </td>
<td>0</td>
<td></td>
<td>8-bit output port</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> direction_out </td>
<td>int</td>
<td></td>
<td></td>
<td>I/O direction 8 bits: output=1, input=0</td>
</tr>
<tr>
<td> input </td>
<td>int</td>
<td></td>
<td></td>
<td>8-bit input port</td>
</tr>
<tr>
<td> output </td>
<td>int</td>
<td></td>
<td></td>
<td>8-bit output port</td>
</tr>
</table>




### Actuator items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> direction_out </td>
<td>int</td>
<td></td>
<td></td>
<td>I/O direction 8 bits: output=1, input=0</td>
</tr>
<tr>
<td> out_0 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 0</td>
</tr>
<tr>
<td> out_1 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 1</td>
</tr>
<tr>
<td> out_2 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 2</td>
</tr>
<tr>
<td> out_3 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 3</td>
</tr>
<tr>
<td> out_4 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 4</td>
</tr>
<tr>
<td> out_5 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 5</td>
</tr>
<tr>
<td> out_6 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 6</td>
</tr>
<tr>
<td> out_7 </td>
<td>int</td>
<td></td>
<td></td>
<td>Output pin 7</td>
</tr>
<tr>
<td> output </td>
<td>int</td>
<td></td>
<td></td>
<td>8-bit output port</td>
</tr>
</table>





## TMP102 (part ``tmp102``)

TMP102 temperature sensor


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> alert_off </td>
<td>float</td>
<td>75.0</td>
<td>degC</td>
<td>Temperature below which the alert condition turns off (default=75)</td>
</tr>
<tr>
<td> alert_on </td>
<td>float</td>
<td>80.0</td>
<td>degC</td>
<td>Temperature above which the alert condition turns on (default=80)</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> alert </td>
<td>bool</td>
<td></td>
<td></td>
<td>Over-temperature condition detected</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Last converted temperature</td>
</tr>
</table>







## TMP117 (part ``tmp117``)

TMP117 temperature sensor


### Configurable items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> alert_off </td>
<td>float</td>
<td>75.0</td>
<td>degC</td>
<td>Temperature below which the alert condition turns off (default=75)</td>
</tr>
<tr>
<td> alert_on </td>
<td>float</td>
<td>80.0</td>
<td>degC</td>
<td>Temperature above which the alert condition turns on (default=80)</td>
</tr>
</table>




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> alert </td>
<td>bool</td>
<td></td>
<td></td>
<td>Over-temperature condition detected</td>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Last converted temperature</td>
</tr>
</table>







## XADC (part ``xadc``)

Provides various sensor readings from the Xilinx XADC block




### Sensor items
</p>
<table width="100%">
<tr>
    <th width="15%">key</th>
    <th width="10%">type</th>
    <th width="10%">default</th>
    <th width="10%">unit</th>
    <th width="55%">description</th>
</tr>
<tr>
<td> temperature </td>
<td>float</td>
<td></td>
<td>degC</td>
<td>Temperature</td>
</tr>
<tr>
<td> vcc_bram </td>
<td>float</td>
<td></td>
<td>mV</td>
<td>BRAM Vcc</td>
</tr>
<tr>
<td> vcc_int </td>
<td>float</td>
<td></td>
<td>mV</td>
<td>INT Vcc</td>
</tr>
</table>