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