|
| 1 | +=========================== |
| 2 | +BeagleBadge Getting Started |
| 3 | +=========================== |
| 4 | + |
| 5 | +Overview |
| 6 | +======== |
| 7 | + |
| 8 | +The BeagleBadge is a compact development platform from BeagleBoard.org powered by the TI AM62L SoC. |
| 9 | +Designed for portable and low-power applications, it features built-in Wi-Fi and Bluetooth, multiple |
| 10 | +low power modes, and an integrated fuel gauge for precise battery power monitoring. |
| 11 | + |
| 12 | +The board provides a rich interface including an e-paper connector, DSI connector, Grove expansion, |
| 13 | +seven-segment displays, and an RGB LED. Fully supported in TI sources, the BeagleBadge offers flexible |
| 14 | +boot options (OSPI, UART, SD, USB-DFU) and runs Zephyr or Linux OS with Debian or Arago distributions, |
| 15 | +making it an ideal open source solution for modern IoT and HMI projects. |
| 16 | + |
| 17 | +Supported Distributions |
| 18 | +======================= |
| 19 | + |
| 20 | +- Debian: https://github.com/TexasInstruments/armbian-build.git branch: 2025.12-beaglebadge |
| 21 | +- Arago: https://github.com/TexasInstruments/meta-tisdk branch: scarthgap |
| 22 | + |
| 23 | +Low level sources |
| 24 | +================= |
| 25 | + |
| 26 | +- TI Linux: :file:`arch/arm64/boot/dts/til3-am62l3-beaglebadge.dts` branch: ti-linux-6.12.y |
| 27 | +- TI U-boot: :file:`configs/am62lx_beaglebadge_defconfig` branch ti-u-boot-2025.01 |
| 28 | + |
| 29 | +Building for BeagleBadge |
| 30 | +======================== |
| 31 | + |
| 32 | +.. code-block:: console |
| 33 | +
|
| 34 | + $ git clone https://git.ti.com/git/arago-project/oe-layersetup.git tisdk |
| 35 | + $ cd tisdk |
| 36 | + $ ./oe-layertool-setup.sh -f configs/arago-scarthgap-config.txt |
| 37 | + $ cd build |
| 38 | + $ . conf/setenv |
| 39 | + $ export MACHINE=beaglebadge-ti |
| 40 | + $ ARAGO_SYSVINIT=1 bitbake -k tisdk-tiny-image |
| 41 | +
|
| 42 | +For more information go :ref:`here <building-the-sdk-with-yocto>` |
| 43 | + |
| 44 | +.. note:: |
| 45 | + |
| 46 | + Yocto: Due to the limited 128MB size of LPDDR on BeagleBadge, only the *tisdk-tiny-image* |
| 47 | + can boot on BeagleBadge. Switching to SystemV for init system instead of SystemD will reduce |
| 48 | + the memory footprint since more system services will be enabled by default with SystemD. |
| 49 | + |
| 50 | +Booting BeagleBadge |
| 51 | +=================== |
| 52 | + |
| 53 | +In the following instructions, assume /dev/ttyUSB0 is the serial port enumerated |
| 54 | +on host machine from BeagleBadge USB C connection. |
| 55 | + |
| 56 | +SD boot: |
| 57 | + 1. Flash SD card with Debian or Arago image |
| 58 | + 2. Insert Micro SD card |
| 59 | + 3. Press & hold Select until step 4 |
| 60 | + 4. Connect USB C cable |
| 61 | + 5. Connect to /dev/ttyUSB0 on host machine |
| 62 | + |
| 63 | +OSPI boot: |
| 64 | + 1. Boot via SD boot and stop at u-boot prompt |
| 65 | + 2. Flash OSPI |
| 66 | + |
| 67 | + .. code-block:: console |
| 68 | +
|
| 69 | + => fatload mmc 1 ${loadaddr} tiboot3.bin |
| 70 | + 221296 bytes read in 11 ms (19.2 MiB/s) |
| 71 | + => print filesize |
| 72 | + filesize=36070 |
| 73 | + => sf probe |
| 74 | + SF: Detected is25wx256 with page size 256 Bytes, erase size 4 KiB, total 32 MiB |
| 75 | + => sf erase 0 40000 |
| 76 | + SF: 262144 bytes @ 0x0 Erased: OK |
| 77 | + => sf write ${loadaddr} 0 36070 |
| 78 | + device 0 offset 0x0, size 0x36070 |
| 79 | + SF: 221296 bytes @ 0x0 Written: OK |
| 80 | + => fatload mmc 1 ${loadaddr} tispl.bin |
| 81 | + 1464080 bytes read in 62 ms (22.5 MiB/s) |
| 82 | + => print filesize |
| 83 | + filesize=165710 |
| 84 | + => sf probe |
| 85 | + SF: Detected is25wx256 with page size 256 Bytes, erase size 4 KiB, total 32 MiB |
| 86 | + => sf erase 0x80000 180000 |
| 87 | + SF: 1572864 bytes @ 0x80000 Erased: OK |
| 88 | + => sf write ${loadaddr} 0x80000 165710 |
| 89 | + device 0 offset 0x80000, size 0x165710 |
| 90 | + SF: 1464080 bytes @ 0x80000 Written: OK |
| 91 | + => fatload mmc 1 ${loadaddr} u-boot.img |
| 92 | + 1314747 bytes read in 57 ms (22 MiB/s) |
| 93 | + => print filesize |
| 94 | + filesize=140fbb |
| 95 | + => sf probe |
| 96 | + SF: Detected is25wx256 with page size 256 Bytes, erase size 4 KiB, total 32 MiB |
| 97 | + => sf erase 0x280000 180000 |
| 98 | + SF: 1572864 bytes @ 0x280000 Erased: OK |
| 99 | + => sf write ${loadaddr} 0x280000 140fbb |
| 100 | + device 0 offset 0x280000, size 0x140fbb |
| 101 | + SF: 1314747 bytes @ 0x280000 Written: OK |
| 102 | +
|
| 103 | + 3. Reset the board (S1 RST) |
| 104 | + |
| 105 | +UART boot: |
| 106 | + 1. Connect USB C cable |
| 107 | + 2. Connect to /dev/ttyUSB0 on host machine |
| 108 | + 3. Run the following instructions on host machine: |
| 109 | + |
| 110 | + .. code-block:: console |
| 111 | +
|
| 112 | + $ sb --xmodem tiboot3.bin > /dev/ttyUSB0 < /dev/ttyUSB0 |
| 113 | + $ sb --xmodem tispl.bin > /dev/ttyUSB0 < /dev/ttyUSB0 |
| 114 | + $ sb --ymodem u-boot.img > /dev/ttyUSB0 < /dev/ttyUSB0 |
| 115 | +
|
| 116 | +USB-DFU boot: |
| 117 | + 1. Press & hold Select until step 4 |
| 118 | + 2. Connect USB C cable |
| 119 | + 3. Connect to /dev/ttyUSB0 on host machine |
| 120 | + 4. Send bootloader binaries from host MACHINE |
| 121 | + |
| 122 | + .. code-block:: console |
| 123 | +
|
| 124 | + $ sudo -E -S dfu-util -R -a bootloader -D tiboot3.bin |
| 125 | + $ sudo -E -S dfu-util -R -a bootloader -D tispl.bin |
| 126 | + $ sudo -E -S dfu-util -R -a u-boot.img -D u-boot.img |
| 127 | +
|
| 128 | +Any of the above boot methods can be used to boot to u-boot prompt, |
| 129 | +from here, loading the rootfs is generic and can be loaded from SD |
| 130 | +card, OSPI flash, or USB DFU as is discussed in other sections of this |
| 131 | +documentation. |
0 commit comments