Move sensor configuration

arendst 2017-02-08 10:05:12 +01:00
parent e5f6f3661d
commit 4cf3c8c9b2
3 changed files with 56 additions and 56 deletions

@ -7,59 +7,3 @@ You've successfully uploaded the Sonoff-Tasmota firmware to your module.
5. Configure the MQTT broker connection, choose a unique topic, e.g. "sonoff-kitchenlight"
6. Test communication with the MQTT client of your choice
7. Integrate with the Control interface or home automation solution of your choice
## Add a single wire sensor
The software supports the following single wire sensors:
- DHT11 Temperature and Humidity
- DHT21 Temperature and Humidity
- DHT22 Temperature and Humidity
- AM2301 Temperature and Humidity
- AM2302 Temperature and Humidity
- AM2321 Temperature and Humidity
- DS18B20 Temperature (multiple sensors with optional OneWire library enabled in ``user_config.h``)
- DS18S20 Temperature (with optional OneWire library enabled in ``user_config.h``)
- External switch
- HC-SR501 PIR Motion Detection (configured as Switch)
You can dynamically add a sensor using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 4`` - select desired module functionality for a Sonoff TH (Wait for the restart)
3. ``gpios`` - show supported sensor types. (DHT21 = AM2301, AM2302 = AM2321 = DHT22)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 2`` - select sensor AM2301 (Wait for the restart)
For some sensors to show up a power cycle of Sonoff is needed to reset the devices just configured.
## Add an I2C sensor
The software supports the following I2C sensors:
- BH1750 Ambient Light Intensity
- BMP180 Pressure and Temperature
- BMP280 Pressure and Temperature
- BME280 Pressure, Temperature and Humidity
- HTU21 Temperature and Humidity
You can dynamically add I2C sensors using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 1`` - select desired module functionality for a Sonoff Basic (Wait for the restart)
3. ``gpios`` - show supported sensor types. We need two pins: I2C SCL (5) and I2C SDA (6)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 5`` - select I2C SCL (Wait for the restart)
6. ``gpio4 6`` - select I2C SDA (Wait for the restart)
The software will autodetect the connected I2C devices. For some sensors to show up a power cycle of Sonoff is needed to reset the devices just configured.
## Add a device
The software supports the following additional device(s):
- WS2812 led string using NeoPixelBus library and external 5V power supply
You can dynamically add a device using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 1`` - select desired module functionality for a Sonoff Basic (Wait for the restart)
3. ``gpios`` - show supported sensor types. We need WS2812 (7)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 7`` - select WS2812 led string (Wait for the restart)
For some devices a power cycle of Sonoff is needed to reset the interface to the devices just configured.

55
Sensor-Configuration.md Normal file

@ -0,0 +1,55 @@
## Add a single wire sensor
The software supports the following single wire sensors:
- DHT11 Temperature and Humidity
- DHT21 Temperature and Humidity
- DHT22 Temperature and Humidity
- AM2301 Temperature and Humidity
- AM2302 Temperature and Humidity
- AM2321 Temperature and Humidity
- DS18B20 Temperature (multiple sensors with optional OneWire library enabled in ``user_config.h``)
- DS18S20 Temperature (with optional OneWire library enabled in ``user_config.h``)
- External switch
- HC-SR501 PIR Motion Detection (configured as Switch)
You can dynamically add a sensor using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 4`` - select desired module functionality for a Sonoff TH (Wait for the restart)
3. ``gpios`` - show supported sensor types. (DHT21 = AM2301, AM2302 = AM2321 = DHT22)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 2`` - select sensor AM2301 (Wait for the restart)
For some sensors to show up a power cycle of Sonoff is needed to reset the devices just configured.
## Add an I2C sensor
The software supports the following I2C sensors:
- BH1750 Ambient Light Intensity
- BMP180 Pressure and Temperature
- BMP280 Pressure and Temperature
- BME280 Pressure, Temperature and Humidity
- HTU21 Temperature and Humidity
You can dynamically add I2C sensors using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 1`` - select desired module functionality for a Sonoff Basic (Wait for the restart)
3. ``gpios`` - show supported sensor types. We need two pins: I2C SCL (5) and I2C SDA (6)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 5`` - select I2C SCL (Wait for the restart)
6. ``gpio4 6`` - select I2C SDA (Wait for the restart)
The software will autodetect the connected I2C devices. For some sensors to show up a power cycle of Sonoff is needed to reset the devices just configured.
## Add a device
The software supports the following additional device(s):
- WS2812 led string using NeoPixelBus library and external 5V power supply
You can dynamically add a device using the following (MQTT) commands:
1. ``modules`` - show supported modules
2. ``module 1`` - select desired module functionality for a Sonoff Basic (Wait for the restart)
3. ``gpios`` - show supported sensor types. We need WS2812 (7)
4. ``gpio`` - show current defined sensors on supported GPIO pins
5. ``gpio14 7`` - select WS2812 led string (Wait for the restart)
For some devices a power cycle of Sonoff is needed to reset the interface to the devices just configured.

@ -10,6 +10,7 @@
- [**Button**](Button-usage)
- [**MQTT Features**](MQTT-Features)
- [**Commands**](Commands)
- [**Sensor Configuration**](Sensor-Configuration)
**Home Automation Integration**
- [**openHAB**](openHAB)