​
Selecting the OS

This section explains how to do an initial setup, for an off-the-shelf BeagleBone Black. To get started, the following things are needed.
  1. BeagleBoneBlack development kit.
  2. An SD Card (of size 64GB).
  3. An adapter for power supply (with at least 15W of power)
  4. ByteBeam BeagleBoneBlack image
ByteBeam BeagleBone image can be downloaded from this link. Install the balena etcher software by following the instructions in this link. Once the installation is done, plug in the SD card into the system and launch balena-etcher software. Follow these steps to flash the Bytebeam BeagleBone image to the SD Card. Select the Flash from file option in balena-ecther Select Bytebeam BeagleBone image Select the appropriate SD Card and flash the image.

​
Partition Schema

The SD Card is now setup to contain 4 partitions.
  1. Partition 1 - Boot partition (/dev/mmcblk0p1)
  2. Partition 2 - Root partition 1  (/dev/mmcblk0p2)
  3. Partition 3 - Root partition 2 (/dev/mmcblk0p3)
  4. Partition 4 - download partition (/dev/mmcblk0p4)
At any given point in time either “Partition 2” or “Partition 3” will be the active rootfs partition, and the other partition is referred to as the inactive partition. The download partition is where the persistent files are stored. During kernel & rootfs updates, the contents of inactive partitions are replaced with the new rootfs.

​
Booting BeagleBone

Once the flashing is complete, insert the SD card into the BeagleBone. Push and hold the boot button(S2) on the BeagleBone dev. kit and power on the board. This ensures that the device boots from the SD Card and not from the onboard eMMC. Refer to this link for a detailed description of this process. In order to flash the eMMC with the contents of the SD card: Step 1: Uncomment the following line from uEnv.txt in the boot partition. 
cmdline=init=/opt/scripts/tools/eMMC/init-eMMC-flasher-v3.sh
Step 2: Push and hold the boot button(S2) on the BeagleBone dev. kit and power on the board. This process generally 30 to 40 minutes. This “Getting Started” guide talks about different ways of accessing the BeagleBone from the Laptop/PC. It is also possible to access the BeagleBone via UART. Refer to this link for details on connecting BeagleBone to the system via UART.

​
Download the one-time setup scripts

Once the BeagleBone is up, run the below one-time setup script. This script installs Bytebeam’s Linux agent uplink as well as scripts required for over-the-air updates 
curl  --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/bytebeamio/uplink/main/scripts//one_time_setup.sh | bash