# 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](https://www.ti.com/tool/CCSTUDIO#downloads)
In the Downloads section select the offline version that you are interested.
```{admonition} Versions
:class: note
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:
```shell
$ ls /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:
* `xdsdfu` is the tool that will interact with XDS debugger on the TI board.
* `firmware_3.0.0.38.bin` is the firmware that contains the Test Automation Interface.
```{admonition} Firmware File Version
:class: warning
`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.
{align=center}
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:
```shell
$ 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
```
```{admonition} Serial Name
:class: note
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:
```shell
$ 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 :Power on|off DUT
auto sysboot :e.g. 110000
auto boot list :List supported boot modes for device
auto dut list :List supported devices
auto set dut :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 :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`.
```shell
$ chmod +x xdsdfu
```
Set the configuration on the DUT.
```shell
$ sudo ./xdsdfu -m
$ sudo ./xdsdfu -c 5 -r
```
```{admonition} Problem: "Unable to load libusb."
:class: warning
Run the following:
sudo apt-get install libusb-1.0-0-dev
```
```{admonition} Problem: "Scanning USB buses for supported XDS110 devices... The requested device was not found on the bus."
:class: warning
Run with sudo
```
```{admonition} Problem: Again "Scanning USB buses for supported XDS110 devices... The requested device was not found on the bus."
:class: warning
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.
```shell
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
```
```{admonition} Configuration Options
:class: note
You can list the different configuration options with:
```shell
$ sudo ./xdsdfu -c ?
```
### Updating
Once the tool is enabled, we can update it with a new version in this way.
```shell
$ sudo ./xdsdfu -m
$ sudo ./xdsdfu -f firmware_3.0.0.38.bin -r
```
Once finished, please check the serial again.
```shell
$ 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 :Power on|off DUT
auto sysboot :e.g. 110000
auto boot list :List supported boot modes for device
auto dut list :List supported devices
auto set dut :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 :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.