Skip to content

Latest commit

 

History

History
52 lines (35 loc) · 4.58 KB

FAQ.md

File metadata and controls

52 lines (35 loc) · 4.58 KB

FAQ

Low Level Circuitry stuff

How does the "Red Wire" on these Garage Door Openers work?

Each Garage Door Opener has two wires which connect between the GDO and any wired door control panels (the smart panels with displays and menu controls on them). These are a +12v wire and a Ground so that DC power is provided to the control panel.

However, that same +12v wire is also the data line which carries data between the GDO and the control panel. This works because each serial data pulse is a brief "pull to ground" of that +12v line. These pulses can be read by the door control panel (and, indeed read by the GDO if the data transmission is coming from the control panel and being sent to control the door). This is how the ratgdo both receives and transmits data as well. In essence, it appears to be just one more control device on the "bus".

Chamberlain often refers to this combined +12v and data line as "E-Serial": ratgdo connection example

If the +12V line is constantly pulsed low during data transmission, how come the door control panel doesn't turn off?

There's two answers to this and both are simple:

  • The data transmission is actually quite rare
  • The door control panel either has some beefy capacitors in it or a supercapacitor. Either way, the brief interruptions to power do not affect the control panel.

How come the 12 volt serial line doesn't blow the ESP8266 GPIO lines?

It's fairly simple how this operates. The really short version is that the MOSFETs are used as level shifters.

The more complex description is that the TX line 3.3v output is used to trigger the Gate of a MOSFET which grounds out the serial line, pulling it LOW. The circuit being closed is between the +12V serial line and GND. The GPIO pin therefore never sees 12 volts.

For the RX line, the Gate of the MOSFET on this part of the circuit is connected to the +12V serial line. Whenever +12v is applied to the gate, it causes the +3.3v from the ESP8266 GPIO pin to be pulled to ground. In this example, the voltage "push" (if you want to call it that) is going from the ESP8266 to the MOSFET and it is then switched to GND. GPIO pins on microcontrollers are designed to handle this "pull to ground" as a means of signalling/logic control, so there's no risk of the ESP8266 cooking itself. An important note to add to the RX circuitry is that when the door controller is transmitting data on the serial line, it is pulling the +12V line to GND. When the +12V line is pulled to ground, this switches off the MOSFET used in the RX circuit and therefore the GPIO pin on the ESP8266 goes high.

So, regardless of what device is transmitting on the serial line (whether that is the ESP8266, the door opener itself, or a door control panel, the transmitting device pulls the +12v line to ground.

How come the obstruction sensor circuit uses two resistors?

The obstruction sensor circuit uses two 10k resistors, one in series and one in parallel to ground. This causes the resistors to act as a voltage divider, bringing the voltage "seen" on pin D7 (GPIO13) down to ~3.3 volts.

What bitrate is the MyQ serial communication?

As per the code from the ratgdo project, it is 9600 bits per second.

Could I power the ESP8266 from the +12v serial line?

Whilst this is how the MyQ wall controllers work, the ESP modules pull too much current. However if your GDO has the connectors for battery backup you can use a voltage regulator module to do this.

What if I want to use SOT-23 SMD components?

If you want to use SOT-23 SMD components rather than through-hole, the following MOSFETs are recommended:

  • RX line: 2N7002
  • TX line: AO3400A

For resistors, knock yourself out. Any size you like as long as it's 10 kohm.

Higher level topics

My GDO terminals aren't red/white/black!

Some of the Chamberlain GDOs have a slightly different colour scheme. Check the manual for your specific model and look for potential different wiring labels. Generally the GND wires are always white.

WARNING! Some GDOs have a Red terminal which has nothing to do with what ratgdo refers to as the "Red wire", but instead might be used as a dry contact switch for installing a physical door button that Toggles the door.

Expected Wire or terminal Colour Possible Names Possible Colours
Red E-Serial Green
Black IR-Sensor Grey