Device controls

The Controls page, at /controls, is where you change inverter and battery settings, and where the switch, selector, slider and knob cards live. You need to be signed in to use it.

How it keeps you safeCopy Anchor Link

Changing an inverter's settings can affect your whole power system, so the Controls page is careful:

• Device changes starts switched off. While it's off, nothing on this page or on any dashboard can change a setting on your inverter or battery.
• Even when it's on, you have to enter your password again to Unlock the page. The unlock lasts 5 minutes, and ends early when you sign out or press Lock now.
• Before changing anything, Epilykos reads the current value. It refuses the change if the new value is outside the setting's allowed range or step, if the device reports a current value that's out of range (a sign that the register might mean something different on your model), or if the value has changed since the page last showed it.
• After writing, Epilykos reads the setting back and tells you if it doesn't match what you asked for.
• Every attempt, including the refused ones, is recorded in the Change log.

Device settingsCopy Anchor Link

These devices can have settings changed so far:

A couple of notes:

• LuxPower: the charging and discharging power limits, the grid charging power limit, the grid charging, charge-first and forced-discharge switches and the grid-charging windows come from the LuxCloud app and only work when the inverter reports a GETA model. The other settings follow the LuxPower protocol, so the LuxPowerTek Generic Hybrid profile offers them on any LuxPower inverter; the LuxPowerTek GETA 3.6kW 24V profile offers the ones that model has. The inverter's firmware may still refuse or limit a value. Download verification saves a read-only snapshot of the inverter's settings, which is handy to keep before and after a change.
• JBD and JK: switching discharging off cuts power to whatever the pack supplies, so the page asks you to confirm that separately. If a pack won't switch charging back on, it's usually protecting itself.

Expert register writesCopy Anchor Link

Expert writes (off by default) let you read and write any register number, for registers you've checked in your device's manual. Register numbers can be decimal or hex (0x…), and values are whole numbers from 0 to 65535 in the register's raw units, with no scaling. The same unlock and change log apply.

Control cardsCopy Anchor Link

To add control cards, open the layout editor, choose Controls page from the dashboard menu, and add a Toggle switch, Button, State select, Slider or Rotary knob. They appear on the Controls page under Switches and selectors.

The slider and the knob set a number: a Home Assistant number or input_number, a Tuya value, or an MQTT topic. Pick what you want to control and give it a lowest value, highest value and step (a Home Assistant number fills these in for you). Moving the control only previews the value; it's sent when you let go of the slider, or stop turning the knob or pressing keys, so each gesture is one entry in the change log. Tapping the knob changes nothing, and the arrow keys, Page Up/Down, Home and End work on both.

Control cards follow the same rules as everything else here: Device changes has to be on, and each change needs the page to be unlocked.