nymea-plugins/i2cdevices

I²C devices

This integration plugin adds support for some I²C devices.

Currently supported devices are:

• ADS1113/ADS1114/ADS1115
• Pi-16ADC

ADS1113/ADS1114/ADS1115

The ADS1113/1114/1115 is a 4 channel, I²C-compatible, 16-Bit ADC by Texas Instruments and supports measuring input voltages from 0 to 6.144V.

Usage

In order to use this device within nymea, it needs to be connected to the I²C bus. At least SDA, SCL, GND and VDD must be connected. VDD can be any desired voltage from 2V to 5.5V. Input channels are to be connected at the according pins and will perform an analog to digital conversion of their input voltage.

IMPORTANT: The input voltage on the connected AINX channels must never exceed VDD + 0.3V.

The measured input value will be a floating point value from 0 to 1, depending on the selected input gain. For instance, if the selected input gain is 4.096V, a voltage of 0V will be indicated in nymea as 0 while an input voltage of 4.096V will be represented as 1.

Setup can be done by performing a discovery for it in nymea. Please verify that the found results are matching with the address configuration of the device. If the address pin is not connected at all, the I²C address will be 72 (0x48). It can be configured to another I²C address by connecting the address pin as follows:

Pin	Address (Hex)
GND	72 (0x48)
VDD	73 (0x49)
SDA	74 (0x4a)
SCL	75 (0x4b)

---

By assigning different addresses, up to 4 such devices can be used on a single I²C bus.

Note: At this point, this plugin does not support the devices dual channel mode.

Pi-16ADC

The Pi-16ADC is a 16 channel analog/digital converter Raspberry Pi HAT by Alchemy Power and supports measuring input voltage from 0 to 2.5V.

Usage

In order to use this device within nymea, it needs to be plugged onto the Rasperry. The analog input channels can be connected to to the respective channels. Unused channels should be connected to GND in order to prevent them from oscillating.

The measured input value will be a floating point voltage value from 0V to 2.5V.

Setup can be done by performing a discovery for it in nymea. Please verify that the found results are matching with the address configuration of the device. The default address is 118 (0x76).The jumpers on the board can be used to configure the I²C address of the board by setting the jumpers to low (connect AX to GND), high (connect AX to +) or floating (remove jumper). The following table shows the possible address configurations:

A2	A1	A0	Address (Hex)
Low	Low	Low	20 (0x14)
Low	Low	High	22 (0x16)
Low	Low	Float	21 (0x15)
Low	High	Low	38 (0x26)
Low	High	High	52 (0x34)
Low	High	Float	39 (0x27)
Low	Float	Low	23 (0x17)
Low	Float	High	37 (0x25)
Low	Float	Float	36 (0x24)
High	Low	Low	86 (0x56)
High	Low	High	100 (0x64)
High	Low	Float	87 (0x57)
High	High	Low	116 (0x74)
High	High	High	118 (0x76)
High	High	Float	117 (0x75)
High	Float	Low	101 (0x65)
High	Float	High	103 (0x67)
High	Float	Float	102 (0x66)
Float	Low	Low	53 (0x35)
Float	Low	High	55 (0x37)
Float	Low	Float	54 (0x36)
Float	High	Low	71 (0x47)
Float	High	High	85 (0x55)
Float	High	Float	54 (0x54)
Float	Float	Low	68 (0x44)
Float	Float	High	70 (0x46)
Float	Float	Float	69 (0x45)

---

By assigning different addresses, multiple such boards can be stacked on top of each other if more than 16 channels are required.

Note: At this point, this plugin does not support the devices dual channel mode.

Additional information ca be found at the devices users guide at https://www.alchemy-power.com/wp-content/uploads/2017/03/Pi-16ADC-User-Guide.pdf.

INA219

The INA219 is a voltage/current meter by Texas Instruments.

Usage

In order to use this device within nymea, it needs to be connected to the I²C bus. At least SDA, SCL, GND and VDD must be connected. Normally the device comes with a 0.1 Ohm shunt resistor. If replacing the shunt resistor on the device with something else, the according value needs to be given during the setup in nymea.

The measured input value will be a floating point value from 0 to 1, depending on the selected input gain. For instance, if the selected input gain is 4.096V, a voltage of 0V will be indicated in nymea as 0 while an input voltage of 4.096V will be represented as 1.

Setup can be done by performing a discovery for it in nymea. Please verify that the found results are matching with the address configuration of the device. If the address selector pins are unmodified, the I²C address will be 64 (0x48). It can be configured to another I²C address by bridging the addrss selector pins on the device. The INA219 has selectable addresses from 0x40 tox 0x4A.

The device will represent itself as energy meter in nymea and if used, for example in a caravan, it ca cater as the root meter for the caravans energy system.