adding pics

Christian 2018-11-23 20:08:49 +01:00
parent 7e6e051b0f
commit fef357eb01
1 changed files with 53 additions and 8 deletions

@ -1,19 +1,65 @@
# MGC3130 # MGC3130
The MGC3130 is an electrical-field (E-field) based three-dimensional (3D) tracking and gesture controller from Microchip. There a several boards available, which are connected via I2C. The MGC3130 is an electrical-field (E-field) based three-dimensional (3D) tracking and gesture controller from Microchip. There are several boards available, which are connected via I2C.
## USAGE: ## USAGE:
- uncomment // #define USE_MGC3130 in sonoff/my_user_config.h - uncomment // #define USE_MGC3130 in sonoff/my_user_config.h
- flash the device before connecting the sensor board - flash the device before connecting the sensor board
- wire up SDA and SDL and configure as usual in TASMOTA - wire up SDA and SDL and configure as usual in TASMOTA
- wire up RESET and TRFR (names may vary on different boards) to free GPIO's and configure them accordingly - wire up RESET and TRFR (names may vary on different boards) to free GPIO's and configure them accordingly (TRFR is GPIO: MGC3130_XFER)
## EXPECTED BEHAVIOUR: ## EXPECTED BEHAVIOUR:
- after boot gestures (FLICK, EDGE_FLICK, TOUCH, TAP, DOUBLE_TAP) will be sensed and published via MQTT - after boot gestures (FLICK, EDGE_FLICK, TOUCH, TAP, DOUBLE_TAP) will be sensed and published via MQTT
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/flick_ew.gif)
Flicks:
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/flick_ew.gif) ![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/edgeflick_w.gif)
Taps:
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/tapsouth.gif) ![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/doubletapeast.gif)
***
- you can select different modes with the COMMANDS, touch will always be sensed and report the duration in 1/20 seconds. - you can select different modes with the COMMANDS, touch will always be sensed and report the duration in 1/20 seconds.
Touch:
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/touchnorth.gif )
***
- the airwheel gesture will be sensed and published as "AW" via MQTT with values between 0 and 1023 - clockwise up - the airwheel gesture will be sensed and published as "AW" via MQTT with values between 0 and 1023 - clockwise up
Airwheel:
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/airwheel.gif)
***
- after entering postion mode the values for x,y,z will be sensed and published via MQTT with values between 0 and 1023 for x,y. Data is only published, when z is in the upper half (z values are between 0 and 511). - after entering postion mode the values for x,y,z will be sensed and published via MQTT with values between 0 and 1023 for x,y. Data is only published, when z is in the upper half (z values are between 0 and 511).
Location sensing in active volume:
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/locationactivevolume.gif)
- near the surface you can move your finger without producing location data, i.e. to change the mode.
![](https://github.com/Staars/MGC3130_for_tasmota/blob/master/locationinactivevolume.gif)
***
- at the moment the circle gestures ((COUNTER)CLOCKWISE) must be activated with the COMMAND: SENSOR91 1 (we must wait 250 ms after the start and can not activate it in the init function, this might differ depending on the board firmware) - at the moment the circle gestures ((COUNTER)CLOCKWISE) must be activated with the COMMAND: SENSOR91 1 (we must wait 250 ms after the start and can not activate it in the init function, this might differ depending on the board firmware)
## COMMANDS: ## COMMANDS:
@ -33,7 +79,7 @@ The MGC3130 is an electrical-field (E-field) based three-dimensional (3D) tracki
* In position mode we get {X:0...1023,Y:0...1023,Z:0...511}, where X and Y are 0 in the lower left (west-south) corner. The z value is not published in close proximity to the surface in order to have a chance to switch to another mode with a TOUCH, TAP or DOUBLE-TAP. So the active sensing volume is in the upper z-half of the theoretical maximum sensing volume. * In position mode we get {X:0...1023,Y:0...1023,Z:0...511}, where X and Y are 0 in the lower left (west-south) corner. The z value is not published in close proximity to the surface in order to have a chance to switch to another mode with a TOUCH, TAP or DOUBLE-TAP. So the active sensing volume is in the upper z-half of the theoretical maximum sensing volume.
## EXAMPLES: ## EXAMPLES:
a possible solution to cycle through the modes only with the sensor by double tapping the centre is using RULES: A possible solution to cycle through the modes only with the sensor by double tapping the centre is using RULES:
rule1 on Tele-MGC3130#DT_C do sensor91 0 endon rule1 on Tele-MGC3130#DT_C do sensor91 0 endon
or with a "long" touch of a second or with a "long" touch of a second
rule1 on Tele-MGC3130#TH_C > 20 do sensor91 0 endon rule1 on Tele-MGC3130#TH_C > 20 do sensor91 0 endon
@ -63,4 +109,3 @@ Ideas are welcome and will be integrated if possible.