Setup Your Home Assistant¶
This step is about enabling the I2C interface to start the Pironman OLED.
Open File Explorer and access the SD card named
Create a new folder named
CONFIG in the root partition.
CONFIG folder, create a folder named
Enable file extension display.
Create a text file inside the
modules folder and rename it to
rpi-i2c.conf . You will be prompted to confirm the extension change, select “Yes”.
rpi-i2c.conf with Notepad and add the following content:
Save and close the file.
This step involves configuring the RGB LED.
Open the file named
config.txt in the
Add the following content at the bottom:
Due to the usage of GPIO12 by WS2812, which is also employed for audio output, it’s necessary to disable the audio by adding the following command to the
Save and close the file.
Next, we will configure WiFi for Pironman.
If you intend to use a wired connection for network access, you can skip this step.
Create a folder named
network inside the
network folder, create a new text file named
my-network (without extension).
my-network file, write the following text, replacing
MY_WLAN_SECRET_KEY with your own network’s SSID and password:
# Uncomment below if your SSID is not broadcasted
Save and exit the file.
Remove the microSD card from your computer and insert it into the Raspberry Pi. Then, connect the power (and Ethernet cable if needed).
Go back to your computer and navigate to
or if that doesn’t work, you can find the IP address by checking your router.
During the first use of Home Assistant, you may need to wait for some time as it performs initial setup.
Next, you will be prompted to create the first account.
The system will prompt you to install some detected devices, but for now, you can skip this by clicking FINISH.
Now we will install the Pironman addon for Home Assistant.
Please click the button below to quickly add it. Then proceed to step7 .
Alternatively, follow the steps below to install manually:
In Home Assistant, navigate to Settings -> Addons.
Click the “Addon Store” button in the lower right corner.
Click the menu button in the top right corner and select “Repositories”.
Type the repository URL:
https://github.com/sunfounder/home-assistant-addon, and click Add. After adding the SunFounder repository, close the popup window.
Click the menu button again, and click “Check for updates”.
After a few seconds, the Pironman addon will appear at the end of the addon store. If not, try refreshing the page.
Enter the Pironman addon and click Install. This process may take a few minutes.
Currently, you need to disable protection mode to allow the addon to access hardware information. Find “Protection Mode” and turn it off. Then, start (or restart) the addon.
At this point, you should see the Pironman’s lighting effect and the OLED display light up. This indicates that the configuration is complete.
If your OLED or RGB strip fails to start properly, please go to the “Log” page.
[DEBUG] oled init failed:
[Errno 2] No such file or directory
Cannot open /dev/spidev0.0. spi_bcm2835 module not loaded?
[DEBUG] rgb_strip init failed:
ws2811_init failed with code -13 (Unable to initialize SPI)
If you see the above logs, it means the configuration was not successful. Please follow the steps below:
First, shut down Home Assistant.
If you force power off, it may damage HassOS. Follow the shutdown steps below:
Then, wait for one minute before unplugging the power.
Repeat Step 1 and Step 2 of this section (Setup Your Home Assistant) .
Insert the SD card back into Pironman, connect the power, and wait for a minute or two. Then, in your browser, navigate to
http://homeassistant.local:8123/. Click on START in the Pironman Addon.
Wait for a moment, and you should see the Pironman (RGB strip & OLED) light up.
You can customize the Pironman effects on the Configuration page.
Here, you can modify:
The temperature display unit on the OLED.
The duration of the OLED screen brightness.
The temperature at which the fan will start working.
The color and blinking mode of the RGB strip.
After making the desired changes, click “SAVE” to apply the settings.