Raspberry Pi

A guide to install CUBE OS on a Raspberry Pi 4B/5.

Models with smaller memory (RAM) may counter performance issues. A Raspberry Pi with at least 4GB of memory is recommended.

If you do not have a Raspberry Pi, consider the virtual machine installation.

Alternatively, purchase an iHost shipped with CUBE OS from the SONOFF website or Amazon if neither option is feasible.

1. Preparation

1

Visit this repo to download the latest image.

2

Obtain a Raspberry Pi and get it ready following the Raspberry Pi official guides if you have a kit like the enclosure and cooling fan.

3

Other Required Accessories:

1. A micro SD card (TF Card) and a card reader. Storage cards with at least a C10 and A1 rating are recommended.

2. Ethernet cable.

3. If you need to add Zigbee devices, prepare a Zigbee Dongle. Tested Zigbee Dongles include:

SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Others listed by developer @darkxst

For more information on Zigbee configurations and compatibility, please refer to this guide.

1. Power Adapter (Alternatively, if you have a Power over Ethernet (PoE) Hat installed, ensure your network switch or router, as well as the Ethernet cable, can provide sufficient power)

Ensure you have an appropriate power supply for the Raspberry Pi. Smartphone chargers may not be suitable, as some only provide full power to certain manufacturers’ phones. USB ports on computers do not supply adequate power and should not be used.

2. Burn CUBE OS to SD Card

1

Download and install the Raspberry Pi Imager from the Raspberry Pi website.

2

Open Raspberry Pi Imager and select your Raspberry Pi device.

3

For the operating system, choose “Use Custom” and select the downloaded CUBE image.

4

Insert the SD card into the computer and select it as the storage to use.

5

If you are promoted with customization options, click NO.

6

Click “Next” to write the image to the SD card. Note that the card’s contents will be overwritten.

7

Wait until the write process reaches 100% and eject the SD card upon completion.

3. Boot Raspberry Pi and Accessing CUBE:

1

Insert the Micro SD card into the Raspberry Pi (on the short side of the board near the LED).

2

Connect the Raspberry Pi to a power source and Ethernet cable, ensuring it is on the same network as your computer and connected to the internet.

3

Optional: If you have a Zigbee Dongle, plug it into a USB port.

4

After powering the Raspberry Pi, wait a few minutes for it to boot up. Then, access the Web management page using cube.local.

Or you can find the CUBE’s IP from your router’s interface and use it to access the management page. Usually, you can see the IP next to the device named cube, which also has the longest expiring time (Leasetime remaining).

5

Upon successful access, view a short ID on the settings page. Access the CUBE Web management page subsequently using cube-{short id}.local, especially useful for distinguishing multiple CUBEs on the same local network.