RAMSES ESP

Installatie

Van een losse ramses_esp tot een werkende app op je Homey.

Wat heb je nodig?

OnderdeelToelichting
Homey Pro (2023) of Homey Pro miniFirmware 12.4 of nieuwer. De app draait lokaal; Homey Cloud wordt niet ondersteund.
ramses_espEen ESP32 met 868 MHz-radio en de ramses_esp-firmware, verbonden met je wifi. Zie welke gateway voor boards die je kunt kopen.
MQTT-brokerWaar de ramses_esp naartoe publiceert. Het makkelijkst is de MQTT Broker-app op Homey zelf; Mosquitto op een NAS of Raspberry Pi werkt net zo goed.
Een RAMSES II-ventilatiesysteemOrcon, Itho, Vasco, ClimaRad of Nuaire op 868 MHz.

Plaats de ramses_esp ergens tussen je Homey-wifi en de ventilatie-unit in. 868 MHz komt goed door muren, maar een zolder met een betonvloer ertussen kan net te veel zijn. De busweergave laat de signaalsterkte (RSSI) van elk pakket zien.

Welke gateway?

Deze boards zijn getest met de app. Beide worden geleverd met de juiste firmware, dus je stelt alleen wifi en MQTT in (stap 2 hieronder).

BoardChipFirmwareWaar
Elecram Sub-GHz 855–925 MHz BridgeESP32-C6 + TI CC1101ramses_esp voor ESP32-C6 (meldt zich als ramses_esp_c6)elecram.com. Bestel de 868 MHz-antenne erbij.
Indalo-Tech RAMSES_ESPESP32-S3 + TI CC1101ramses_esp (meldt zich als ramses_esp)indalotech.co.uk, als de winkel open is.

De app leest beide firmwares op dezelfde manier: hij vindt gateways aan hun MQTT-topics, niet aan de naam van de firmware. Het Elecram-board heeft bij het instellen een paar extra aandachtspunten; zie Elecram ESP32-C6-board.

1. De MQTT-broker

De ramses_esp en Homey praten niet rechtstreeks met elkaar, maar via een MQTT-broker.

Optie A: de MQTT Broker-app op Homey (aanbevolen)

  1. Installeer de app MQTT Broker uit de Homey App Store.
  2. Open Apps → MQTT Broker → Instellen en controleer dat de broker op poort 1883 luistert.
  3. Maak een gebruiker aan (aanbevolen) en noteer gebruikersnaam en wachtwoord.
  4. Noteer het IP-adres van je Homey (Instellingen → Algemeen → Over). Dat is straks het brokeradres.

Let op

Geef je Homey een vast IP-adres in je router (DHCP-reservering). Verandert het adres, dan verliest de ramses_esp de verbinding met de broker.

Optie B: een bestaande broker

Gebruik je al Mosquitto (bijvoorbeeld van een oude Home Assistant-installatie)? Dan kun je die gewoon houden. Zorg alleen dat Homey de broker kan bereiken en dat je de gebruikersnaam en het wachtwoord hebt. TLS (mqtts) wordt ondersteund.

2. De ramses_esp instellen

Homey kan niet via USB-serial met de stick praten, dus de ramses_esp moet via wifi naar de MQTT-broker. Dat stel je één keer in via de seriële console. Daarna heeft de stick alleen nog stroom nodig: een USB-lader of een vrije USB-poort volstaat.

Achtergrond

Kom je van Home Assistant? Daar hing de stick meestal via USB-serial aan de Raspberry Pi. Haal hem eruit en configureer hem zoals hieronder. Je ramses_cc-configuratie heb je daarna niet meer nodig, maar bewaar het FAN ID en het remote-adres: die heb je straks in Homey nodig.

Seriële console openen

  1. Stop de ramses_esp in een pc met Windows, macOS of Linux.
  2. Open een seriële terminal op de juiste poort met 115200 baud:
    • Windows: PuTTY, verbindingstype Serial. De COM-poort vind je in Apparaatbeheer → Poorten (COM & LPT). Stel PuTTY in zoals hieronder voordat je op Open klikt.
    • macOS / Linux: bijvoorbeeld screen /dev/ttyUSB0 115200 (op macOS iets als /dev/tty.usbserial-…).
  3. Druk op Enter. Je krijgt de prompt van de ramses_esp.

PuTTY-instellingen

Waar in PuTTYInstellingWaarom
SessionConnection type Serial, serial line COM…, speed 115200De poort van het board.
Connection → SerialFlow control NoneMet de standaard XON/XOFF krijgt het board niets binnen van wat je typt.
TerminalImplicit CR in every LF aanRegels beginnen links in plaats van als een trap naar beneden te lopen.
TerminalLocal echo Force on, local line editing Force onJe ziet wat je typt en kunt het verbeteren vóór Enter.

Sla dit op onder een naam op de pagina Session, dan open je het de volgende keer met een dubbelklik. Sluit PuTTY voordat je het board flasht: maar één programma tegelijk kan de COM-poort gebruiken.

Wifi en MQTT instellen

Typ de commando's één voor één. Ze zijn hoofdlettergevoelig.

wifi password JOUW_WIFI_WACHTWOORD
wifi ssid JOUW_WIFI_SSID
wifi restart
mqtt user JOUW_MQTT_GEBRUIKER
mqtt password JOUW_MQTT_WACHTWOORD
mqtt broker mqtt://192.168.1.20:1883
sntp server pool.ntp.org
timezone CET
reset
CommandoWat het doet
wifi password / wifi ssidHet wachtwoord en de naam van je wifinetwerk. Gebruik een 2,4 GHz-netwerk; een ESP32 ondersteunt geen 5 GHz.
wifi restartVerbindt opnieuw met de nieuwe wifigegevens.
mqtt user / mqtt passwordDe gebruiker die je in de broker-app hebt aangemaakt. Laat weg als je broker geen inlog vraagt.
mqtt brokerHet adres van de broker. Met de MQTT Broker-app is dat mqtt://<IP van je Homey>:1883.
sntp server / timezoneTijdsynchronisatie, zodat de tijdstempels in de berichten kloppen.
resetHerstart de ramses_esp met de nieuwe instellingen.

Let op

Zet het wachtwoord altijd vóór de ssid- of brokerregel. Zodra de ramses_esp een ssid of broker krijgt, probeert hij meteen te verbinden. Staat het wachtwoord er dan nog niet in, dan mislukt die eerste poging.

Na de reset verbindt de stick met je wifi en de broker. Je kunt hem dan loskoppelen van de pc en ergens anders aan de stroom hangen, het liefst halverwege je Homey-wifi en de ventilatie-unit.

Meer commando's en firmware-updates staan in de documentatie van ramses_esp.

Elecram ESP32-C6-board

Het Elecram-board kent dezelfde commando's, met deze verschillen:

PuntWat je doet
NetwerkmodusDe firmware kan via wifi of Zigbee werken; MQTT werkt alleen in wifimodus. Typ network show. Staat er zigbee, typ dan network wifi; het board slaat dat op en herstart.
BrokeradresTyp het volledig, met mqtt:// en de poort: mqtt broker mqtt://192.168.1.20:1883.
MQTT-inlog wijzigenTyp reset na mqtt user en mqtt password. Tot die tijd blijft het board het opnieuw proberen met de oude inlog en toont de console steeds MQTT: Disonnected.
TijdDe firmware heeft standaard geen tijdserver, dus de tijdstempels staan op 1970-01-01. Stel er een in met sntp server pool.ntp.org en een tijdzone, bijvoorbeeld timezone CET-1CEST,M3.5.0,M10.5.0/3 (Amsterdam met zomertijd), en dan reset. Homey gebruikt de tijdstempels niet, dus dit is optioneel.

Als het werkt, toont de console:

# Connected to SSID:JOUW_WIFI_SSID
# MQTT: Connecting to mqtt://192.168.1.20:1883
# MQTT: Connected

In MQTT Explorer verschijnt het board als RAMSES/GATEWAY/18:xxxxxx = online met info/firmware = ramses_esp_c6.

Let op

Via Zigbee in plaats van wifi (experimenteel, niet getest). In Zigbee-modus kan het board aan Zigbee2MQTT worden gekoppeld. De fork heeft een Zigbee2MQTT-extensie (branch z2m_support, z2m/external_extensions/ramses-esp-bridge.mjs) die de pakketten doorgeeft op dezelfde RAMSES/GATEWAY/18:xxxxxx/rx- en /tx-topics, zodat de app ze gewoon kan lezen. Zigbee2MQTT moet dan dezelfde broker gebruiken als Homey. De extensie zit nog niet in een release en heeft ook de apparaatdefinitie van het board in Zigbee2MQTT nodig. Via Zigbee is er geen online/offline-statustopic, dus de online-kaart en de offline-melding van de gateway werken niet. Gebruik wifi, tenzij je wilt experimenteren.

Topics

Als het goed is, publiceert de ramses_esp daarna op deze topics:

TopicRichtingInhoud
RAMSES/GATEWAY/<id>ramses_esp → brokerOnline/offline-status (ook als last will)
RAMSES/GATEWAY/<id>/rxramses_esp → brokerElk pakket dat de radio hoort, als {"msg": "<frame>"}
RAMSES/GATEWAY/<id>/txbroker → ramses_espFrames die de ramses_esp moet versturen

<id> is het eigen adres van de ramses_esp, iets als 18:203612. Dat zie je in de ramses_esp zelf en in de topics; Homey vindt het meestal vanzelf.

Achtergrond

Wil je controleren of de ramses_esp publiceert voordat je de app installeert? Abonneer met een MQTT-client zoals MQTT Explorer op RAMSES/#. Je hoort dan binnen een minuut verkeer van je unit, je sensoren en, in een appartementencomplex, ook van de buren.

3. De app installeren

De app staat als testversie in de Homey App Store. Je installeert hem met één klik:

Installeer RAMSES ESP op je Homey

  1. Open de link hierboven en log in met je Homey-account.
  2. Klik op Installeren en kies je Homey.
  3. Na een paar seconden staat de app onder Apps op je Homey.

Je hebt geen computer, Node.js of Homey CLI nodig.

Achtergrond

Een testversie is nog niet door Athom gekeurd en is niet te vinden via de zoekfunctie van de App Store, alleen via deze link. Zodra de app officieel gepubliceerd is, vind je hem ook door op RAMSES ESP te zoeken.

Wil je zelf aan de app sleutelen? Zie dan Ontwikkelen.

4. Apparaten toevoegen

Voeg de apparaten altijd in deze volgorde toe:

  1. Ramses Gateway: zonder gateway hoort Homey niets van de bus.
  2. Ventilatie-unit
  3. Afstandsbedieningen en sensoren (optioneel)
  4. Virtuele CO₂-sensor (optioneel)

Klaar? Ga verder met de gateway toevoegen.

Bewerken op GitHub

Overzicht

Laat je ventilatie meebewegen met CO₂, vochtigheid en je dagritme.

Gateway toevoegen

De gateway is de verbinding tussen Homey en je ramses_esp. Alle andere apparaten lopen erdoorheen.

Op deze pagina

Wat heb je nodig?Welke gateway?1. De MQTT-brokerOptie A: de MQTT Broker-app op Homey (aanbevolen)Optie B: een bestaande broker2. De ramses_esp instellenSeriële console openenPuTTY-instellingenWifi en MQTT instellenElecram ESP32-C6-boardTopics3. De app installeren4. Apparaten toevoegen