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: sam9x60, sam9xx5, sama5d2, sama5d3, sama5d4, samv71

    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, samv71-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:

    Supported Devices

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


    Copyright © 2018 Microchip Technology
    SAM-BA Documentation