mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

small changes

blakadder 2019-11-01 21:23:40 +01:00
parent e98061eed7
commit ff44a3cae8
6 changed files with 59 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
A4988-Stepper-Motor-Controller.md

@ -1,7 +1,11 @@
Use an stepper motor controller to easily control stepper-motors like "NEMA 17" and siblings. **This feature is not included in precompiled binaries.** To use it you must [compile your build](compile-your-build). Add the following to `user_config_override.h`:
```
## Enable Stepper Motor Support #ifndef USE_A4988_STEPPER
To enable this feature, add `#define USE_A4988_STEPPER` to your `user_config_override.h` file and compile your own firmware. #define USE_A4988_STEPPER // A4988/DRV8825 stepper motor (+10k5 code)
#endif
```
----
This drives is used to control stepper-motors such as [NEMA 17](https://reprap.org/wiki/NEMA_17_Stepper_motor).
## Connecting the motor controller ## Connecting the motor controller
The driverboard has several connectors: powering the controller (3.3-5.0 V), input (+/-) & output (1a/1b/2a/2b), the motor (up to 35V/2A), and to control the circuit (in order at the control side of the board): The driverboard has several connectors: powering the controller (3.3-5.0 V), input (+/-) & output (1a/1b/2a/2b), the motor (up to 35V/2A), and to control the circuit (in order at the control side of the board):
@ -17,14 +21,16 @@ EN|Enable the power supply for the motor
SLP|Sleep (bridge to RST) SLP|Sleep (bridge to RST)
RST|Reset (bridge to SLP) RST|Reset (bridge to SLP)
There are six corresponding GPIO [components](Components) for this Tasmota driver. These should be configured to free GPIO pins of the device using a [Template](Templates) or [Module](Modules): ### Tasmota configuration
`A4988 DIR (170)` There are six GPIO [components](Components) that should be configured to free GPIOs:
`A4988 STP (171)` ```
`A4988 ENA (172)` A4988 DIR (170)
`A4988 MS1 (173)` A4988 STP (171)
`A4988 MS2 (174)` A4988 ENA (172)
`A4988 MS3 (175)` A4988 MS1 (173)
A4988 MS2 (174)
A4988 MS3 (175)
```
The minimal configuration are the `DIR` and `STEP` signals. In such a configuration the motor will be permanently powered and microstepping will be set to 1/1 (full steps). The minimal configuration are the `DIR` and `STEP` signals. In such a configuration the motor will be permanently powered and microstepping will be set to 1/1 (full steps).
### A4988 Controller ### A4988 Controller
@ -44,8 +50,8 @@ Refer to the [Stepper Motor Commands](Commands#Stepper-Motors)
`MotorRPM` is an imprecise setting due to the implementation method. Also, if the value is too high for the combination of chosen micro stepping increment (`MotorMIS`) and the number of steps the given motor needs for one revolution (`MotorSPR`), the motor will not turn but make a whining noise. You will have to experiment some to find the optimal combination for your use case. `MotorRPM` is an imprecise setting due to the implementation method. Also, if the value is too high for the combination of chosen micro stepping increment (`MotorMIS`) and the number of steps the given motor needs for one revolution (`MotorSPR`), the motor will not turn but make a whining noise. You will have to experiment some to find the optimal combination for your use case.
## Use cases ## Example project
The cheap auto-feeder for my cats broke. It was a fancy plastic-thingy with voice-recording-function & programmable to feed several times a day after playing back your voice (cats don't give a sh$7 for your voice - they come when they hear the food falling into the bowl). It was never precise - a concern for the amount of nutrition it gave the cats. And it was not reliable, as the torque of the internal moving mechanism was insufficient to spin the separator/proportioning wheel through the food reliably. In addition, the batteries were always drained in a day meaning very grumpy cats when we returned! The cheap auto-feeder for my cats broke. It was a fancy plastic-thingy with voice-recording-function & programmable to feed several times a day after playing back your voice (cats don't give a sh$7 about your voice - they come when they hear the food falling into the bowl). It was never precise - a concern for the amount of nutrition it gave the cats. And it was not reliable, as the torque of the internal moving mechanism was insufficient to spin the separator/proportioning wheel through the food reliably. In addition, the batteries were always drained in a day meaning very grumpy cats when we returned!
Thus the wish to install a high-torque stepper-motor (with shifting gear) was born. I could power it with mains instead of relying on a battery, control it over WiFi from my home automation hub. Tasmota now offers a way to do this! Thus the wish to install a high-torque stepper-motor (with shifting gear) was born. I could power it with mains instead of relying on a battery, control it over WiFi from my home automation hub. Tasmota now offers a way to do this!
@ -53,12 +59,11 @@ The **"TasmotaSmartCatFeeder"** circuit consists of a WeMos D1 mini, a A4988 con
Virtually everything which has to be moved or rotated can be done now using these cheap components. It can be a window, door, shutter, cat or dog flap, a solar panel which follows the sun, a moving spotlight, PTZ-camera, or whatever. Virtually everything which has to be moved or rotated can be done now using these cheap components. It can be a window, door, shutter, cat or dog flap, a solar panel which follows the sun, a moving spotlight, PTZ-camera, or whatever.
### Wiring Diagrams
## Wiring Diagrams
![Nema-17_v1](https://user-images.githubusercontent.com/34340210/66860250-d6b82c00-ef5a-11e9-8897-1a4e9d7fdf21.jpg) ![Nema-17_v1](https://user-images.githubusercontent.com/34340210/66860250-d6b82c00-ef5a-11e9-8897-1a4e9d7fdf21.jpg)
![28BYJ-48_V1](https://user-images.githubusercontent.com/34340210/66860253-d91a8600-ef5a-11e9-9195-c816e329abb8.jpg) ![28BYJ-48_V1](https://user-images.githubusercontent.com/34340210/66860253-d91a8600-ef5a-11e9-9195-c816e329abb8.jpg)
### A4988/DRV8825 Stepper Motor Control Development Boards ### A4988/DRV8825 Stepper Motor Control Development Boards
[Banggood](https://www.banggood.com/A4988DRV8825-Stepper-Motor-Control-Board-Expansion-Board-For-3D-Printer-p-1238774.html) [Banggood](https://www.banggood.com/A4988DRV8825-Stepper-Motor-Control-Board-Expansion-Board-For-3D-Printer-p-1238774.html)
[AliExpress #1](https://www.aliexpress.com/item/32908836265.html) [AliExpress #1](https://www.aliexpress.com/item/32908836265.html)

26
Codes-for-IR-Remotes-(for-YTF-IR-Bridge).md

@ -1,6 +1,6 @@
On this page IR Codes for different IR Remote are collected. On this page IR Codes for different IR Remote are collected.
The IR Codes can be used with [YTF IR Bridge](https://github.com/arendst/Sonoff-Tasmota/wiki/YTF-IR-Bridge) (or maybe with other devices, that have a IR sender connected) The IR Codes can be used with [YTF IR Bridge](YTF-IR-Bridge) (or maybe with other devices, that have a IR sender connected)
The codes will also fit other devices from same manufacturer or series. The codes will also fit other devices from same manufacturer or series.
Please try out... Please try out...
@ -8,32 +8,32 @@ Please try out...
Feel free to contribute this list Feel free to contribute this list
### TV's ### TV's
[IR Remote Codes Panasonic TX65FXW782](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-for-TV-Panasonic-TX65FXW784) [IR Remote Codes Panasonic TX65FXW782](IR-Codes-for-TV-Panasonic-TX65FXW784)
[IR Remote Codes Sony KDL-EX540, Common buttons should work across multiple models](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-for-TV-Sony-KDL-EX540) [IR Remote Codes Sony KDL-EX540, Common buttons should work across multiple models](IR-Codes-for-TV-Sony-KDL-EX540)
[IR Remote Codes LG 55UH8509](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-for-TV-LG-55UH8509) [IR Remote Codes LG 55UH8509](IR-Codes-for-TV-LG-55UH8509)
### Set-top Boxes ### Set-top Boxes
[IR Remote Codes VU+ Duo 2](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Remote-Codes-VU--Duo-2) [IR Remote Codes VU+ Duo 2](IR-Remote-Codes-VU--Duo-2)
[IR Remote Codes AppleTV Gen4](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Remote-Codes-AppleTV-Gen4) [IR Remote Codes AppleTV Gen4](IR-Remote-Codes-AppleTV-Gen4)
[IR Remote Codes Humax HMS-1000T DVB-T2 DVR PAL 4-Tune](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Remote-Codes-Humax-HMS-1000T) [IR Remote Codes Humax HMS-1000T DVB-T2 DVR PAL 4-Tune](IR-Remote-Codes-Humax-HMS-1000T)
[IR Remote Codes FetchTV Mini(Hybroad H626T)SHold work with any FetchTV box (Aus)](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Remote-Codes-Fetch-Mini) [IR Remote Codes FetchTV Mini(Hybroad H626T)SHold work with any FetchTV box (Aus)](IR-Remote-Codes-Fetch-Mini)
### BD/DVD players ### BD/DVD players
[IR Remote Codes Sony BD-S1500, Common buttons should work across multiple models](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Remote-Codes-Sony-BD-S1500) [IR Remote Codes Sony BD-S1500, Common buttons should work across multiple models](IR-Remote-Codes-Sony-BD-S1500)
### Projectors ### Projectors
[IR Remote Codes Acer K132](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-for-Acer-K132) [IR Remote Codes Acer K132](IR-Codes-for-Acer-K132)
### Soundbars ### Soundbars
[IR Remote Codes Panasonic SCALL70T](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-for-Soundbar-Panasonic-SCALL70T) [IR Remote Codes Panasonic SCALL70T](IR-Codes-for-Soundbar-Panasonic-SCALL70T)
### Vacuum Cleaners ### Vacuum Cleaners
[IR Remote Codes Ecovacs Deebot Slim 2](https://github.com/arendst/Sonoff-Tasmota/wiki/IR-Codes-Vaccuum-Cleaner-Ecovacs-Deebot-Slim2) [IR Remote Codes Ecovacs Deebot Slim 2](IR-Codes-Vaccuum-Cleaner-Ecovacs-Deebot-Slim2)
### Ventilation ### Ventilation
[IR Remote codes for Prana 150](https://github.com/arendst/Sonoff-Tasmota/wiki/Prana-150-energy-recovery-ventilation) [IR Remote codes for Prana 150](Prana-150-energy-recovery-ventilation)

3
Connecting-Peripheral-Devices.md

@ -1,3 +0,0 @@
- [**Sensors and Controllers**](Peripherals)
- [**Displays**](Displays)

17
Moisture-Sensor-and-Chirp!-Sensor.md

@ -1,4 +1,12 @@
The [I<sup>2</sup>C moisture sensor](https://github.com/Miceuz/i2c-moisture-sensor) is the sensor-only version of the original Chirp! sensor. **This feature is not included in precompiled binaries.** To use it you must [compile your build](compile-your-build). Add the following to `user_config_override.h`:
```
#ifndef USE_CHIRP
#define USE_CHIRP
#endif
```
----
[Chirp! I<sup>2</sup>C moisture sensor](https://github.com/Miceuz/i2c-moisture-sensor) is the sensor-only version of the original Chirp! sensor.
The "sensor mode only" (without the chirp function) is the preferred sensor variant for Tasmota. It provides additional temperature readings. Chirp! is a plant watering alarm which uses capacitive sensing to measure moisture. It provides ambient light readings and works in Tasmota, but is not the recommended version. The "sensor mode only" (without the chirp function) is the preferred sensor variant for Tasmota. It provides additional temperature readings. Chirp! is a plant watering alarm which uses capacitive sensing to measure moisture. It provides ambient light readings and works in Tasmota, but is not the recommended version.
@ -10,13 +18,6 @@ Additional References:
Use a standard I<sup>2</sup>C connection plus 3.3V and GND. Use a standard I<sup>2</sup>C connection plus 3.3V and GND.
### Device Configuration ### Device Configuration
The driver is disabled by default. To use the driver for the sensor add these lines to your `user_config_override.h` and compile a firmware binary.
```
#ifndef USE_CHIRP
#define USE_CHIRP
#endif
```
In the Configuration -> Configure Other page, enter and activate the following template: In the Configuration -> Configure Other page, enter and activate the following template:
`{"NAME":"HW-655 PZEM","GPIO":[0,0,0,0,6,5,0,0,0,0,0,0,0],"FLAG":0,"BASE":18}` `{"NAME":"HW-655 PZEM","GPIO":[0,0,0,0,6,5,0,0,0,0,0,0,0],"FLAG":0,"BASE":18}`

8
Peripherals.md

@ -6,7 +6,7 @@ More about [general configuration](https://github.com/arendst/Tasmota/wiki/Senso
*Some of the articles were written originally for D1 mini but the information still applies except the wiring instructions* *Some of the articles were written originally for D1 mini but the information still applies except the wiring instructions*
- [**ADC**](ADC) - analog input over A0 pin - [**ADC**](ADC) - analog input over A0 pin
- **ADS1x15** - A/D Converter (I<sup>2</sup>C) - **ADS1x15** - A/D Converter (I<sup>2</sup>C)
- [**AM312**](PIR-Motion-Sensors#AM312) - PIR Motion Sensor - [**AM312**](PIR-Motion-Sensors#AM312) - PIR Motion Sensor<img src="https://i.postimg.cc/qRLyPy1n/APDS-9960-1-720x533.jpg" align=right>
- [**APDS-9960**](APDS-9960) - Ambient Light, RGB Color and Proximity Sensor with Gesture Detection - [**APDS-9960**](APDS-9960) - Ambient Light, RGB Color and Proximity Sensor with Gesture Detection
- [**AZ-7798**](Wemos-D1-Mini-and-AZ-Instrument-7798-CO2-Meter-Datalogger) - CO<sub>2</sub> Meter Datalogger - [**AZ-7798**](Wemos-D1-Mini-and-AZ-Instrument-7798-CO2-Meter-Datalogger) - CO<sub>2</sub> Meter Datalogger
- [**BH1750**](Wemos-D1-Mini-and-BH1750-Luminosity-Sensor) - Luminosity Sensor - [**BH1750**](Wemos-D1-Mini-and-BH1750-Luminosity-Sensor) - Luminosity Sensor
@ -15,9 +15,10 @@ More about [general configuration](https://github.com/arendst/Tasmota/wiki/Senso
- [**BME680**](Wemos-D1-Mini-and-BME680-Temperature,-Humidity,-Pressure-and-Gas-Sensor) - Temperature, Humidity, Pressure and Gas Sensor - [**BME680**](Wemos-D1-Mini-and-BME680-Temperature,-Humidity,-Pressure-and-Gas-Sensor) - Temperature, Humidity, Pressure and Gas Sensor
- [**CC2530**](Zigbee) - Zigbee Adapter (Serial) - [**CC2530**](Zigbee) - Zigbee Adapter (Serial)
- **CCS811** - Gas and Air Quality sensor (I<sup>2</sup>C) - **CCS811** - Gas and Air Quality sensor (I<sup>2</sup>C)
- [**DHT11**](Wemos-D1-Mini-and-DHT11-Shield-Humidity-&-Temperature) - Humidity & Temperature Sensor - [**Chirp! Soil Moisture Sensor**](Moisture-Sensor-and-Chirp!-Sensor) - (I<sup>2</sup>C)
- [**DHT11**](Wemos-D1-Mini-and-DHT11-Shield-Humidity-&-Temperature) - Humidity & Temperature Sensor<img src="https://user-images.githubusercontent.com/5904370/53279561-cfb18480-3711-11e9-9889-76ab1d6eafcb.png" width="250" align="right">
- [Sonoff Basic wiring](DHT11-Wiring---Sonoff-Basic) - [Sonoff Basic wiring](DHT11-Wiring---Sonoff-Basic)
- [**DHT22 (DHT21, AM2301, AM2302, AM2321)**](Wemos-D1-Mini-and-DHT22-(DHT21,-AM2301,-AM2302,-AM2321)-Shield-Humidity-&-Temperature) - Humidity & Temperature Sensor<img src="https://user-images.githubusercontent.com/5904370/53279561-cfb18480-3711-11e9-9889-76ab1d6eafcb.png" width="250" align="right" /> - [**DHT22 (DHT21, AM2301, AM2302, AM2321)**](Wemos-D1-Mini-and-DHT22-(DHT21,-AM2301,-AM2302,-AM2321)-Shield-Humidity-&-Temperature) - Humidity & Temperature Sensor
- **DS18x20** - Temperature sensor (GPIO) - **DS18x20** - Temperature sensor (GPIO)
- [**DS3231**](DS3231---External-RTC) - Real-Time-Clock (I<sup>2</sup>C) - [**DS3231**](DS3231---External-RTC) - Real-Time-Clock (I<sup>2</sup>C)
- [**HM16/HM17**](iBeacon-driver) - Bluetooth iBeacon reader (Serial) - [**HM16/HM17**](iBeacon-driver) - Bluetooth iBeacon reader (Serial)
@ -58,7 +59,6 @@ More about [general configuration](https://github.com/arendst/Tasmota/wiki/Senso
- [**SHT30**](Wemos-D1-Mini-and-SHT30-Shield-High-Precision-Humidity-&-Temperature) - Humidity & Temperature Sensor - [**SHT30**](Wemos-D1-Mini-and-SHT30-Shield-High-Precision-Humidity-&-Temperature) - Humidity & Temperature Sensor
- **SI114x** - UV Index, IR and Visible Light sensor (I<sup>2</sup>C) - **SI114x** - UV Index, IR and Visible Light sensor (I<sup>2</sup>C)
- [**Smart Meter Interface**](smart-meter-interface) - (Serial) - [**Smart Meter Interface**](smart-meter-interface) - (Serial)
- [**Soil Moisture Sensor**](Moisture-Sensor-and-Chirp!-Sensor) - (I<sup>2</sup>C)
- **SolaX X1** - SolaX X1 inverter (Serial) - **SolaX X1** - SolaX X1 inverter (Serial)
- **SPS30** - Particulate Matter (PM) - sensor (I<sup>2</sup>C) - **SPS30** - Particulate Matter (PM) - sensor (I<sup>2</sup>C)
- [**A4988 Stepper Motor Controller**](A4988-Stepper-Motor-Controller) - - [**A4988 Stepper Motor Controller**](A4988-Stepper-Motor-Controller) -

15
Smart-Meter-Interface.md

@ -1,8 +1,4 @@
**Driver for various meters , heating devices, and reed like contacts** **This feature is not included in precompiled binaries.** To use it you must [compile your build](compile-your-build). Add the following to `user_config_override.h`:
[Smart Meter Descriptors](Smart-Meter-Interface-Descriptors)
To use, you must compile your own firmware. Add the following compiler directives to `user_config_override.h`:
``` ```
#ifndef USE_SCRIPT #ifndef USE_SCRIPT
#define USE_SCRIPT # adds about 17k flash size, variable ram size #define USE_SCRIPT # adds about 17k flash size, variable ram size
@ -14,9 +10,14 @@ To use, you must compile your own firmware. Add the following compiler directive
#undef USE_RULES #undef USE_RULES
#endif #endif
``` ```
----
To use this interface, connect the meter to available device GPIO pins. These GPIO must be set as `None (0)` **Driver for various meters , heating devices, and reed like contacts**
components in the Tasmota Template or Module. If the interface detects that a meter descriptor GPIO conflicts with a Tasmota GPIO setting, the interface will generate a "duplicate GPIO defined" error in the log and the meter descriptor will be ignored.
[Smart Meter Descriptors](Smart-Meter-Interface-Descriptors)
To use this interface, connect the meter to available GPIO pins. These GPIOs must be set as `None (0)`
components in Tasmota. If the interface detects that a meter descriptor GPIO conflicts with a Tasmota GPIO setting, the interface will generate a "duplicate GPIO defined" error in the log and the meter descriptor will be ignored.
The Smart Meter Interface provides a means to connect many kinds of meters to Tasmota. **The following types of meter protocols are supported:** The Smart Meter Interface provides a means to connect many kinds of meters to Tasmota. **The following types of meter protocols are supported:**
- ASCII OBIS telegrams emitted from many smart meters and also from P1 meter interface - ASCII OBIS telegrams emitted from many smart meters and also from P1 meter interface