17.6.1 Command List

Table 17-4. Commands Available through the SAM-BA Monitor
Command Action Argument(s) Example
N Set Normal Mode No argument N#
T Set Terminal Mode No argument T#
O Write a byte Address, Value# O200001,CA#
o Read a byte Address,# o200001,#
H Write a half word Address, Value# H200002,CAFE#
h Read a half word Address,# h200002,#
W Write a word Address, Value# W200000,CAFEDECA#
w Read a word Address,# w200000,#
S Send a file Address,# S200000,#
R Receive a file Address, NbOfBytes# R200000,1234#
G Go Address# G200200#
V Display version No argument V#
  • 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 ‘>’