1What the module is for
A simple layout for rooms with several circuits. Each area has its own backlight, the panel senses an approaching hand and responds with a short vibration.
Every BALANS switch consists of three layers in a single Kopos box KPR 68-70_KA (depth 70 mm): the front panel FACE behind glass, the control board CORE and the power module POWER at the bottom of the box. The boards are held by a printed carrier screwed into the lugs of the box. The panel and the 84 × 84 mm glass sit in a frame that snaps onto the carrier.
wall <-------------------------------------------------> room
POWER module | carrier | CORE | air | FACE panel | glass | frame
+-- header 2x5 --+ +---- FFC 24p (type B) ---+

2Safety
- Do not open the switch during operation. If the glass cracks, or you notice a smell or excessive heat, switch off the circuit breaker and contact the installer.
- Clean with a dry or slightly damp cloth without detergent. Do not spray water on the glass. Before wiping you can turn on the cleaning lock (web interface, Home Assistant).
- The product is for dry indoor rooms only.
3Mounting and connection
- Switch off the circuit breaker (disconnect PoE) and verify that the whole assembly is de-energised.
- Check the FFC cable, type B (see above).
- Assemble the front on the bench: stick the 1 mm foam pads onto the 4 posts of the frame and place the panel on the 4 pins (M2.5 holes in the corners).
- Connect the optional vibration motor to the JST SH 2-pin connector on the back of the panel.
- Put on the 84 × 84 × 2 mm glass (R2 corners) and push it under the 4 spring clips of the frame. The glass is clipped in away from the wall; with the frame fitted it could pop out of the carrier.
- Insert the FFC cable into the panel connector and into the CORE board, lock the latches and snap the whole front onto the carrier.
- Stick the label with the setup code on the back of the panel or on the carrier, and hand a copy to the user.
- After power-up, calibrate the touch (chapter Commissioning).
Removal: lever out the whole front (frame with panel and glass) with a flat screwdriver in the groove in the middle of the bottom edge and disconnect the FFC. The glass is taken out of the frame on the bench; it cannot be pulled off the wall with a suction cup.

4Technical data
| Item | Value |
|---|---|
| board | 82 × 82 mm for 84 × 84 × 2 mm glass |
| controls | 4 touch areas in a 2 × 2 grid, guard rings |
| backlight | 4 RGB LEDs SK6812MINI-E |
| feedback | proximity detection, vibration motor (optional) |
| connection | FFC cable 24-pin 0.5 mm type B to the CORE board |
| sensor | Bosch BME688: temperature, humidity, pressure, air quality (eCO2 is only an estimate). Optional part: the panel also comes without the sensor; it can then take the temperature from another BALANS switch or from Home Assistant |
| power supply | from the CORE board (5 V / 3.3 V) |
| environment | indoor, dry, 0–35 °C (preliminary), IP20 |
| board revision | B |
Load ratings are preliminary until heating tests are complete.
5Commissioning
- Switch on the circuit breaker (or connect PoE / power). The front panel lights up.
- Without Ethernet and without a configured Wi-Fi, the switch starts its own setup Wi-Fi “SmartButton-XXXX” (XXXX = end of the MAC address). The password is the 8-digit setup code from the label. The administrator can find it later in the web interface too (card “About the device and support”, button “Show code”, confirmed with the password). On the FACE Display panel the code appears on the display in the settings window (hold the centre for 5 s).
- Connect a phone or laptop and open http://192.168.4.1.
- Set the web password (8–31 characters) and give it to the user together with the label.
- The web interface offers the Setup wizard: name and room, front panel and power module (the wizard shows which module the switch has detected), touch calibration, Wi-Fi and time zone, Home Assistant (MQTT), default button layout and a summary. Nothing is written to the switch before the last step. After a change of panel or module the switch restarts and the wizard continues.
- No output moves until a module is selected. If the selected module does not match the connected one, the outputs stay off and the web interface shows the reason (code E02). A new switch can also select the module by itself: after the first power-on nothing happens, after the second the module is set (POWER Relay and Triac with mains connected, RGBW with the newer board, Base from PoE, PoE IO). The outputs then stay off until someone switches them on for the first time. Heating, blinds and modules in development are not set automatically. If the switch is to stay without a module, confirm “No module” on the Hardware page.
- Test all outputs and touch areas.
- The web interface is then at http://<name>.local or at the IP address from the router. With Ethernet (POWER Base, POWER PoE IO) the switch gets its address from DHCP.
Touch calibration is done through the glass once the front is assembled. It can be started in three ways: in the wizard (step Touch), on the Touch page with the “Calibrate on device” button (the LEDs under the areas guide you: white = do not touch, green = touch and hold, blue = release; at the end green = saved, red = weak area), or right on a new switch without a password: for the first 2 minutes after power-up the LED under the first area slowly “breathes” white, and holding this area alone for 3 s starts the calibration. The areas keep switching as usual meanwhile.
Calibration is also started by a short press of the BOOT button on the control board. On a panel with a slider, the slider finally lights up green: slide slowly along it from one end to the other. After power-on the switch does not respond to touch for about 3 seconds while it measures the idle values of the areas; lights that are to be on after power-on light up immediately.
If Wi-Fi does not connect, the web interface says why in plain words: the network was not found, the password does not match, or the security does not fit. It shows the signal strength with four bars and a word (excellent to very weak) in the header and on the Network page. A hidden network does not appear in the list; type its name by hand.
Web modes: Standard, Advanced and Expert (System → Web appearance). The mode only hides pages and cards an ordinary user does not need. The configured values remain, and warning cards are never hidden. The web interface is in Czech, Slovak, English, Polish and German and is adapted to phones as well. Explanations are short; details open with the “i” button.
Setup mode can be opened again with a gesture: hold two touch areas firmly at the same time for 5 s (FACE Display: the centre of the display for 5 s), or the BOOT button on the control board for 3–10 s. The setup Wi-Fi starts for 5 minutes and the LEDs flash blue. Without Ethernet it also starts when the switch cannot connect to the network for 3 minutes.
Time: the switch takes the time from the internet (NTP). In a network without internet it takes it from the browser after the administrator logs in. Without valid time the scheduler, the night mode and the weekly thermostat programme wait (code E12).
Home Assistant: turn on MQTT and “HA discovery” in the web interface; the entities appear by themselves and are placed in the given room. PLC: Modbus TCP is off by default and is enabled in the web interface (Integrations), preferably read-only and with an allowed IP address. The switch belongs in a separate network (VLAN). Remote access only through Home Assistant or a VPN, never by port forwarding.
Firmware is updated by a technician in the web interface (System → Updates) with a file supplied by the manufacturer. The update is signed. The new firmware is confirmed once the network and the web interface come up after the restart; otherwise the switch rolls back to the previous version by itself within 5 minutes. An update from an address needs a direct link; the switch rejects redirects. Optionally you can enable nightly automatic update from a private https address (off by default): it only runs at the chosen hour, when nothing is lit, no shutter is moving and nobody has touched the switch for 30 minutes. The firmware is not published. This manual describes firmware 2.38.3 (built and signed, not yet verified on the device).
Handover to the customer (System → Maintenance): one action for the installer at the end of the installation. It asks for the administrator password again, offers to set the password of the “control only” user and a new administrator password that only the customer will know (both can be skipped), then it deletes the traces of testing: event log, charts, consumption estimate, log, API tokens, webhooks and the syslog target, and ends all sessions. Optionally it also deletes the stored Wi-Fi. Installation settings, calibration, scenes, scheduler, integrations and passwords remain; the dialog lists which access credentials are left in the switch.
Settings change history (System): the last 8 saved changes with the time and the area they concerned, without values. The “Undo last change” button returns the settings to the state before the last change. Passwords, tokens, keys and the hardware selection are not reverted.
Factory reset from the web interface requires the administrator password to be entered again. With the BOOT button on the board (hold for 10 s) it works without a password; holding it for a shorter time does not reset the switch.
Device health (Diagnostics page): in one word “OK”, “Warning” or “Error”, and below it why and what to do about it. The administrator also finds a list of the last 8 firmware crashes there; if crashes repeat, send it to the manufacturer. The same status is in Home Assistant.
Manuals: the “About the device and support” card has links to the manual for the panel, the module and the control board at benesl-automation.cz/balans/navody/.
Service: System → Maintenance → Service bundle saves one file with the version, status, diagnostics and settings without passwords and keys. It contains network names and IP addresses, so send it only to the manufacturer, not publicly.
6Controls and LEDs
| Area | Short touch | Hold |
|---|---|---|
| top left | output 1 | dimming output 1 |
| top right | output 2 | dimming output 2 |
| bottom | event (scenes in Home Assistant / PLC) | event |
The actions can be changed in the web interface on the Buttons.
Further functions of the areas are enabled in the web interface: double and triple touch (off from the factory, enabled separately for each button; a short touch then responds about 0.4 s later), palm tap (one main action), cleaning lock, child lock, night path, staircase timer with a warning before switch-off, scenes and linking with other BALANS switches without Home Assistant. A very long press (5 s) and two areas at once are events for Home Assistant; they do not switch anything themselves.
| Backlight | Meaning |
|---|---|
| warm orange | output on |
| blue | output off |
| dimmed | idle; at night the night brightness (fixed window or from sunset to sunrise) |
| lights up on approach | hand approaching |
| flashing blue | setup mode |
| white “breathing” of the first area | a new switch offers touch calibration |
| white / green / blue area by area | touch calibration on the device is running |
| three red flashes | a fault has occurred (code in the web interface) |
| one area flashes red | the area is switched off because it would switch by itself (code E25) |
| colour from Home Assistant | LED notification (e.g. open window, doorbell) |
| green / yellow / orange / red when idle | air quality (optional, off by default; only a panel with its own BME688 sensor and only after the sensor has settled). The “only when the air gets worse” mode also suits colour-blind users. Output state, faults and notifications always take priority |
7Troubleshooting
| Symptom | Cause | Remedy |
|---|---|---|
| panel dark, web interface unreachable | no power, FFC cable not connected | circuit breaker / PoE, FFC connection (type B) |
| touch does not respond or responds by itself | the calibration through the glass no longer fits (E19) | wipe the glass, run the touch calibration |
| one area flashes red and does not respond | the area is switched off (E25): water on the glass or missing calibration | wipe the glass, wait half a minute, then calibrate (web interface or a short press of BOOT) |
| the panel does not wake up when a hand approaches | a hand approaching slowly or resting | a touch always wakes the panel; the sensitivity is on the “Wake on approach” card |
| temperature reads higher than in the room | electronics in the box warm up the sensor | set a temperature offset in the web interface |
| temperature and humidity are missing in Home Assistant | the panel has no BME688 sensor | select the temperature source: another switch or Home Assistant (Panel & LED) |
Special states of the switch
| State | Meaning | What to do |
|---|---|---|
| “Outputs are off” (E02) | the selected module does not match the connected one, the module has no supply, or it is detected but not supported by this firmware | correct the selection on the Hardware page; for a module in development wait for firmware with support |
| “module: none” in the web interface | no module selected | Hardware → select the module, or the wizard |
| LEDs flashing blue | setup mode (5 min) | connect to the SmartButton-XXXX Wi-Fi |
| the LED under the first area “breathes” white | a new switch offers touch calibration (2 min after power-up) | hold this area for 3 s, or leave it |
| three red LED flashes | a fault of severity “error” has occurred | open the web interface, the banner at the top shows the code |
| one area flashes red (E25) | the switch has turned this area off because it would switch by itself (water on the glass, missing calibration) | wipe the glass and wait half a minute; then calibrate the touch |
| only web interface and updates (E01) | safe mode after 3 crashes within 60 s of start | upload another firmware version, send the service bundle to the manufacturer |
| no network (E11) | Wi-Fi or router outage | touch keeps controlling the outputs; without Ethernet the setup Wi-Fi starts after 3 min |
8Error codes
From firmware 2.22.0 the switch reports faults and states as codes E01–E26. It evaluates the state every 2 s, for the first time 8 s after start. An error is reported when it lasts 2–4 s and disappears by itself as soon as it no longer applies. Severity: error = something does not work or is switched off for safety reasons, warning = works with limitations, information = for your information only. The codes only report; the protections of the modules work independently of them.
| Where you see the error | How |
|---|---|
| web interface | a banner at the top of every page: code, name and what to do |
| Home Assistant | entity Fault (problem yes / no) and Errors (list of codes, “OK” without errors) |
| MQTT | topic <prefix>/<id>/faults (codes and English text, “OK” without errors) |
| Modbus TCP / RTU | input registers IR 46 (E01–E16) and IR 47 (E17–E32), bit n − 1 = code En, 0 = no error |
| event log and log | a record when each code appears and disappears |
| LEDs on the panel | when an error occurs they flash red three times; warnings and information do not flash |
| Code | Severity | Meaning | Typical cause | What to do |
|---|---|---|---|---|
| E01 | error | Safe mode | the firmware crashed three times in a row within 60 s of start | Outputs and integrations are off; the network, web interface and updates run. Upload another firmware version, send the service bundle. |
| E02 | error | Power module does not match the selection | a different module selected than connected; module without supply; detected but unsupported module | The outputs did not start. Correct the selection on the Hardware page. |
| E07 | warning | The BME688 sensor stopped responding | loose flat cable to the panel, faulty sensor. A sensor that is not fitted is not an error. | Check the flat cable. An enabled thermostat keeps its output off meanwhile (E09). |
| E08 | warning | Temperature source not available (panel without sensor; 5 min after start at the earliest) | the source switch is off or has a different link key, Home Assistant has not sent the temperature for more than 5 min | Check the source switch or the automation in HA, or select another source (Panel & LED). |
| E09 | error | The thermostat has no temperature (60 s after start at the earliest) | a consequence of E07 or E08, or a thermostat without a sensor and without a temperature source | The thermostat output is off until the temperature is restored. Remove the cause. |
| E10 | warning | MQTT not connected (for more than 2 min) | wrong broker address or password, broker not running, network outage | Check the Integrations page and the broker. Local control keeps working. |
| E11 | warning | No network (for more than 2 min) | cable unplugged, wrong Wi-Fi password, router switched off | Check the cable / Wi-Fi. Local control keeps working. |
| E12 | information | Time is not set (5 min after start) | no access to NTP and after a power failure | Log in to the web interface (the time is taken from the browser), or enable NTP. |
| E13 | warning | Low free memory | many functions running at once (HTTPS, voice) | Switch off unused functions or restart. If it keeps coming back, send the service package. |
| E14 | warning | High temperature of the control board (default threshold 85 °C) | poorly ventilated wall box, high load, high LED brightness | Check ventilation and load. The threshold is in Diagnostics. |
| E15 | warning | Errors on the panel bus | flat cable, connector, interference | Check the flat cable to the front panel. |
| E17 | warning | Hardware check warning | e.g. the display touch controller was not found | Follow the text of the warning in the web interface. |
| E18 | information | The last restart was a crash or a supply voltage drop | firmware fault, weak power supply | If it happens once, nothing; the message disappears by itself an hour after start. If it repeats, send the service package. |
| E19 | warning | Touch has drifted out of tune | cover changed, humidity, dirt on the glass | Only a warning; touch keeps working. Wipe the glass and run the touch calibration. |
| E22 | warning | Automatic update failed, the version is being skipped | the new version was not confirmed after installation, or it could not be downloaded or verified 5 times | The previous version is running. Install manually, or wait for a newer version. |
| E25 | error | The touch area is switched off | uncalibrated panel, water on the glass, a hand on the panel at power-on, interference, a faulty area | Only the touch of this area is switched off (for the slider, the whole slider); its LED flashes red. The other areas, the web interface, Home Assistant and the scheduler keep working. Wipe the glass and wait about half a minute; if the error does not disappear, run the touch calibration in the web interface or with a short press of BOOT. |
The table lists the codes that concern this module and the switch as a whole. The full list is in the manual for the board BALANS CORE.
9Declaration of conformity, disposal, manufacturer
EU declaration of conformity: in preparation. We will publish the document on this page once testing is finished (safety, EMC, radio, cybersecurity to EN 18031). Until the declaration of conformity is issued, the module is not intended for sale.
The switch contains a 2.4 GHz Wi-Fi radio (band 2400–2483.5 MHz). We will add the maximum transmit power and the simplified declaration of conformity after the conformity assessment.
Disposal (WEEE): do not dispose of the product with household waste (crossed-out wheelie bin symbol). Take it to a collection point for electrical equipment or return it to the seller.
Manufacturer: Ing. Tomáš Benešl – Benešl Automation, Ludvíka Svobody 12, 747 57 Slavkov, IČO 04250435, benesl@benesl-automation.cz, +420 732 413 773.
Downloads
- PDF manual: BALANS_01d_navod.pdf
- EU declaration of conformity: in preparation (after testing)
Document version
| Version | Date | Change |
|---|---|---|
| 1.3 (draft) | 13. 11. 2026 | firmware 2.38.3: switching off a faulty or wet area (E25), slider and level bar, double and triple touch, automatic module selection, Device health, password at handover and factory reset, heating: early start; renders with the corrected marking; board rev B |
| 1.2 (draft) | 12. 11. 2026 | firmware 2.36.11: handover to the customer, settings change history, lowest-brightness wizard, Show code button, plain Wi-Fi messages |
| 1.1 (draft) | 11. 11. 2026 | firmware 2.35.0: setup wizard, touch calibration, error codes E01–E24, new mounting order and 3 × 6 screws, final renders |
| 1.0 (draft) | 9. 11. 2026 | first issue, firmware 2.10.2 |
