isys::CCoreCtrl Class Reference

Description

This class provides debug session functions.

#include <CSessionCtrl.h>

Inherits isys::CSessionBaseCtrl.

Public Member Functions
void	observe (bool bObserve)
	Enables core observation, call is valid only within session. More...
void	memory_fill (uint8_t nMemoryArea, uint64_t nAddress, uint64_t nNumMAUs, const std::vector< uint8_t > &rvPattern)
	Fills memory with the specified pattern. More...
void	memory_write (uint8_t nMemoryArea, uint64_t nAddress, const std::vector< uint8_t > &rvData, std::vector< uint8_t > *pvAccess=nullptr)
	Writes memory. More...
std::vector< uint8_t >	memory_read (uint8_t nMemoryArea, uint64_t nAddress, uint64_t nNumMAUs, std::vector< uint8_t > *pvAccess=nullptr)
	Reads memory. More...

Member Function Documentation

memory_fill()

void isys::CCoreCtrl::memory_fill	(	uint8_t	nMemoryArea,
		uint64_t	nAddress,
		uint64_t	nNumMAUs,
		const std::vector< uint8_t > &	rvPattern
	)

Fills memory with the specified pattern.

Parameters

nMemoryArea	index of the area to be used
nAddress	the address to write to
nNumMAUs	number of addresses to write
rvPattern	the pattern to be used for fill. If it is shorter than nNumMAUs, the pattern is repeated.

Exceptions

TException

if operation fails.

Python example: test_memory_fill.py

memory_read()

std::vector< uint8_t > isys::CCoreCtrl::memory_read	(	uint8_t	nMemoryArea,
		uint64_t	nAddress,
		uint64_t	nNumMAUs,
		std::vector< uint8_t > *	pvAccess = nullptr
	)

Reads memory.

Parameters

nMemoryArea	index of the area to be used
nAddress	the address to read from
nNumMAUs	number of MAUs
pvAccess	optional parameter - access info is returned for every accessed location

Returns

the data read

Exceptions

TException

if operation fails.

Python example: test_memory_read.py

memory_write()

void isys::CCoreCtrl::memory_write	(	uint8_t	nMemoryArea,
		uint64_t	nAddress,
		const std::vector< uint8_t > &	rvData,
		std::vector< uint8_t > *	pvAccess = nullptr
	)

Writes memory.

Parameters

nMemoryArea	index of the area to be used
nAddress	the address to write to
rvData	the data to write
pvAccess	optional parameter - access info is returned for every accessed location

Exceptions

TException

if operation fails.

Python example: test_memory_write.py

observe()

void isys::CCoreCtrl::observe

(

bool

bObserve

)

Enables core observation, call is valid only within session.

Parameters

bObserve

set it to true to enable core observation, false to disable it

Exceptions

TException

if operation fails.

Python example: test_observe.py