Enable the SK-AM62P-LP
In this document we will look at the main steps to enable the SK-AM62P-LP board. This is not always necessary since Texas Instruments (TI) might send you an already enabled board.
Download and Install CCSTUDIO
The files we need are all inside CCSTUDIO and are provided in the bundle. We are not publishing them ourselves, we are just referring to files that are publicy available frorm TI.
Open the following link: https://www.ti.com/tool/CCSTUDIO#downloads
In the Downloads section select the offline version that you are interested.
Versions
If you want a specific version click ‘View all versions’ and then look for the one you are interested in.
There is a correlation between CCSTUDIO Version and the Test Automation Interface Version that will be installed. Keep this in mind in case you notice problems with the latest versions of the firmware.
We will use CCSTUDIO 20.2.0, it was just the one we found when we wrote this document.
The file comes as a .zip which is very easy to extract.
For Linux the file we download was CCS_20.2.0.00012_linux.zip which unpacks into CCS_20.2.0.00012_linux.
In the CCS_20.2.0.00012_linux directory you can run ccs_setup_20.2.0.00012.run via terminal or just a double-click.
Follow the Wizard that will come out. In the panel with Installation Directory note the path somewhere. We will find the files we need from there.
Finish the Wizard and wait for CCSTUDIO to install on your machine.
Open a bash and cd into the Installation Directory that we noted. The file we need are all here:
$ ls <CCSTUDIO_PATH>/ccs/ccs_base/common/uscif/xds110
boot_loader.axf eZ_FetDcdcController.txt xds110reset xdsdfu
boot_loader.bin firmware_3.0.0.38.bin XDS110SupportReadMe.pdf
We are interested in the following files:
xdsdfuis the tool that will interact with XDS debugger on the TI board.firmware_3.0.0.38.binis the firmware that contains the Test Automation Interface.
Firmware File Version
firmware_3.0.0.38.bin contains Test Automation Interface - v20.1.0.3372-3372-4-g61c945ae46 . The versions in the file and the tool version do not match.
Test Automation Interface Tool
The SK-AM62P-LP is fully recoverable when the “Test Automation Interface” is enabled on the board.
The “Test Automation Interface” should be available via the XDS port.
We first need to check that it is enabled.
Checking
Once you cannot the DUT to your PC you should be able to the XDS serial:
$ ls -l /dev/serial/by-id/
total 0
lrwxrwxrwx 1 root root 13 Feb 26 10:59 usb-Texas_Instruments_XDS110__03.00.00.38__Embed_with_CMSIS-DAP_S62G0012-if03
Serial Name
The serial name contains the same version of the firmware file.
We can check if the Test Automation Interface is already enabled by connecting to the serial and see if it is responding. Here is an example:
$ sudo tio sudo tio /dev/serial/by-id/usb-Texas_Instruments_XDS110__03.00.00.38__Embed_with_CMSIS-DAP_S62G0012-if03
[11:12:55.321] tio v2.5
[11:12:55.321] Press ctrl-t q to quit
[11:12:55.322] Connected
Test Automation Interface - v20.1.0.3372-3372-4-g61c945ae46
auto reset :Warm reset DUT
auto por :Power on reset DUT
auto hold_por :Hold Power on reset DUT
auto release_por :Release Power on reset DUT
auto power <on|off> :Power on|off DUT
auto sysboot <setting> :e.g. 110000
auto boot list :List supported boot modes for device
auto dut list :List supported devices
auto set dut <DUT type> :Initialize i2c for DUT
auto scan i2c :Scan i2c bus for devices
auto probe i2c :Probe i2c bus for addr
auto ina help :Print help menu for INA interface
auto measure temperature :Read temperature sensors
auto measure power <samples(<=150)> <delay(ms)>:Measure DUT power
dfu :Put the Test Automation Interface device into DFU mode
version :Show SW version
help :Print this menu
If Test Automation Interface - vXX.X.X.XXXXX comes out, then the board should already be working with LAVA.
If no output comes out or you want to update the board, please continue reading the document.
Enabling
Assuming we have both xdsdfu and firmware_3.0.0.38.bin in the working directory. Also please disconnect tio.
$ chmod +x xdsdfu
Set the configuration on the DUT.
$ sudo ./xdsdfu -m
$ sudo ./xdsdfu -c 5 -r
Problem: “Unable to load libusb.”
Run the following:
sudo apt-get install libusb-1.0-0-dev
Problem: “Scanning USB buses for supported XDS110 devices… The requested device was not found on the bus.”
Run with sudo
Problem: Again “Scanning USB buses for supported XDS110 devices… The requested device was not found on the bus.”
The command enables the Test Automation immediately, in my case it made the JTAG interface not responsive any longer to “xdsdfu”
Solution
It is possible to change the configuration also from the Test Automation interface via the “dfu” command. Connect via tio. The Test Automation Interface does not have this issue.
sudo tio /dev/serial/by-id/usb-Texas_Instruments_XDS110__03.00.00.26__Embed_with_CMSIS-DAP_S62G0012-if00
dfu :Put the Test Automation Interface device into DFU mode
=> dfu
Configuration Options
You can list the different configuration options with:
$ sudo ./xdsdfu -c ?
Updating
Once the tool is enabled, we can update it with a new version in this way.
$ sudo ./xdsdfu -m
$ sudo ./xdsdfu -f firmware_3.0.0.38.bin -r
Once finished, please check the serial again.
$ sudo tio /dev/serial/by-id/usb-Texas_Instruments_XDS110__03.00.00.38__Embed_with_CMSIS-DAP_S62G0012-if03
[11:12:55.321] tio v2.5
[11:12:55.321] Press ctrl-t q to quit
[11:12:55.322] Connected
Test Automation Interface - v20.1.0.3372-3372-4-g61c945ae46
auto reset :Warm reset DUT
auto por :Power on reset DUT
auto hold_por :Hold Power on reset DUT
auto release_por :Release Power on reset DUT
auto power <on|off> :Power on|off DUT
auto sysboot <setting> :e.g. 110000
auto boot list :List supported boot modes for device
auto dut list :List supported devices
auto set dut <DUT type> :Initialize i2c for DUT
auto scan i2c :Scan i2c bus for devices
auto probe i2c :Probe i2c bus for addr
auto ina help :Print help menu for INA interface
auto measure temperature :Read temperature sensors
auto measure power <samples(<=150)> <delay(ms)>:Measure DUT power
dfu :Put the Test Automation Interface device into DFU mode
version :Show SW version
help :Print this menu
Your SK-AM62P-LP board should have now the Test Automation Interface enabled and can be used from LAVA.