Setup WiFi on Home Assistant OS

This guide provides step-by-step instructions on how to configure Wi-Fi on Home Assistant OS, specifically for Raspberry Pi devices. It includes detailed terminal commands, examples of outputs, and solutions for common issues like mounting the SD card on macOS.

Step 1: Preparing the SD Card

First, download the Home Assistant OS image and write it to your SD card using software like Balena Etcher. Once the image is written, proceed with the following steps.

Step 2: Configuring Wi-Fi

After writing the image, you need to configure Wi-Fi before booting your Raspberry Pi.

1. Reconnect the SD Card to Your Computer

On macOS, the SD card may not automatically mount. If this happens, use the following command in the terminal to list and mount the partitions:

diskutil list

Look for your SD card in the list, which might look something like this:

/dev/disk5 (internal, physical):
#:                       TYPE NAME                    SIZE       IDENTIFIER
0:      GUID_partition_scheme                        *31.9 GB    disk5
1:                        EFI hassos-boot             33.6 MB    disk5s1
2:           Linux Filesystem                         25.2 MB    disk5s2
...

2. Mount the EFI Partition

If the SD card is not automatically mounted, manually mount the hassos-boot partition:

diskutil mount /dev/disk5s1

3. Create the Wi-Fi Configuration File

Now that the partition is mounted, follow these steps:

Navigate to the Mounted Partition:
```
cd /Volumes/hassos-boot
```
Create the Necessary Directories:
```
mkdir -p CONFIG/network
```
Create and Edit the Wi-Fi Configuration File:

Create and open the my-network file:
```
nano CONFIG/network/my-network
```
Add the Following Configuration:

In the my-network file, add the following configuration, making sure to replace the placeholders with your actual network details:
```
[connection]
id=<YourNetworkName>
uuid=<YourGeneratedUUID>
type=wifi

[wifi]
hidden=true
mode=infrastructure
ssid=<YourNetworkName>

[wifi-security]
auth-alg=open
key-mgmt=wpa-psk
psk=<YourNetworkPassword>

[ipv4]
method=auto

[ipv6]
addr-gen-mode=stable-privacy
method=auto
```
Important Notes:
- Replace <YourNetworkName> with the SSID of your Wi-Fi network.
- Replace <YourNetworkPassword> with the password of your Wi-Fi network.
- Replace <YourGeneratedUUID> with a unique UUID. You can generate a UUID using the uuidgen command in the terminal or by visiting an online UUID generator.
- The hidden=true line is crucial if your Wi-Fi network does not broadcast its SSID (i.e., it is a hidden network). If your network is not hidden, you can set this to false or remove the line.
Save and Exit:

After entering the details, save the file by pressing Ctrl + O, then press Enter to confirm. Exit the editor by pressing Ctrl + X.
Safely Eject the SD Card:

Once the configuration is complete, unmount the SD card safely:
```
diskutil eject /dev/disk5
```

Step 3: Boot Raspberry Pi

Insert the SD card into your Raspberry Pi and power it on. The device should automatically connect to your Wi-Fi network.

dmmeteo/setup-wifi-haos.md