Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Download EdgeDevice image with preinstalled software (for RPi4) - OpenHorizon_SmartAg_EdgeDevice_RPi4.img (8.1G)

  2. Download EdgeServer image with preinstalled software (for EdgeServer running in Virtual Box)OpenHorizon_SmartAg_EdgeServer.ova (5.8G)

  3. Insert SD card in your host

  4. Open Raspberry Pi Imager
    Select custom image - use OpenHorizon_SmartAg_EdgeDevice_RPi4.img
    Select target drive newly inserted SD card

  5. Configure Raspberry Board
    Press CTRL+SHIFT+X 
    - enable SSH
    - configure wifi SSID network name and password
    - setup locale and time
    - select "Skip first-run wizard"
    - SAVE and WRITE new image
    (proceed with other steps while the OS image is burning)

  6. Connect HDT22
    - use middle data wire, VCC, and GND as shown below

  7. Open and run Virtual Box image OpenHorizon_SmartAg_EdgeServer.ova

    Make sure you selected "Bridged Adapter", this is required to get a separate IP address for Edge Server running in Virtual Box.
    Image Added

  8. Wait for the Raspberry Pi image written on SD card, insert SD card into a raspberry board and connect the power cable to start the board.
    Raspberry should connect to Wifi on start, as configured in step 5.

  9. Login into Edge Device (RPi4 board), check if it is up and running.
    - [from Development Workstation] check IP address by running sudo nmap -sn | awk '/^Nmap/{ip=$NF}/DC:A6:32/{print ip}'
    - [from Development Workstation] connect via ssh to the RPi4 board (password is openhorizon):
       ssh pi@<IP address from the previous command>
    - [from ssh session to Edge Device] change the default password by running passwd

  10. Login to Edge Server it should be running after step 7
    - [from Virtual Box console] with the user: user and password: user
    - [from Virtual Box console] make sure you changed the default password on the first login with passwd

  11. Configure IP addresses for Edge Server and Edge Device

    IMPORTANT: It is recommended to use for your Edge Server and for Edge Device to avoid any further configuration
    To check IP addresses for Edge Server [from Development Workstation] run ifconfig | grep 192 command.

    Use command ip route | awk '/default/ { print $3 }' to get IP address of default router.
    To configure your IP address for Edge Server (mgmthub) and Edge Device RPi4 (oh) open your wifi router settings in the browser by IP address of the default router.

    Set static IP addresses for mgmthub (Edge Server) to and oh (Edge Device) to
  12. Connect the power cable to the Edge Device RPi4 (oh) board