Merge branch 'main' into develop

theyosh · theyosh · commit 7d66e84b9cca · 2026-01-31T16:49:24.000+01:00
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -116,12 +116,13 @@ GEM
     json (2.18.0)
     json-minify (0.0.3)
       json (> 0)
-    kramdown (2.5.1)
-      rexml (>= 3.3.9)
+    kramdown (2.5.2)
+      rexml (>= 3.4.4)
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
     liquid (4.0.4)
-    listen (3.9.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
@@ -133,7 +134,7 @@ GEM
     parallel (1.27.0)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    prism (1.8.0)
+    prism (1.9.0)
     public_suffix (7.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
@@ -145,7 +146,7 @@ GEM
     rexml (3.4.4)
     rouge (4.7.0)
     safe_yaml (1.0.5)
-    sass-embedded (1.97.2-x86_64-linux-gnu)
+    sass-embedded (1.97.3-x86_64-linux-gnu)
       google-protobuf (~> 4.31)
     securerandom (0.4.1)
     terminal-table (3.0.2)
diff --git a/docs/_hardware/16-channel_relay.md b/docs/_hardware/16-channel_relay.md
@@ -0,0 +1,67 @@
+---
+title: 16 Channel I2C Electromagnetic Relay Module IoT
+categories: [Hardware, Relay]
+tags: [relay, i2c, 16channel]
+
+image:
+  path: /assets/img/16 Channel I2C Electromagnetic Relay Module PCF8575.webp
+  src: /assets/img/16 Channel I2C Electromagnetic Relay Module PCF8575.webp
+  alt: '16 Channel I2C Electromagnetic Relay Module PCF8575 header image'
+
+device_hardware: GPIO
+device_address:
+  'Enter the IO Expender type, the relay number (starting at 1), and then the
+  I2C address with optional I2C bus number: `pcf8575-1,0x4c,3`'
+---
+
+## Information
+
+The IOT Electronic 16 Channel I2C Solid State Relay Module provides 16 isolated
+channels for Arduino and Raspberry projects, supporting 100-240V AC control.
+
+This IOT Electronic 16 Channel I2C Solid State Relay Module offers robust
+control for your microcontroller projects. Designed for compatibility with
+Arduino, Raspberry, and other microcontrollers, it provides 16 isolated solid
+state relay channels.
+
+### Key Features
+
+- Control 16 independent channels using an I2C interface.
+- Built around the efficient **PCF8575** I2C expander chip.
+- Designed for compatibility with Arduino, Raspberry, and various
+  microcontrollers.
+
+### Device Specifications
+
+- PCB Board Dimension: 210mm x 72mm
+- Compatibility: DRG-01 DIN rail plastic holder
+- Isolation: Full opto and air isolation from high voltage
+- Operation DC Voltage: 3.3V and 5.0V
+- Maximum Current @5.0V: 450mA
+- AC Controlling Voltage Range: 100…240VAC
+- AC Voltage Frequency Range: 50…60Hz
+- Minimum AC Current per Channel: 30mA
+- Maximum AC Current per Channel: 2A
+- I2C Device Slave Address: Changeable
+- Expandability: Connect up to 8 devices to one I2C bus, controlling up to 128
+  channels
+- Indicators: Red LED indicators for each SSR relay channel
+
+This versatile relay module simplifies projects requiring multiple high-voltage
+switching capabilities. Its I2C interface allows for easy integration and
+expansion, enabling control of up to 128 channels with multiple modules. The
+opto and air isolation ensure safety and reliability when dealing with AC loads
+up to 240V, making the IOT Electronic 16 Channel I2C Solid State Relay Module an
+excellent choice for demanding applications.
+
+### Ideal for
+
+- Makers and hobbyists working with Arduino and Raspberry Pi.
+- Automation projects requiring multi-channel AC switching.
+- Industrial control applications needing isolated relay outputs.
+- Projects where space-saving and expandability are crucial.
+- Electronics enthusiasts building custom control systems.
+
+[16 Channel I2C Electromagnetic Relay Module PCF8575](https://www.tindie.com/products/bugrovs2012/16-channel-i2c-electromagnetic-relay-module-iot/#product-description)
+
+{% include_relative _relay_detail.md %}
diff --git a/docs/_hardware/ahtx0_sensor.md b/docs/_hardware/ahtx0_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x38`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x38`'
 device_power_management: false
 ---
 
diff --git a/docs/_hardware/am2320_sensor.md b/docs/_hardware/am2320_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x5c`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x5c`'
 device_url: https://www.pibits.net/code/am2320-temperature-and-humidity-sensor-and-raspberry-pi-example.php
 ---
 
diff --git a/docs/_hardware/amg8833_sensor.md b/docs/_hardware/amg8833_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `1,0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `1,0x3f`'
 device_url: https://makersportal.com/shop/amg8833-thermal-camera-infrared-array
 ---
 
diff --git a/docs/_hardware/atlasscientific_sensor.md b/docs/_hardware/atlasscientific_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity, conductivity, ph, co2, pressure]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://atlas-scientific.com/
 ---
 
diff --git a/docs/_hardware/bh1750_sensor.md b/docs/_hardware/bh1750_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [light]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://components101.com/sensors/bh1750-ambient-light-sensor
 ---
 
diff --git a/docs/_hardware/bme280_sensor.md b/docs/_hardware/bme280_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity, pressure, altitude]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://www.adafruit.com/product/2652
 ---
 
diff --git a/docs/_hardware/bme680_sensor.md b/docs/_hardware/bme680_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity, pressure, altitude]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f,3`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f,3`'
 device_url: https://shop.pimoroni.com/products/bme680-breakout?variant=12491552129107
 ---
 
diff --git a/docs/_hardware/chirp_sensor.md b/docs/_hardware/chirp_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, moisture]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://www.tindie.com/products/miceuz/i2c-soil-moisture-sensor/
 ---
 
diff --git a/docs/_hardware/cozirco2_sensor.md b/docs/_hardware/cozirco2_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [co2, temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://www.gassensing.co.uk/products
 ---
 
diff --git a/docs/_hardware/css811_sensor.md b/docs/_hardware/css811_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [co2]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://www.probots.co.in/carbon-dioxide-gas-detection-sensor-module-ccs811.html
 ---
 
diff --git a/docs/_hardware/hd30a-4-channel_relay.md b/docs/_hardware/hd30a-4-channel_relay.md
@@ -1,7 +1,7 @@
 ---
-title: HD30A 4 Channel Electromagnetic I2C Relay 12V 30A
+title: HD30A 4/8 Channel Electromagnetic I2C Relay 12V 30A
 categories: [Hardware, Relay]
-tags: [relay, HD30A]
+tags: [relay, HD30A, 4channel, 8channel]
 
 image:
   path: /assets/img/HD30A_4_Channel_Electromagnetic_I2C_Relay_12V_30A.webp
@@ -43,4 +43,7 @@ are used quality screw terminals KF-128-3P. Each relay is indicated with led
 
 [HD30A 4CH/8CH Channel Electromagnetic relay](https://www.tindie.com/products/bugrovs2012/hd30a-4-channel-electromagnetic-i2c-relay-12v-30a/)
 
+Other relay boards with a **PCF8574** chip should work.
+[8 Channel I2C Electromagnetic Relay Module](https://www.tindie.com/products/bugrovs2012/8-channel-i2c-electromagnetic-relay-module/)
+
 {% include_relative _relay_detail.md %}
diff --git a/docs/_hardware/hih8000_sensor.md b/docs/_hardware/hih8000_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://www.sensorwell.at/en/products/sensors/environmental-sensors/humidity-sensors/honeywell-humidicon-hih8000-series/
 ---
 
diff --git a/docs/_hardware/htu21d_sensor.md b/docs/_hardware/htu21d_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://learn.adafruit.com/adafruit-htu21d-f-temperature-humidity-sensor/overview
 ---
 
diff --git a/docs/_hardware/i2c-4ch_dimmer.md b/docs/_hardware/i2c-4ch_dimmer.md
@@ -10,7 +10,7 @@ image:
 
 device_address:
   '&lt;relay_number&gt;,&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `1,0x70`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `1,0x70`'
 device_url: https://www.tindie.com/products/bugrovs2012/i2c-4ch-ac-led-dimmer-module/
 ---
 
diff --git a/docs/_hardware/i2c-multiplexer.md b/docs/_hardware/i2c-multiplexer.md
@@ -23,8 +23,8 @@ line: `dtparam=i2c_arm=on`:
 if using that address).
 
 After rebooting, you should have up to 8 new I2C devices at the location:
-`/dev/i2c-*`.
-[You can then use the I2C address as normal but you need to add the I2C bus](/TerrariumPI/hardware/#i2c-bus).
+`/dev/i2c-*`. [You can then use the I2C address as normal but you need to add
+the I2C bus]({% link _tabs/hardware.md %}#i2c-bus).
 
 This should work for **pca9542** (2 channel), **pca9545** (4 channel), and
 **pca9548** (8 channel) devices.
diff --git a/docs/_hardware/io-expander.md b/docs/_hardware/io-expander.md
@@ -1,7 +1,7 @@
 ---
 title: IO Expander
 categories: [Hardware, Button, I2C]
-tags: [button, expander, pcf8574]
+tags: [button, expander, pcf8574, pcf8575]
 permalink: /hardware/io-expander/
 
 image:
@@ -10,19 +10,27 @@ image:
   alt: 'PCF8574 IO Expander'
 ---
 
-With the IO expander pcf8574 you can add more GPIO
-[relays](/TerrariumPI/hardware/#relays) and
-[buttons](/TerrariumPI/hardware/#buttons) to TerrariumPI. This IO expander does
-only support on/off actions. So it is not possible to use this IO expander with
-a DHT sensor. You cannot read out the extra GPIO ports.
+With the IO expander pcf8574/5 you can add more GPIO
+[relays]({% link _tabs/hardware.md %}#relays) and
+[buttons]({% link _tabs/hardware.md %}#buttons) to TerrariumPI. This IO expander
+does only support on/off actions. So it is not possible to use this IO expander
+with a DHT sensor. You cannot read out the extra GPIO ports.
+
+## PCF8575 Bug
+
+At the moment it is **not** possible to use a pcf8575 IO expander to add more
+buttons. Due to a
+[bug in the used library](https://github.com/rp3tya/PCF8575/issues/5), we can
+only support [relays]({% link _tabs/hardware.md %}#relays) with this IO
+expander.
 
 ## Addressing
 
 In order to use this IO expander, enter the following address in the GPIO relay
 or button address field.\
-`pcf8574-<IO expander port>,<I2C Address>,[I2C Bus number]`
+`pcf857[4/5]-<IO expander port>,<I2C Address>,[I2C Bus number]`
 
-`<IO expander port>` is mandatory and is a number from 1 till max ports.
+`<IO expander port>` is mandatory and is a number from **1** till max ports.
 
 `<I2C Address>` is mandatory and specified
-[here](/TerrariumPI/hardware/#i2c-bus).
+[here]({% link _tabs/hardware.md %}#i2c-bus).
diff --git a/docs/_hardware/led-warrior18_dimmer.md b/docs/_hardware/led-warrior18_dimmer.md
@@ -10,7 +10,7 @@ image:
 
 device_address:
   '&lt;relay_number&gt;,&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `1,0x70`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `1,0x70`'
 dimmer_frequency: 65535
 device_url: https://shop.codemercs.com/en/led-warrior18-module.html
 ---
diff --git a/docs/_hardware/mlx90614_sensor.md b/docs/_hardware/mlx90614_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional, followed by either `,o` for
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional, followed by either `,o` for
   object or `,a` for ambient temperature<br />Ex: `0x3f,1,o`'
 device_url: https://www.sparkfun.com/products/9570
 ---
diff --git a/docs/_hardware/pca9685_dimmer.md b/docs/_hardware/pca9685_dimmer.md
@@ -9,8 +9,8 @@ image:
   alt: 'PCA9685 header image'
 
 device_address:
-  '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `1,0x40`'
+  '&lt;Relay nr&gt;,&lt;I2C Address&gt;,[I2C Bus] where the [I2C
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `1,0x40`'
 dimmer_frequency: 5000
 device_url: https://custom-build-robots.com/electronic/raspberry-pi-led-dimmer-pca9685-servo-controller/8840?lang=en
 ---
diff --git a/docs/_hardware/qwiic-relay.md b/docs/_hardware/qwiic-relay.md
@@ -10,7 +10,7 @@ image:
 
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `1,0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `1,0x3f`'
 device_url: https://www.sparkfun.com/search/results?term=Qwiic+relay
 ---
 
diff --git a/docs/_hardware/sht2x_sensor.md b/docs/_hardware/sht2x_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x3f`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x3f`'
 device_url: https://arduinolearning.com/amp/code/sht21-humidity-and-temperature-sensor-example.php
 ---
 
diff --git a/docs/_hardware/sht3x_sensor.md b/docs/_hardware/sht3x_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x44`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x44`'
 device_url: https://www.pibits.net/code/raspberry-pi-sht31-sensor-example.php
 ---
 
diff --git a/docs/_hardware/sht3xd_sensor.md b/docs/_hardware/sht3xd_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x44`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x44`'
 ---
 
 ## Information
diff --git a/docs/_hardware/sht4x_sensor.md b/docs/_hardware/sht4x_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x44`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x44`'
 device_url: https://www.pibits.net/code/raspberry-pi-sht31-sensor-example.php
 ---
 
diff --git a/docs/_hardware/si7021_sensor.md b/docs/_hardware/si7021_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [temperature, humidity]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x40`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x40`'
 device_url: https://www.pibits.net/code/raspberry-pi-si7021-sensor-example.php
 ---
 
diff --git a/docs/_hardware/veml6075_sensor.md b/docs/_hardware/veml6075_sensor.md
@@ -11,7 +11,7 @@ image:
 device_types: [uva, uvb, uvi]
 device_address:
   '&lt;I2C Address&gt;,[I2C Bus] where the [I2C
-  bus](/TerrariumPI/hardware#i2c-bus) is optional<br />Ex: `0x44`'
+  bus](/TerrariumPI/hardware/#i2c-bus) is optional<br />Ex: `0x44`'
 device_url: https://pimylifeup.com/raspberry-pi-uv-sensor-veml6075/
 ---
 
diff --git a/docs/_tabs/hardware.md b/docs/_tabs/hardware.md
diff --git a/docs/assets/img/16 Channel I2C Electromagnetic Relay Module PCF8575.webp b/docs/assets/img/16 Channel I2C Electromagnetic Relay Module PCF8575.webp
diff --git a/hardware/button/__init__.py b/hardware/button/__init__.py
diff --git a/hardware/io_expander.py b/hardware/io_expander.py
diff --git a/hardware/relay/gpio_relay.py b/hardware/relay/gpio_relay.py
diff --git a/package-lock.json b/package-lock.json
diff --git a/requirements.txt b/requirements.txt
