Memory

class chipscopy.api.memory.Memory(*args, **kwargs)[source]

Provides memory read and memory write service for a device.

Examples:

some_values = device.memory_read(address=0xF2010000, num=2, target="DPC")
rpu = session.memory.filter_by(name="RPU").at(0)
some_values = rpu.memory_read(0xF2010000, 2)
dpc = device.memory.get(name="DPC")
dpc.memory_write(0xF2010000, [0x12345678, 0xDEADC0FE])
property filter_by

Specifies the dict used for filtering memory objects in the device and session. Filters memory in the QueryList returned by Session.memory and Device.memory.

Returns

dict[str,value]

post_init()[source]

Called at the end of node upgrade

static check_and_upgrade(memory_view, node)[source]

Converts a client MemoryNode to Memory

Return type

Memory

static is_compatible(node)[source]

True if Memory is a compatible node type

Return type

bool

memory_write(address, values, size='w')[source]

Write values from list of <values> to memory address specified by <address>.

size defaults to ‘w’ if not specified.

size <access-size> can be one of the values below:
b = Bytes accesses
h = Half-word accesses
w = Word accesses (default)
d = Double-word accesses
Parameters
  • address (int) – Address for memory write

  • values (List[int]) – List of integer values to write

  • size (str) – ‘b’,’h’,’w’,’d’

memory_read(address, num=1, size='w')[source]

Read and return <num> data values from the target’s memory address specified by <address>.

num defaults to 1 if not specified. size defaults to ‘w’ if not specified.

size <access-size> can be one of the values below:
b = Bytes accesses
h = Half-word accesses
w = Word accesses (default)
d = Double-word accesses
Parameters
  • address (int) – Address for memory write

  • num (int) – number of values to read

  • size (str) – ‘b’,’h’,’w’,’d’

Return type

List[int]