HAOS on Sonoff iHost - darkxst/ha-operating-system GitHub Wiki
This is an unofficial port of Home Assistant Operating System (HAOS) to run on Sonoff iHost
Files you will use are:
Download the files from the Release Page
boot.img.xz- Installer image that will flash HAOS to eMMC flash. Indicator will turn blue when flash finished (approx 3-5mins)haos_ihost-11.1.img.xz- Full system image you can run from SD Card (No indicator yet)
Flash images to SD Card using Balena Etcher or Rufus (Windows)
maskROM
Permanently short contacts on internal MaskROM button to always boot from SD Card. Short for about 5s if booting the installer image. To be able to use HAOS on the iHost, you will need to activate MaskROM mode( allow to use a non standard ROM on the device).
There are two ways to install:
- Overwrite the existing eMMC flash memory with a custom ROM;
- Setting the device to booting directly from the SD card.
Today, we recommend choice number 2. Using this way, you will be able to keep original ROM. To do this, you will need to open the right panel of the device, and permanently short the two round contacts on the contacts named MaskROM:
Permanently short contacts on internal the two round contacts on the internal contacts named MaskROM:
Then, boot the device with the SD card with the haos_ihost-11.1.img.xz image from latest release.
OR
To install HAOS onto the eMMC, use the boot.img.xz file flashed to an SD card. To use this image you need to only short the contacts at startup for a few seconds. Then the boot will flash the image from the SD card to the internal memory permanently. This takes about 5mins and the LED will go blue when complete!
Debug Console
You can use the debug console after the HAOS is running.
Power your ihost from a USB port on your PC and you get a debug console on iHost host.
/dev/ttyACM0 on Linux, COMx on Windows. The default user is root and there is no password
More info related to this can be found here (Home Assistant Yellow tutorial):
Indicator support
To use the RGB indicator and the buttons you need to install the custom integration. https://github.com/darkxst/ihost_indicator
USB Updates
Copy the haos*.raucb file to USB thumbdrive, name the drive CONFIG. If you are using EXT4 formatted drive make sure the update file is owned by root.
From a terminal or ssh shell, run:
ha os import
or from a debug console:
systemctl start hassos-config
System will reboot and upgrade.
To get logs if it fails, you need debug console or ssh host shell, run:
journalctl | grep rauc
Datadisk
iHost only has 8GB internal eMMC flash, after initial install you will want to use Move data disk feature, to move data to SD card or USB drive under:
Settings -> System -> Storage
Zigbee
Check the Zigbee Guide for a step-by-step tutorial to get ZHA working.
On-board EFR32MG21 EZSP Zigbee radio
Port: /dev/ttyS4
Baud: 115200
Flow Control: software
ZHA may require updating firmware first. Use the Silabs Flasher addon with custom url. Disable ZHA while flashing.