1What the module is for
The display shows the time, the temperature and a brightness arc that you control by sliding a finger. Widgets (clock, thermostat, air conditioning, air quality, lights, scenes, timers, weather and other data from Home Assistant) are selected and ordered in the web interface. As a Home Assistant Assist satellite it recognises the wake word directly in the device and sends audio only to your Home Assistant.
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 8 Ω speaker to the JST SH 2-pin connector on the back of the panel.
- Place the 84 × 84 × 3 mm cover with the opening for the display (frame for FACE Display) and push it under the 4 spring clips of the frame. The glass is snapped in away from the wall; a fitted frame could pop out of the carrier while doing so.
- 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.
The display is recessed in the cover opening and the finger touches the display directly. The gap around the display is covered by a trim ring glued on with a drop of flexible adhesive. Touch-area calibration is not performed on FACE Display.

4Technical data
| Item | Value |
|---|---|
| board | 82 × 82 mm for 84 × 84 × 2 mm glass |
| display | round AMOLED 1.43" 466 × 466 with touch (Panox TR143R2404A) |
| cover | 84 × 84 × 3 mm with an Ø 42 mm opening for the display, trim ring; dedicated frame 1 mm taller (design, awaiting a display sample) |
| audio | I²S MEMS microphone (ICS-43434), amplifier for an 8 Ω / 2 W speaker |
| backlight | ring of 12 RGB LEDs SK6812MINI-E |
| voice | Home Assistant Assist satellite, wake word detected by the panel itself |
| display languages | Czech, Slovak, English, Polish, German |
| 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 |
| power consumption | up to ~7.7 W in the worst case: with the POWER Base module (PoE 6 W) limit brightness and volume |
| 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
| Control | Function |
|---|---|
| centre of the display, short | toggles the light |
| sliding along the arc | brightness |
| centre of the display 5 s | settings window with the setup code (works even with the child lock on) |
| Timers page | countdown: +1 min, +5 min, cancel; 3 hours at most. A beep at the end (at night according to the “Do not disturb” setting) and the ring flashes for 15 s |
| Settings widget | display brightness (at least 20 %), volume, quiet at night |
| Functions widget | holiday mode, heating programme, slats by the sun (items that cannot be used are not shown) |
| wake word / long press | voice assistant (if enabled) |
| LED ring | Meaning |
|---|---|
| blue | listening |
| purple | processing |
| green | answering |
| red | error |
The voice assistant is switched off by default. It is enabled in the web interface (Panel & LED → Voice assistant: Home Assistant address and access token). Audio leaves only for your Home Assistant, and only after the wake word. The manufacturer receives no data. In the “do not disturb” night mode the wake word is off and the display is dimmed.
Display child lock (off by default, enabled in the web interface on the Display tab or with a switch in Home Assistant): pages can be browsed, but buttons do not respond and a touch shows “locked”. Holding for 3 s with a countdown unlocks the display for a minute. Voice by a long press of the centre is unavailable while locked; the wake word works. It is a convenience, not security.
With the output off, the LED ring can show air quality by colour (optional, off by default).
To prevent burn-in, the image on the AMOLED display shifts by a few pixels every 10 minutes. Set the idle display brightness low (0–5 %).
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_01c_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 |
