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

Add wiki info for INTRETAIN setting

Andre Thomas 2018-12-08 17:28:48 +02:00
parent a0cfb06cf9
commit 27016c554b
1 changed files with 18 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
MCP23008-MCP23017.md

@ -254,6 +254,7 @@ These include the following
* INTDEF - Interrupt Deffer, being able to control the number of interrupts that are ignored on a specific pin before reporting would occur via telemetry and/or EVENT. * INTDEF - Interrupt Deffer, being able to control the number of interrupts that are ignored on a specific pin before reporting would occur via telemetry and/or EVENT.
* INTTIMER - Interrupt Timer which allows for time based counter reporting, specifically reporting the number of times an interrupt has occurred on interrupt enabled pins. * INTTIMER - Interrupt Timer which allows for time based counter reporting, specifically reporting the number of times an interrupt has occurred on interrupt enabled pins.
* INTCNT - Works with INTTIMER to enable/disable counting for a specific pin. * INTCNT - Works with INTTIMER to enable/disable counting for a specific pin.
* INTRETAIN - Keep track of whether an interrupt occured or not and defer reporting to next telemetry message.
The above additions are described in further detail below. The above additions are described in further detail below.
@ -303,6 +304,23 @@ Syntax:
sensor29 intcnt,pin // Readback current setting of interrupt counting for pin (0=OFF/1=ON) sensor29 intcnt,pin // Readback current setting of interrupt counting for pin (0=OFF/1=ON)
sensor29 intcnt,pin,x // Enable/Disable interrupt counting for pin (x=0=OFF,x=1=ON) sensor29 intcnt,pin,x // Enable/Disable interrupt counting for pin (x=0=OFF,x=1=ON)
``` ```
### ADVANCED FUNCTION #5 - INTERRUPT RETAIN (INTRETAIN)
This functionality disables immediate even and/or telemetry reporting for a specific pin that has been configured for any of the interrupt modes listed above.
If this is enabled for a particular pin and the pin has an interrupt mode configured the fact that an interrupt condition was met will be remembered (but not reported immediately) and will be reported in a MQTT message when the next telemetry period occurs in the following format:
```
{"Time":"2018-12-06T23:59:26","MCP_INTRETAIN": {"D0":1,"D1":0,"D2":1,"D3":1,"D4":0,"Value":13}}
```
In the example above it means that an interrupt occured at some point during the previous telemetry period for pins D0, D2, and D3 as indicated by the 1's present for each pin - Pins with a value of 0 means that although the pin was configured for interrupt retain that no interrupt occured during the previous telemetry period for that particular pin. For the sake of handling bitwise operations within your home automation software the decimal value of the respective bits are also aggrevated into the Value output included in the telemetry message.
Syntax:
```
sensor29 intretain,pin // Readback current setting of interrupt retain for a pin (0=OFF/1=ON)
sensor29 intretain,pin,x // Enable/Disable interrupt counting for pin (x=0=OFF,x=1=ON)
```
*** ***
### OUTPUT FUNCTIONS (PIN MODES 5 AND 6) ### OUTPUT FUNCTIONS (PIN MODES 5 AND 6)