Inkhaus

Settings#

Open Settings by tapping the battery in the status bar, or by holding the rocker push for about half a second. Settings is a menu with four categories.

Settings overview with callouts.
Settings: four categories and the device info.

The overview also has Refresh now (fetches fresh states), Sleep now, and an info block: firmware version, battery, the Home Assistant link and last success, the Wi-Fi network, the config status and the number of config errors.

Display#

Display settings page.
Display.
RowValuesDefaultEffect
OrientationPortrait, LandscapePortraitTurns the whole screen. Applied when you leave Settings, with one full refresh.

Sleep and wake#

Sleep settings page.
Sleep and wake.
RowValuesDefaultEffect
Sleep modePower off, Deep sleep, Touch, Touch & rockerDeep sleepHow the device sleeps and what wakes it. See Sleep and battery.
Updates while asleepOff, 30 min, 1 h, 3 h, 6 h, 12 h1 hThe device wakes by itself this often, fetches states, redraws and sleeps again.
While asleepDashboard, Sleep screenDashboardWhat stays on the screen during sleep. See Sleep screen.
Keep awakeOff, On USB, AlwaysOffOn USB: never sleeps while plugged in. Always: never sleeps.
Idle timeout10 s, 20 s, 30 s, 60 s20 sHow long the device waits without a touch before it sleeps. Not used when Keep awake is Always.
Learn battery limitsOff, OnOnAfter a brownout (the battery ran out before the device expected) it raises its own low-battery limit so it sleeps earlier next time.

Below the rows, Battery use shows a bar from 1 (lowest) to 10 (highest). It changes while you change the rows, so you see what each choice costs.

A note appears when you pick a touch mode ("Touch wake shortens battery life") or when Power off cannot wake itself ("updates stay Off").

Network#

Network settings page.
Network.
RowValuesDefaultEffect
Wi-FiAuto, or the name of a profile from secrets.yamlAutoAuto uses the first known network in range. A name forces that profile only.
HA connectionAuto, Internal, ExternalAutoWhich Home Assistant address to use. Auto learns per network which one works.
Report to HAOff, OnOnOn: the device reports its battery, the room temperature and humidity and its last wake to Home Assistant, so you can see them there.

The hints under the rows show what is connected right now ("Connected: Home", "Link: internal").

Tools#

Tools settings page.
Tools.
RowValuesDefaultEffect
Demo modeOff, OnOffOn: shows a built-in demo dashboard with fake values and does not use Wi-Fi. Handy to try the device.
Debug logOff, OnOffOn: writes a log to the SD card (/debug.log, up to 1 MB). Uses more battery. Turn it on when someone asks you for the log.
Firmware(shows the version)Tap to check for a newer version. See below.
About(info only)The exact build: version, variant, code revision and date.

Updating the firmware#

The device checks for a new version about once a week and never interrupts you. When Update available shows in the Firmware row:

  1. Plug in USB, or have more than 50 % battery.
  2. Tap the Firmware row, then Check now.
  3. Answer the question with the rocker: up = yes, down = no.

What you'll see: a progress screen, then the device restarts with the new version. If the new version does not start, the old one is restored by itself.

If it doesn't work: "needs USB or 50% battery" means plug in USB. "Wi-Fi not connected" means check your Wi-Fi first. You can always install again from the install page.

Reading the Config row#

On the overview, the Config row says what the device made of config.yaml:

Config row saysMeaning
OKThe file is fine.
tabs[0].widgets[2].entity (line 34)The first mistake: tab 1, widget 3, its entity, on line 34 of the file. (The device counts from 0 in the brackets, so [0] is the first.)
no config.yaml on SDThe card is not read, or the file is in a folder, or is misnamed.
built-in demoDemo mode is on.

The Config errors row shows how many mistakes there are. Fix the first, restart the device (plug in USB, press the pinhole once; see Touch and buttons), and look at the next.

Most mistakes are a missing space, a tab character instead of spaces, or a missing quote.

Leaving Settings#

Leaving always redraws the tab screen once (a full flash). After 60 seconds without touching, Settings closes by itself and the device goes to sleep.

← Tabs and layoutSleep and battery →