Ramses Extras integration - ramses-rf/ramses_cc GitHub Wiki

Ramses Extras

A collection of features: add optional entities, automations, cards, websocket commands, servicecalls to Ramses RF (ramses_cc). It’s designed to work alongside ramses_cc without getting in the way. This integration/framework is built as a basis for new features and I want to expand it to get a nice collection of handy tools. If you want to contribute, or have an idea for what's missing, please contact me (create an issue on my repo).

I started this project to get a better user experience. With a few clicks you can enable a feature, enable the devices it should work with and your card or automation will become available in your dashboard...no more entities that need to be created by hand or other steps that are needed. Even the commands for FAN's are included, so no more need to set them in Ramses RF config flow. It became quite a big project, just have a look if you're interested.

Have fun, Willem (wimpie70)

What you get

  • HVAC Fan Card – A Lovelace card for ventilation/heat-recovery units with airflow diagrams, controls, and parameter editing, add a 'bound' REM to your FAN in Ramses RF to get full control.
  • Humidity Control – Automates fan speeds based on indoor/outdoor absolute humidity.
  • CO2 Control – CO2-based ventilation for air quality.
  • Temp Control (Bypass) – Temperature-based bypass management (free cooling & heating retention).
  • Sensor Control – Lets you choose which sensors provide temperature, humidity, CO₂, and absolute humidity for each device.
  • Ramses Debugger – Protocol debugger with packet log explorer, traffic analyser, and message viewer.
  • Device Simulator – Simulate RAMSES RF devices for testing (dedicated system/container only).
  • Hello World – Example/template for building new features.
  • Default – Shared entities, WebSocket commands, and helpers used by other features. In the Default feature configuration, enable the FAN device(s) you want ramses_extras to control.
  • Framework – Shared base classes and helpers to make adding new features easier.

More features planned—ideas and contributions welcome!

Install

Install Ramses Extras via HACS or manually, then enable the features you want in the Ramses Extras configuration flow. It will discover your Ramses RF devices and add the extra entities, automations, and Lovelace cards.

HA-Sim Test Tool

ramses_extras includes an automated end-to-end test suite (ha_sim_test) that exercises ramses_cc + ramses_extras on a dedicated ha-sim Docker container at 100x simulator speed. A full run takes ~6 minutes and executes 449 checks across 73 recipes covering schema management, device lifecycle, HVAC/FAN handling, raw packet injection, config entry migration, and log monitoring.

See the ramses_extras wiki for details.

Minimum version requirements

ramses_cc ramses_extras Notes
0.59.7+ 0.21.2+ Schema-as-SSOT (Phase 4): enforce_known_list always-on, known_list derived from schema, config entry v3 migration

Older combinations may work but are not tested. The schema-based architecture (Phase 4) requires ramses_cc 0.59.7+ and ramses_extras 0.21.2+.

Ramses Extras needs Ramses RF to be installed first. It doesn't replace ramses_cc, it just adds extras on top.