ESP32 ⨯ Somfy Keygo remote case

how to build

Solder an ESP32 to a Somfy Keygo series remote. Those remotes use a similar case and should have the same PCB form factor. I tested with a Keygo io model.

On the back of the PCB, solder 3V3 to the metal plate and GND to the gold disc (i used the most top little hole in it). The ESP32 will supply power to the remote.

The 3 aligned switches are active high. The alone one is active low.
The below GPIOs have been choosen for a ESP32-DevKit-v1. You may want to use other GPIO on ESP32-C3 or ESP32-S3. Adapt the soldering and code consequently.
Solder as depicted on photo:
left button ("4"): top side to GPIO27,
middle button ("3"): right side to GPIO12,
right button ("2"): top side to GPIO14,
bottom button ("1"): right side to GPIO13.

The GPIO will either send high impedance (mode input) or connect to 3V3/GND (mode output, high/low).

ESPHome code

esp32:
  board: esp32dev
  framework:
    type: esp-idf
output:

platform: gpio
id: out_btn1
pin:
  number: 13
  inverted: true
platform: gpio
id: out_btn2
pin: 27
platform: gpio
id: out_btn3
pin: 12
platform: gpio
id: out_btn4
pin: 14

switch:

platform: output
id: switch_1
name: 'button 1'
output: out_btn1
restore_mode: RESTORE_DEFAULT_OFF
platform: output
id: switch_2
name: 'button 2'
output: out_btn2
restore_mode: RESTORE_DEFAULT_OFF
platform: output
id: switch_3
name: 'button 3'
output: out_btn3
restore_mode: RESTORE_DEFAULT_OFF
platform: output
id: switch_4
name: 'button 4'
output: out_btn4
restore_mode: RESTORE_DEFAULT_OFF

button:

platform: template
id: gate
name: 'gate'
icon: 'mdi:gate'
on_press:
  then:
- switch.turn_on: switch_2
- delay: !lambda |-
    return 600 + (esp_random() % 301);
- switch.turn_off: switch_2

The ESPHome switches are for pressing the buttons the same way it is possible to do physically, thus allowing to enter the settings. The ESPHome buttons are for reliable triggering of the gate opening/closing using the switches.

The random pressing time is to imitate a human behavior.

AliExpress links to buy the components

(those links are affiliated, using them will cost you nothing, but will support my work)
(you can try and browse for other cheaper sellers, those are the ones i ordered from)

Couldn't find a clone for Somfy IO remotes.
Somfy IO is a proprietary protocol, it's therefore probably easier to rely on a genuine remote.
Don't mix up with Somfy RTS, they are not compatible.

2026-08-27: update: the original model was made for ESP32-DevKit-v1.
I released new untested ones for ESP32-C3 supermini and ESP32-S3 supermini.

ESP32-DevKit-v1: https://l.kioa.net/printables/esp32-devkit-v1 (unsoldered MICRO CP2102 30 variant)
ESP32 supermini: https://l.kioa.net/printables/esp32-supermini (C3 or S3 variant, not PLUS)