Orange Pi R2S Provisioning Guide¶

Step-by-Step Device Setup¶

This guide walks you through the complete process of setting up an Orange Pi R2S device for EmiliaVision. The process takes approximately 20 minutes total.

Target audience: Field operators and technicians. No terminal or programming knowledge required.

Overview¶

Prerequisites¶

Before you begin, make sure you have:

• Orange Pi R2S device (new or factory-reset)
• USB flash drive (4GB minimum — all data will be erased)
• Ethernet cable connected to a router with internet access
• USB-C power adapter (5V / 3A minimum)
• Computer (Windows, macOS, or Linux) to flash the USB
• Provisioning image file: orangepi-provision-exp-YYYY-MM-DD.img.xz

Step 1: Download and Install Balena Etcher¶

Balena Etcher is a free tool used to flash the provisioning image onto a USB drive.

1. Go to https://etcher.balena.io/
2. Download the version for your operating system (Windows, macOS, or Linux)
3. Install the application

Step 2: Flash the Provisioning Image to USB¶

1. Insert the USB flash drive into your computer
2. Open Balena Etcher
3. Click "Flash from file"

1. Select the provisioning image file (orangepi-provision-exp-YYYY-MM-DD.img.xz)

1. Click "Select target" and choose your USB drive

1. Click "Flash!" to start writing the image

1. Wait for flashing and validation to complete (approximately 3-5 minutes)

1. When finished, you will see "Flash Completed!"

1. Close Balena Etcher and safely eject the USB drive from your computer

Step 3: Connect the Orange Pi R2S¶

Now it is time to set up the hardware. Follow these connections in this exact order:

3.1: Insert the USB drive¶

Insert the flashed USB drive into the blue USB 3.0 port on the Orange Pi R2S.

3.2: Connect the Ethernet cable¶

Plug an Ethernet cable into the Gigabit Ethernet port (the port closer to the USB-C power connector). The other end must connect to a router or switch with internet access.

3.3: Connect the power cable¶

Plug the USB-C power adapter into the USB-C port on the Orange Pi R2S. The device will automatically power on and begin the provisioning process.

Step 4: Wait for Provisioning to Complete¶

Once powered on, the device runs the provisioning process automatically. Do not disconnect anything during this time. The entire process takes approximately 11 minutes.

Phase 1: Booting (~4 min)¶

The device boots from the USB drive. You will see:

• Red LED (power) — solid
• 1 green LED on the Ethernet port — network link active

Phase 2: Flashing eMMC + Provisioning (~3 min)¶

The device is writing the OS image to internal storage and configuring itself. You will see:

• Red LED (power) — solid
• Green LED on the board — storage activity
• 2 Ethernet LEDs (green + amber) — network traffic

Phase 3: Done — Device Powers Off (~4 min)¶

When provisioning completes, the device automatically powers itself off. All LEDs turn off.

Step 5: Remove USB and Reconnect Power¶

Once the device has powered off (all LEDs off):

1. Remove the USB flash drive from the Orange Pi R2S
2. Reconnect the power (unplug and re-plug the USB-C cable)

The device will now boot from its internal storage (eMMC) with the EmiliaVision configuration.

Step 6: Verify the Device¶

After reconnecting power, the device will:

1. Boot from internal storage (~1 minute)
2. Connect to the internet via Ethernet
3. Register with the EmiliaVision network (~2 minutes)

The EmiliaVision team can verify that the device appeared in the admin console. If you need to confirm yourself, contact the team at team@emiliavision.com with:

• Location: The restaurant name and address where the device is installed
• Time: When you completed the provisioning

Provisioning Multiple Devices¶

The same USB flash drive can be used to provision multiple Orange Pi R2S devices, one at a time. Each device gets a unique identity based on its hardware address.

To provision another device:

1. Insert the same USB into the next Orange Pi R2S
2. Connect Ethernet and power
3. Wait for automatic power off (~8 min)
4. Remove USB, reconnect power
5. Repeat

Troubleshooting¶

Device does not power off after 20 minutes¶

Device powers off immediately (less than 1 minute)¶

Device boots but does not appear in the admin console¶

Connection Diagram¶

                    ┌──────────────┐
                    │   Internet   │
                    └──────┬───────┘
                           │
                    ┌──────┴───────┐
                    │    Router    │
                    └──────┬───────┘
                           │ Ethernet
                    ┌──────┴───────┐
  USB Drive ───────►│ Orange Pi R2S│◄─────── USB-C 5V/3A
  (blue port)       │              │         (power)
                    └──────────────┘

For technical support, contact the EmiliaVision team at team@emiliavision.com.