RAMSES RF voor Home Assistant (Marketplace-integratie)

Installaties: 229 die analysegegevens delen
GitHub-sterren: 124
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: 0.61.2, 26 oktober 2026
Categorie: Hubs en protocollen, Draadloze protocollen
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: ramses_cc
Bron: github.com/ramses-rf/ramses_cc
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

RAMSES RF is een integratie voor verwarmings- en ventilatiesystemen die het RAMSES-II RF-protocol gebruiken. Het omvat centrale verwarmings- en warmwatersystemen zoals evohome, en ventilatie-eenheden van merken als Itho en Orcon. Het communiceert lokaal met het systeem via een USB- of MQTT-radiotransceiver, en de installatie gebeurt in de UI. Het voegt klimaat-, boiler-, sensor-, selectie-, nummer-, knop-, gebeurtenis- en afstandsbedieningsentiteiten toe, waaronder een selector voor de systeemmodus en een instelling voor het pollinginterval. Acties omvatten het koppelen van apparaten, het verzenden van aangepaste commandopakketten, het uitlezen van ventilatorparameters, het ophalen van een foutenlogboek van een controller en het resetten van een filterteller. Een passieve scan kan onbekende RF-apparaten vinden, die daarna in het systeemschema kunnen worden opgenomen, en het loggen van pakketten is instelbaar.

Automatische samenvatting van de README en de code van ramses-rf/ramses_cc, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Klimaat
Boilers
Afstandsbedieningen
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Selecteer de seriële poort

Pad naar seriële poort

MQTT-configuratie

IP-adres of hostnaam van broker
Poort
Gebruikersnaam (Optioneel)
Wachtwoord (Optioneel)

Seriële-poortinstellingen

Pad naar serieel apparaatBijv. '/dev/cu.modem2', 'COM6' (Windows) of 'mqtt://user:pwd@homeassistant.local:1883'
Geavanceerde instellingen seriële poortVoor standaardgebruik niet vereist, behalve voor nanoCUL: 'baudrate: 57600'
Oude Zigbee-bevestigingen gebruikenAutomatische firmwaredetectie overschrijven en tekstbevestigingen gebruiken.

Gateway-configuratie

Scan-intervalHoe vaak opvragen (pollen) voor wijzigingen? Advies: waarde tussen 60 en 180 s.
Gateway time-outHoe lang (in minuten) te wachten voordat de gateway als inactief wordt beschouwd. Verhoog dit voor stille netwerken (bijv. 10-15 minuten).
Geavanceerde instellingen ramses_rf gatewayVoor standaardgebruik niet vereist.
Gateway Apparaat-ID (bijv. 18:000730)
MQTT Topic Voorvoegsel

Systeemschema

SysteemschemaEen mapping van systeem device-ID's naar hun schema's inclusief Zones met Sensors, als YAML.
Log Tx + alle MQTT-topicsToon alle topics van de MQTT broker in de systeemconsole.

Geavanceerde opties

Schakel send_packet service in om maatwerkberichten (bytes) te broadcasten
Reguliere expressie als filter voor berichtenVerstuur ramses_cc event als een bericht aan deze reguliere expressie voldoet, bijv. RP.* 10: = bij elk bericht van een OTB. Laat leeg om uit te schakelen.
Schakel passieve apparaat-scan in om onbekende RF-apparaten te ontdekkenLuistert naar RF-verkeer en identificeert onbekende apparaten. Ontdekte apparaten kunnen worden beoordeeld en via service-calls aan het schema worden toegevoegd.
Stuur een persistente melding wanneer nieuwe apparaten worden gevondenIndien ingeschakeld verschijnt een persistente melding wanneer nieuwe onbekende apparaten worden ontdekt.
Aantal dagen zonder verkeer voordat een apparaat als vermist wordt gemarkeerdAantal dagen dat een geaccepteerd apparaat zonder verkeer kan blijven voordat het als vermist wordt gemarkeerd.
Melding wanneer gateway offline isIndien ingeschakeld verschijnt een persistente melding wanneer de gateway gedurende de time-outperiode geen RF-pakketten heeft ontvangen. Schakel uit voor zeer stille netwerken (bijv. een enkele PIV-ventilator).
Activeer 'Laatst verzonden bericht'-sensorenVoegt een diagnostische sensor per apparaat toe met het laatst verzonden bericht. Standaard uit: de sensor wordt bij elk verzonden bericht bijgewerkt, wat het aantal database-writes verdubbelt en het activiteitenlogboek van het apparaat extra belast.

Packet-log

Pad naar logmapPad naar de map waar logbestanden worden opgeslagen (bijv. /config/ramses_rf_logs/).
Voorvoegsel logbestandVoorvoegsel voor de bestandsnaam (bijv. 'packet_log' maakt 'packet_log.log').
Aantal dagen dat logs bewaard wordenAantal dagen om historische log-backups te bewaren voordat ze worden verwijderd.
Geheugenbuffer capaciteit (regels)Aantal regels in het werkgeheugen (RAM) voordat deze naar schijf worden geschreven. Gebruik 0 om de 'flight recorder' uit te schakelen.
Tijdsinterval voor legen buffer (seconden)Interval dat de geheugenbuffer weggeschreven moet worden, in seconden.
Leeg buffer bij foutniveauBij welk type log-melding (bijv. WARNING of ERROR) de buffer direct naar schijf geschreven moet worden.

Na het instellen

Pad naar serieel apparaat
Pad naar serieel apparaatBijv. '/dev/cu.modem2', 'COM6' of 'mqtt://user:pwd@homeassistant.local:1883'
Geavanceerde seriële-poortconfiguratieVoor standaardgebruik niet vereist, behalve voor nanoCUL: 'baudrate: 57600'
Oude Zigbee-bevestigingen gebruikenAutomatische firmwaredetectie overschrijven en tekstbevestigingen gebruiken.
Scan-intervalHoe vaak opvragen (pollen) voor wijzigingen? Advies: waarde tussen 60 en 180s.
Gateway time-outHoe lang (in minuten) te wachten voordat de gateway als inactief wordt beschouwd. Verhoog dit voor stille netwerken (bijv. 10-15 minuten).
Geavanceerde ramses_rf gateway-configuratieVoor standaardgebruik niet vereist.
Gateway Apparaat-ID
MQTT Topic Voorvoegsel
SysteemschemaEen mapping van systeem device-ID's naar hun schema's inclusief Zones met hun Sensors, als YAML.
Log Tx + alle MQTT-topicsToon alle topics van de MQTT broker in de systeemconsole.
Schakel send_packet service in om maatwerk-berichten te versturen
Stuur een event als een bericht voldoet aan deze reguliere expressieVul een reguliere expressie in waar berichten aan moeten voldoen, bijv. RP.* 10: zal een event sturen voor elk RP-bericht van een OTB.
Schakel passieve apparaat-scan in om onbekende RF-apparaten te ontdekkenLuistert naar RF-verkeer en identificeert onbekende apparaten. Ontdekte apparaten kunnen worden beoordeeld en via service-calls aan het schema worden toegevoegd.
Stuur een persistente melding wanneer nieuwe apparaten worden gevondenIndien ingeschakeld verschijnt een persistente melding wanneer nieuwe onbekende apparaten worden ontdekt.
Aantal dagen zonder verkeer voordat een apparaat als vermist wordt gemarkeerdAantal dagen dat een geaccepteerd apparaat zonder verkeer kan blijven voordat het als vermist wordt gemarkeerd.
Melding wanneer gateway offline isIndien ingeschakeld verschijnt een persistente melding wanneer de gateway gedurende de time-outperiode geen RF-pakketten heeft ontvangen. Schakel uit voor zeer stille netwerken (bijv. een enkele PIV-ventilator).
Activeer 'Laatst verzonden bericht'-sensorenVoegt een diagnostische sensor per apparaat toe met het laatst verzonden bericht. Standaard uit: de sensor wordt bij elk verzonden bericht bijgewerkt, wat het aantal database-writes verdubbelt en het activiteitenlogboek van het apparaat extra belast.
Pad naar logmapPad naar de map waar logbestanden worden opgeslagen (bijv. /config/ramses_rf_logs/).
Voorvoegsel logbestandVoorvoegsel voor de bestandsnaam (bijv. 'packet_log' maakt 'packet_log.log').
Aantal dagen dat logs bewaard wordenAantal dagen om historische log-backups te bewaren voordat ze worden verwijderd.
Geheugenbuffer capaciteit (regels)Aantal regels in het werkgeheugen (RAM) voordat deze naar schijf worden geschreven. Gebruik 0 om de 'flight recorder' uit te schakelen.
Tijdsinterval voor legen buffer (seconden)Interval dat de geheugenbuffer weggeschreven moet worden, in seconden.
Leeg buffer bij foutniveauBij welk type log-melding (bijv. WARNING of ERROR) de buffer direct naar schijf geschreven moet worden.
Wis ontdekte systeemschema
Wis systeemtoestand (recente berichten)
Wis discovery-state (gevonden apparaten)
Pool-leden (vink uit om te verwijderen, primaire kan verwijderd worden — promoot automatisch een andere)
Ontdekte kandidaten (vink aan om als pool-lid te accepteren)
Extra poorten (USB, Zigbee, externe MQTT)
Nieuwe HGI toevoegen
MQTT-pool: aantal seconden wachten tot minstens één HGI online komt
Bevestig: alle HGI's wissen en verbinding resetten

Teksten uit de code van ramses-rf/ramses_cc. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

KnoppenUpdate Alles, Synchroniseer Topologie, Ontdek Bekende Apparaten, Reset Filter-teller
GebeurtenissenLeer, Regex Match
NummersPoll-interval
SelectiesSysteemmodus

Acties

Koppel een apparaatKoppel een apparaat aan een CH/DHW controller of aan een fan/WTW-eenheid. Het te koppelen apparaat is een sensor (bijv. temperatuur, relatieve vochtigheid, etc.) of een afstandsbediening (bijv. een 4-knops RF-schakelaar). En het moet vermeld staan in het Systeemschema, correct geconfigureerd met de juiste apparaat-klasse en met faking ingeschakeld.Velden: Device_id van het apparaat, Aanbod, Bevestiging, Apparaat-info
Werk systeemstatus bijWerk nu de systeemstatus bij i.p.v. wachten tot de eerstvolgende geplande update.
Synchroniseer geleerde topologieSynchroniseer nu de geleerde topologie (zones, DHW, orphans) van ramses_rf terug naar de config entry, zonder te wachten op het 5-minuten interval.
Ontdek bekende apparatenStuur RQ discovery berichten vanuit de HGI naar apparaten in het Systeemschema die nog niet geregistreerd of nog niet gepromoveerd zijn naar hun verwachte klasse. Handig na cache wis of bij nieuwe installatie.Velden: Apparaat-ID
Ontdekte apparaten ophalenHaal de lijst op van apparaten die door de passieve scan zijn ontdekt, optioneel gefilterd op status of enabled-vlag. Vuurt een ramses_cc_discovered_devices event met de resultaten.Velden: Status, Ingeschakeld
Ontdekt apparaat accepterenAccepteer een ontdekt apparaat en voeg het toe aan het schema. Het apparaat wordt aangemaakt bij de volgende discover_known_devices aanroep.Velden: Apparaat-ID, Eigenaar, Schema-entry
Ontdekt apparaat afwijzenWijs een ontdekt apparaat af. Het blijft in de lijst voor spam-preventie maar wordt niet aangemaakt.Velden: Apparaat-ID
Ontdekt apparaat verwijderenMarkeer een eerder geaccepteerd apparaat als verwijderd (het bestaat niet meer). Discovery-info wordt bewaard om hernotificatie te voorkomen.Velden: Apparaat-ID
Ontdekt apparaat inschakelenSchakel een uitgeschakeld of afgewezen apparaat in zonder de status te wijzigen.Velden: Apparaat-ID
Ontdekt apparaat uitschakelenSchakel een geaccepteerd apparaat tijdelijk uit (bijv. voor onderhoud) zonder de status te wijzigen.Velden: Apparaat-ID
Faked REM toevoegenMaak een faked REM (virtuele afstandsbediening) aan voor het versturen van commando's naar een FAN. Geen RF-verkeer nodig.Velden: Apparaat-ID, Gekoppeld aan, Alias
Apparaat verwijderenVerwijder een apparaat uit de Systeemschema en HA apparaat-register. Handig wanneer een apparaat vervangen is, niet meer aanwezig is, of per ongeluk is toegevoegd. De HGI gateway kan niet verwijderd worden.Velden: Apparaat-ID
Apparaat ontkoppelenKoppel een REM/DIS (of HVAC-sensor) los van een FAN zonder een van beide apparaten te verwijderen. Het apparaat behoudt zijn eigen schema-entry en wordt als HVAC-orphan vermeld voor review. Dit is alleen een lokale (schema) ontkoppeling — er bestaat nog geen geverifieerde on-air unbind, dus de FAN kan het apparaat blijven melden als gekoppeld tot een hardware-unbind/gebaar.Velden: Apparaat-ID, FAN-ID, Bevestigen, Ontkoppelen via de ether
Fan-parameter opvragenVraag een instelling (2411) op van een FAN. Selecteer het FAN-apparaat of de entiteit, of vul het RAMSES FAN-ID in.Velden: FAN-apparaat, RAMSES FAN-ID, Parameter-ID, Bronapparaat-ID
Fan-parameter instellenStel een instelling (2411) in op een FAN. Selecteer het FAN-apparaat of de entiteit, of vul het RAMSES FAN-ID in.Velden: FAN-apparaat, RAMSES FAN-ID, Parameter-ID, Waarde, Bronapparaat-ID
Fan-parameters bijwerkenVraag alle beschikbare instellingen (2411) op van een FAN. Werkt alle parameter entiteiten bij voor het apparaat. Selecteer het FAN-apparaat of de entiteit, of vul het RAMSES FAN-ID in.Velden: FAN-apparaat, RAMSES FAN-ID, Bronapparaat-ID
Reset filter-tellerReset de filter_remaining teller van een fan via de remote. Die moet vermeld staan in het Systeemschema, correct geconfigureerd met de juiste apparaat-klasse en met faking ingeschakeld.
Verstuur een maatwerkberichtVerstuur een op maat gemaakt RAMSES II commando-bericht (bytes) vanaf de gateway/dongel.Velden: Bestemming, Bron, Opdracht-code, Bericht-code, Inhoud als HEX
Haal foutenlog van een TCS (Controller) opVerzamelt het meest recente foutenlog van een Controller.Velden: Aantal logberichten
Reset TCS (Controller)Het systeem gaat in Auto modus en alle zones gaan naar follow_schedule modus, incl. (voor zover ondersteund) zones die nu in permanent_override modus staan.