16.6.1 Command List

Table 16-6. Commands Available through the SAM-BA Monitor
CommandActionArgument(s)Example
NSet Normal ModeNo argumentN#
TSet Terminal ModeNo argumentT#
OWrite a byteAddress, Value#O200001,CA#
oRead a byteAddress,#o200001,#
HWrite a half wordAddress, Value#H200002,CAFE#
hRead a half wordAddress,#h200002,#
WWrite a wordAddress, Value#W200000,CAFEDECA#
wRead a wordAddress,#w200000,#
SSend a fileAddress,#S200000,#
RReceive a fileAddress, NbOfBytes#R200000,1234#
GGoAddress#G200200#
VDisplay versionNo argumentV#
  • Mode commands:
    • Normal mode configures SAM-BA Monitor to send / receive data in binary format,
    • Terminal mode configures SAM-BA Monitor to send / receive data in ASCII format.
  • Write commands: Writes a byte (O), a halfword (H) or a word (W) to the target
    • Address: Address in hexadecimal
    • Value: Byte, halfword or word to write in hexadecimal
    • Output: ‘>’
  • Read commands: Reads a byte (o), a halfword (h) or a word (w) from the target
    • Address: Address in hexadecimal
    • Output: The byte, halfword or word read in hexadecimal followed by ‘>’
  • Send a file (S): Sends a file to a specified address
    • Address: Address in hexadecimal
    • Output: ‘>’
      Note: There is a timeout on this command which is reached when the prompt ‘>’ appears before the end of the command execution.
  • Receive a file (R): Receives data into a file from a specified address
    • Address: Address in hexadecimal
    • NbOfBytes: Number of bytes in hexadecimal to receive
    • Output: ‘>’
  • Go (G): Jumps to a specified address and executes the code
    • Address: Address to jump to in hexadecimal
    • Output: ‘>’ once returned from the program execution. If the executed program does not handle the link register at its entry and does not return, the prompt is not displayed.
  • Get Version (V): Returns the Boot Program version
    • Output: version, date and time of ROM code followed by ‘>’