From fef357eb012d00ece9cc47a4293c3f7c14285d47 Mon Sep 17 00:00:00 2001 From: Christian Date: Fri, 23 Nov 2018 20:08:49 +0100 Subject: [PATCH] adding pics --- MGC3130.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 53 insertions(+), 8 deletions(-) diff --git a/MGC3130.md b/MGC3130.md index 8af059bc..0eef4e37 100644 --- a/MGC3130.md +++ b/MGC3130.md @@ -1,19 +1,65 @@ # 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: - uncomment // #define USE_MGC3130 in sonoff/my_user_config.h - flash the device before connecting the sensor board -- 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 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 (TRFR is GPIO: MGC3130_XFER) + + + ## EXPECTED BEHAVIOUR: - 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. -- the airwheel gesture will be sensed and published as "AW" via MQTT with values between 0 and 1023 - clockwise up -- 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). + + +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 + +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). + +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) ## 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. ## 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 or with a "long" touch of a second rule1 on Tele-MGC3130#TH_C > 20 do sensor91 0 endon @@ -63,4 +109,3 @@ Ideas are welcome and will be integrated if possible. -