SAM-BA® ISP - Monitor Commands

Introduction

The SAM-BA® Monitor program, controlled by the SAM-BA Host application program, performs basic internal memory read, write, and execute commands. It is embedded in the ROM Boot Code of the target device (Microchip Technology ARM®-based MPU or MCU). The SAM-BA Monitor communicates with the SAM-BA Host over a serial communications link.

The SAM-BA Host to Monitor serial communications link is a dedicated serial port separate from the Target Console serial communications.

Executing Monitor Commands

SAM-BA Monitor commands can be executed from the SAM-BA Host using the -m, --monitor option.

DO NOT use the Monitor (-m, --monitor) option on the same command line with the Applet (-a, --applet) or Execute (-e, --execute) options. However, many -m, --monitor options can be passed on the same command line.

Monitor (-m, --monitor) commands depend on the selected Port (-p, --port) option. The sam-ba -p <port> -m help command will display all supported monitor commands for a given <port> connection:

$ sam-ba -p serial -m help

* read8 - read a byte
Syntax:
    read8:<addr>
Example:
    read8:0x200000  read a byte at address 0x200000

* read16 - read a half-word (16-bit)
Syntax:
    read16:<addr>
Example:
    read16:0x200000  read a half-word at address 0x200000

* read32 - read a word (32-bit)
Syntax:
    read32:<addr>
Example:
    read32:0x200000  read a word at address 0x200000

* read - read data into a file
Syntax:
    read:<filename>:<addr>:<length>
Example:
    read:test.bin:0x200000:512  read 512 bytes from address 0x200000 into file test.bin

* write8 - write a byte
Syntax:
    write8:<addr>:<value>
Example:
    write8:0x200000:0x12  write byte 0x12 at address 0x200000

* write16 - write a half-word (16-bit)
Syntax:
    write16:<addr>:<value>
Example:
    write16:0x200000:0x1234  write half-word 0x1234 at address 0x200000

* write32 - write a word (32-bit)
Syntax:
    write32:<addr>:<value>
Example:
    write32:0x200000:0x12345678  write word 0x12345678 at address 0x200000

* write - write data from a file
Syntax:
    write:<filename>:<addr>
Example:
    write:test.bin:0x200000  write data from file test.bin to address 0x200000

* execute - execute code
Syntax:
    execute:<addr>
Example:
    execute:0x200000  execute code at 0x200000
© 2024 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.