Home ·

- Selecting the target device/board

# Selecting the target device/board

## The "-d, --device" option

The "-d, --device" should be passed to the command line unless either the "-b, --board" option or "-x, -execute" option is provided.

The list of the supported devices can be displayed with the following command:

    $ sam-ba -p serial -d help
    Known devices: pic32cxmt, sam9x60, sam9xx5, sama5d2, sama5d3, sama5d4, sama7g5

## The "-b, --board" option

The "-b, --board" option can be substituted to the "-d, --device" option. More precisely, a board extends a device with default configuration and settings such as the console instance/ioset for applets to print traces or memory controllers instance/ioset to be used to drive and program the external NVM.

The list of the supported boards can be displayed wit the following command:

    $ sam-ba -p serial -b help
    Known boards: sam9x60-ek, sam9xx5-ek, sama5d2-ptc-ek, sama5d2-xplained, sama5d27-som1, sama5d27-som1-ek, sama5d3-ek, sama5d3-xplained, sama5d4-ek, sama5d4-xplained, same70-xplained

## Selecting the applet console

Two optional parameters can be provided on the command line after either the "-d, --device" or "-b, --board" options: the console instance and ioset. They override the default settings and tell any applet which DBGU/UART/USART/FLEXCOM_USART device and which I/O pins to be used for console outputs. When the "-d, --device" option is used, by default, console outputs are disabled.

    sam-ba -p <port> -d <device>:help

    $ sam-ba -p serial -d sama5d2:help
    Syntax: sama5d2:[<instance>]:[<ioset>]
    Parameters:
        instance   Serial console peripheral number
        ioset      Serial console I/O set
    Examples:
        sama5d2       use default device/board settings
        sama5d2:1:2   use fully custom settings (peripheral number 1, I/O set 2)
        sama5d2::2    use default device/board settings but force use of I/O set 2
    Note:
        Peripheral numbers and I/O sets are device specific. Please see device documentation in 'doc' directory.

Supported console {<instance>, <ioset>} pairs are device specific; please refer to the Serial Console Configuration section of the device configuration:

- SAM9xx5 Serial Console Configuration
- SAM9X60 Serial Console Configuration
- SAMA5D2 Serial Console Configuration
- SAMA5D3 Serial Console Configuration
- SAMA5D4 Serial Console Configuration
- SAMA7G5 Serial Console Configuration
- SAM9X7 Serial Console Configuration

## Supported Devices

The sam-ba program supports the following Microchip SAM devices:

- Getting started with SAM-BA on PIC32CXMT
- Getting started with SAM-BA on SAM9X60
- Getting started with SAM-BA on SAM9XX5
- Getting started with SAM-BA on SAMA5D2
- Getting started with SAM-BA on SAMA5D3
- Getting started with SAM-BA on SAMA5D4
- Getting started with SAM-BA on SAMA7G5
- Getting started with SAM-BA on SAM9X7