AM275 FreeRTOS SDK  10.01.00
•All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
EVM Setup

Table of Contents

AM275-EVM

Note
Refer to EVM page for more details on the EVM, TBD

Cable Connections

The figure below shows some important cable connections, ports and switches.

  • Take note of the location of the "BOOTMODE" switch, this is used to switch between different boot modes like OSPI, UART, eMMC, SD, NOBOOT mode
Attention
Dip Switch (SW9) - MMC0_SEL needs to be selected to switch the interface between eMMC and SD
MMC0_SELECT Interface
OFF eMMC
ON SD
This switch also needs to selected alongside bootmedia switch to select the bootmedia between SD & eMMC

AM275-EVM

Setup UART Terminal

Attention
Both JTAG and UART0 is enumerated to same USB port - J17
UART2, UART3 and WKUP_UART0 is available from USB port - J22
  • Many examples use a standard UART terminal to log the output from the examples. You can use any UART terminal program for the same. Below steps show how to setup the UART terminal from CCS.
  • First identify the UART port as enumerated on the host machine.
    • Make sure that the EVM and UART cable connected as shown in Cable Connections
    • In windows, you can use the "Device Manager" to see the detected UART ports
      • Search "Device Manager" in Windows Search Box in the Windows taskbar.
    • If dont see any USB serial ports listed in "Device Manager" under "Ports (COM & LPT)", then make sure you have installed the UART to USB driver from FTDI, https://www.ftdichip.com/FTDrivers.htm.

Identify UART Port in Windows Device Manager
  • In CCS, goto "View > Terminal"

UART Terminal Menu
  • Open a new UART terminal

Open New UART Terminal
  • Select the UART port, keep other options to default, i.e 115200 baud rate - 8 data bits - No parity - 1 stop bit,
    • We use the 1st USB serial port, as seen in the device manager, for below in the SDK
      • Flashing application via UART
      • Booting application via UART
      • Uboot and Linux terminal
    • We use the 3rd USB serial port, as seen in the device manager, as terminal output for examples which run from DM R5F (WKUP R5F)
    • We use the 4th USB serial port, as seen in the device manager, as terminal output for examples which run from MCU R5F

Connect to UART port
  • In this screenshot this happens to be COM27 and COM30. However on your machine this could be different. One tip to make sure there is no mistake in identifying the UART port is to disconnect all other UART to USB devices other than this EVM before checking in device manager.

Flash SOC Initialization Binary

Attention
This is a recommended one time step that needs to be done before you can load and run programs via CCS
This step needs to be done once unless the OSPI flash has been erased or some other application has been flashed
These steps are not applicable for HS-SE devices as JTAG can not be connected to HS-SE devices by default. Follow the steps in Flash an example application for flashing the HS-SE device.
  • A quick recap of steps done so far that are needed for the flashing to work
    • Make sure the UART port used for terminal is identified as mentioned in Setup UART Terminal
    • Make sure python3 is installed as mentioned in Python3
    • Make sure you have the EVM power cable and UART cable connected as shown in Cable Connections
  • Build all the binaries from the mcu_plus_sdk installation path.
    • For Linux 
        make -sj4 all
    • For Windows 
        gmake -sj4 all
  • POWER-OFF the EVM
  • Set boot mode to UART BOOTMODE as shown in below image

UART BOOT MODE
  • Switch the MMC0_SELECT switch(SW9) to OFF position

MMC INTERFACE SELECT
  • POWER-ON the EVM
  • You should see character "C" getting printed on the UART terminal every 2-3 seconds as shown below

UART output in UART BOOT MODE
  • Close the UART terminal as shown below. This is important, else the UART script in next step wont be able to connect to the UART port.

Close UART terminal
Note
For HS-FS device, use sbl_null_hs_fs.cfg as the cfg file.
  • Open a command prompt and run the below command to flash the SOC initialization binary to the EVM. 
      cd ${SDK_INSTALL_PATH}/tools/boot
  python uart_uniflash.py -p COM<x> --cfg=sbl_prebuilt/am275x-evm/sbl_null_hs_fs.cfg
    • Here COM<x> is the port name of the identified UART port in Windows.
    • On Linux,
      • The name for UART port is typically something like /dev/ttyACM0
      • On some Linux systems, one needs to use python3 to invoke python3.x, just python command may invoke python 2.x which will not work with the flashing script.
  • When the flashing is in progress you will see something like below

Flash in progress
  • After all the flashing is done, you will see something like below

Flashing successful
  • If flashing has failed, see Flash tool error messages and solutions, and resolve the errors.
  • If flashing is successful, do the next steps ...
  • POWER-OFF the EVM
  • Switch the EVM boot mode to OSPI NOR mode as shown below,

OSPI NOR BOOT MODE
  • Re-connect the UART terminal in CCS window as shown in Setup UART Terminal
  • POWER-ON the EVM
  • You should see output like below on the UART terminal 
      Sciserver Testapp Built On: Nov  6 2024 13:17:23
  Sciserver Version: v2023.11.0.0REL.MCUSDK.MM.NN.PP.bb
  RM_PM_HAL Version: vMM.NN.PP
  Starting Sciserver..... PASSED

  Starting NULL Bootloader ...

  SYSFW Firmware Version 10.0.8--w2024.02-am275x (Fiery
  SYSFW Firmware revision 0xa
  SYSFW ABI revision 4.0

  [BOOTLOADER_PROFILE] Boot Media       : undefined
  [BOOTLOADER_PROFILE] Boot Image Size  : 0 KB
  [BOOTLOADER_PROFILE] Cores present    :
  [BOOTLOADER PROFILE] Sciclient Get Version            :      13224us
  [BOOTLOADER_PROFILE] SBL Total Time Taken             :      13224us
  • Congratulations now the EVM is setup for loading and running from CCS !!!
  • You dont need to do these steps again unless you have flashed some other binary to the flash.
  • Now you can build a example of interest (see Build a Hello World example) and then run it (see CCS Launch, Load and Run)
Attention
If SBL NULL is used for development, GEL files aren't required for R5FSS

BOOT MODE

MMC INTERFACE

Select the MMC interface between eMMC and SD using switch MMC0_SELECT (SW9). This selection also required with bootmedia switch to select the bootmedia between eMMC and SD

MMC0_SELECT Interface
OFF eMMC
ON SD

MMC INTERFACE SELECT

UART BOOT MODE

This mode is used to flash files to the board flash via UART. It can also be used to boot applications via UART.

BOOTMODE [ 8 : 15 ] (SW1) = 0000 0000
BOOTMODE [ 0 : 7 ] (SW2) = 1101 1100

UART BOOT MODE

OSPI NOR BOOT MODE

This mode is used to boot flashed applications via EVM flash like OSPI NOR flash

BOOTMODE [ 8 : 15 ] (SW1) = 0100 0000
BOOTMODE [ 0 : 7 ] (SW2) = 1100 1110

OSPI BOOT MODE

SD BOOT MODE

This mode is used to boot applications via SD card on the EVM.

BOOTMODE [ 8 : 15 ] (SW1) = 0100 0000
BOOTMODE [ 0 : 7 ] (SW2) = 1100 0010

SD BOOT MODE

NOBOOT MODE

BOOTMODE [ 8 : 15 ] (SW1) = 0000 0000
BOOTMODE [ 0 : 7 ] (SW2) = 1101 1111

NO BOOT MODE

EMMC BOOT MODE

This mode is used to boot applications via eMMC on the EVM.

BOOTMODE [ 8 : 15 ] (SW1) = 0000 0000
BOOTMODE [ 0 : 7 ] (SW2) = 1101 0011

EMMC BOOT MODE

Troubleshooting EVM issues

  • JTAG connection fails on some EVMs with the following error. Need to connect the JTAG cable after board is powered on.

JTAG Connection Error Dialog