Memory

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

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])

static check_and_upgrade(memory_view, node)

Converts a client MemoryNode to Memory

Return type

Memory

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]

static is_compatible(node)

True if Memory is a compatible node type

Return type

bool

memory_read(address, num=1, size='w')

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]

memory_write(address, values, size='w')

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’

post_init()

Called at the end of node upgrade