Used to enable polling of locations in memory on an ARM-based target device. Up to 200 locations can be added to the sampling service, but performance will of course degrade as more locations are added.
The command will return a handle, which should be used when disabling the polling function afterwards.
| Field | Size | Description |
|---|---|---|
| DATA_SAMPLER | 1 byte | 0x8A |
| SAM_DATA_ENABLE | 1 byte | 0x01 |
| START_ADDRESS | 4 byte |
Start address to poll, MSB first. Must be >=0x20000000 |
| LENGTH | 4 byte |
Number of bytes to poll, MSB first. Limited by internal EDBG-DGI buffer size. See error codes section below. |
| FLAGS | 4 byte |
Bits 1:0: destination:
|
Response:
| Field | Size | Description |
|---|---|---|
| DATA_SAMPLER | 1 byte | 0x8A |
| SAM_DATA_ENABLE | 1 byte | 0x01 |
| Status | 1 byte |
Status code 0x00: OK 0xFF: Error |
| Handle/error code | 1 byte |
Sampler handle is returned if Status is OK. Error code is returned if Status is Error. |
Error codes:
| Error code | Value | Description |
|---|---|---|
| ERROR_FULL | 0x92 | Too many poll locations are enabled |
| ERROR_SIZE_EXCEEDED | 0x94 |
Buffer memory is full. Total buffer memory is 8MB for the Power Debugger and 64kB for all other EDBG-based tools supported. |
| ERROR_OUT_OF_RANGE | 0x91 | The poll location specified is not allowed |