Description

FNet DIO pattern operation.

#include <CFNetCtrl.h>

Inheritance diagram for isys::COptionFNetDIOPatternOp:

Public Member Functions
SPOptionController	add ()
	Adds an element to the array and returns COptionController for it. More...

SPOptionController	at (size_t nIndex)
	Return COptionController for element at nIndex. More...

void	clear ()
	Removes all elements. More...

	COptionController (isys::ConnectionMgrSPtr connectionMgr, const std::string &rstrBaseURL)
	Instantiates object. More...

SPOptionController	find (const std::string &rstrOption, const std::string &rstrValue, bool bAllowEmptyForSingleElement=false)
	Returns COptionController for the element whose rstrOption has value rstrValue. More...

std::string	get (const std::string &rstrOption)
	Returns string value of rstrOption. More...

bool	get_bool (const std::string &rstrOption)
	Gets bool value of rstrOption. More...

int64_t	get_int (const std::string &rstrOption)
	Gets integer value of rstrOption. More...

uint64_t	get_uint (const std::string &rstrOption)
	Gets unsigned integer value of rstrOption. More...

int	index_of (const std::string &rstrOption, const std::string &rstrValue)
	Returns index of element whose element rstrOption has value rstrValue, or -1 if element is not found. More...

SPOptionController	opt (const std::string &rstrOption)
	Returns COptionController based on rstrOption (appended to the base URL). More...

void	remove (size_t nIndex)
	Removes element at nIndex. More...

void	set (const std::string &rstrOption, const std::string &rstrValue)
	Sets rstrValue to rstrOption (appended to the base URL). More...

void	set_bool (const std::string &rstrOption, bool bValue)
	Sets bValue to rstrOption. More...

void	set_channels (const iconnect::IntVector &rvChannels)
	Sets channels which are participate in this pattern. More...

void	set_int (const std::string &rstrOption, int64_t iValue)
	Sets iValue to rstrOption. More...

void	set_multi (const iconnect::StrStrMap &inParams)
	Sets multiple option values with one call. More...

void	set_operation (const EOperation eOperation)
	Set operation mode. More...

void	set_pattern (const std::string &rstrPattern)
	Set DIO pattern, a sequence of frames, separated by ';'.Each frame consists of state(binary)and duration(default us), separated by ','. More...

void	set_start (const uint8_t nFTrig, const bool bStartActive)
	Specifies FTrigger event to start on and initial state. More...

void	set_stop (const uint8_t nFTrig, const bool bStopImmediately)
	Specifies FTrigger event to stop on and whether to terminate the current run immediately. More...

void	set_uint (const std::string &rstrOption, uint64_t nValue)
	Sets nValue to rstrOption. More...

size_t	size ()
	Returns array size of this instance. More...

std::string	URL ()
	Returns full option URL of this instance. More...

Protected Member Functions
std::string	get_option_URL (std::string strBase, std::string_view strvOption) const
	Possible parameters if we want the return string to be for example "/IDE/Info.VerMajor". More...

std::string	get_option_URL (std::string_view strvOption) const
	See `COptionController::get_option_URL(std::string, std::string_view) const` examples for getting the right URL.

Static Protected Member Functions
static std::string	format_index (size_t nIndex)
	returns "[<index dec>]"

Member Function Documentation

◆ add()

SPOptionController isys::COptionController::add ( )

inherited

Adds an element to the array and returns COptionController for it.

Returns: COptionController instance

Exceptions

TException if this is not an array, or the array size is static

Python example: test_add_remove.py

◆ at()

SPOptionController isys::COptionController::at ( size_t nIndex )

inherited

Return COptionController for element at nIndex.

Parameters

nIndex element index

Returns: COptionController for element at index

Python example: test_at.py

◆ clear()

void isys::COptionController::clear ( )

inherited

Removes all elements.

Exceptions

TException if this is not an array, the array size is static

Python example: test_add_remove.py

◆ COptionController()

isys::COptionController::COptionController	(	isys::ConnectionMgrSPtr	connectionMgr,
		const std::string &	rstrBaseURL
	)

Instantiates object.

Parameters

connectionMgr	class which maintains connection to winIDEA. Connection must be established before this call.
rstrBaseURL	configuration node URL, for example /IDE/Debug.DownloadFiles In winIDEA see Help->Display Option...

◆ find()

SPOptionController isys::COptionController::find	(	const std::string &	rstrOption,
		const std::string &	rstrValue,
		bool	bAllowEmptyForSingleElement = `false`
	)

inherited

Returns COptionController for the element whose rstrOption has value rstrValue.

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	option value
bAllowEmptyForSingleElement	if a single element is present, allow access with empty rstrValue

Returns: COptionController for the element found

Exceptions

TException if this is not an array, rstrOption is not a valid option, or the element is not found

Python example: test_find.py

◆ get()

std::string isys::COptionController::get ( const std::string & rstrOption )

inherited

Returns string value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: string value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set.py

◆ get_bool()

bool isys::COptionController::get_bool ( const std::string & rstrOption )

inherited

Gets bool value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: bool value

Exceptions

TException if rstrOption is invalid, or type is not bool

Python example: test_get_set_bool.py

◆ get_int()

int64_t isys::COptionController::get_int ( const std::string & rstrOption )

inherited

Gets integer value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: int64_t value

Exceptions

TException if rstrOption is invalid, or type is not integer

Python example: test_get_set_int_uint.py

◆ get_option_URL()

std::string isys::COptionController::get_option_URL	(	std::string	strBase,
		std::string_view	strvOption
	)		const

protectedinherited

Possible parameters if we want the return string to be for example "/IDE/Info.VerMajor".

("" , "IDE/Info.VerMajor")
("/IDE/" , "Info.VerMajor")
("/IDE/Info", "VerMajor")

◆ get_uint()

uint64_t isys::COptionController::get_uint ( const std::string & rstrOption )

inherited

Gets unsigned integer value of rstrOption.

Parameters

rstrOption option string which is appended to the base URL

Returns: uint64_t value

Exceptions

TException if rstrOption is invalid, or type is not a positive integer

Python example: test_get_set_int_uint.py

◆ index_of()

int isys::COptionController::index_of	(	const std::string &	rstrOption,
		const std::string &	rstrValue
	)

inherited

Returns index of element whose element rstrOption has value rstrValue, or -1 if element is not found.

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	option value

Returns: index if element exists, -1 otherwise

Exceptions

TException if this is not an array, or rstrOption is not an element name

Python example: test_index_of.py

◆ opt()

SPOptionController isys::COptionController::opt ( const std::string & rstrOption )

inherited

Returns COptionController based on rstrOption (appended to the base URL).

Parameters

rstrOption option string which is appended to the base URL

Returns: COptionController instance

Python example: test_opt.py

◆ remove()

void isys::COptionController::remove ( size_t nIndex )

inherited

Removes element at nIndex.

Parameters

nIndex element index

Exceptions

TException if this is not an array, the array size is static, or nIndex is out of array range

Python example: test_add_remove.py

◆ set()

void isys::COptionController::set	(	const std::string &	rstrOption,
		const std::string &	rstrValue
	)

inherited

Sets rstrValue to rstrOption (appended to the base URL).

Parameters

rstrOption	option string which is appended to the base URL
rstrValue	string value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set.py

◆ set_bool()

void isys::COptionController::set_bool	(	const std::string &	rstrOption,
		bool	bValue
	)

inherited

Sets bValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
bValue	bool value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_bool.py

◆ set_channels()

void isys::COptionFNetDIOPatternOp::set_channels ( const iconnect::IntVector & rvChannels )

Sets channels which are participate in this pattern.

Only OUT channels can be set.

Parameters

rvChannels

◆ set_int()

void isys::COptionController::set_int	(	const std::string &	rstrOption,
		int64_t	iValue
	)

inherited

Sets iValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
iValue	int64_t value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_int_uint.py

◆ set_multi()

void isys::COptionController::set_multi ( const iconnect::StrStrMap & inParams )

inherited

Sets multiple option values with one call.

Parameters

inParams map of string option value pairs

Note: Python and Java support Python mapping and Java Map as input type in addition to isystem.connect.StrStrMap. Examples:

Python: optCtrlApp0.set_multi({"Name": "MyApp", "SymbolFiles.DefaultFile": "0"});

Java:   optCtrlApp0.set_multi(Map.of("Name", "MyApp", "SymbolFiles.DefaultFile", "0"));

Python example: test_set_multi.py

◆ set_operation()

void isys::COptionFNetDIOPatternOp::set_operation ( const EOperation eOperation )

Set operation mode.

Parameters

eOperation

◆ set_pattern()

void isys::COptionFNetDIOPatternOp::set_pattern ( const std::string & rstrPattern )

Set DIO pattern, a sequence of frames, separated by ';'.Each frame consists of state(binary)and duration(default us), separated by ','.

binary state - length must fit number of specified pattern channels. For example, if 3 channels are specified, binary state must be 3 digits long: "01x" duration - duration of this binary state. By default in "us", but "ns", "us", "ms" and "s" units are also supported. Example pattern string:"001,140; xx0,10; 1xx,50ms; 001,100us"

Parameters

rstrPattern pattern string

◆ set_start()

void isys::COptionFNetDIOPatternOp::set_start	(	const uint8_t	nFTrig,
		const bool	bStartActive
	)

Specifies FTrigger event to start on and initial state.

Parameters

nFTrig	FTrigger index to act upon, 0 to disable
bStartActive

◆ set_stop()

void isys::COptionFNetDIOPatternOp::set_stop	(	const uint8_t	nFTrig,
		const bool	bStopImmediately
	)

Specifies FTrigger event to stop on and whether to terminate the current run immediately.

Parameters

nFTrig	FTrigger index to act upon, 0 to disable
bStopImmediately

◆ set_uint()

void isys::COptionController::set_uint	(	const std::string &	rstrOption,
		uint64_t	nValue
	)

inherited

Sets nValue to rstrOption.

Parameters

rstrOption	option string which is appended to the base URL
nValue	uint64_t value

Exceptions

TException if rstrOption is invalid

Python example: test_get_set_int_uint.py

◆ size()

size_t isys::COptionController::size ( )

inherited

Returns array size of this instance.

Returns: size of array

Exceptions

TException if this is not an array

Python example: test_size.py

◆ URL()

std::string isys::COptionController::URL ( )

inherited

Returns full option URL of this instance.

Returns: full option URL

Python example: test_url.py

Description

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Member Function Documentation

◆ add()

◆ at()

◆ clear()

◆ COptionController()

◆ find()

◆ get()

◆ get_bool()

◆ get_int()

◆ get_option_URL()

◆ get_uint()

◆ index_of()

◆ opt()

◆ remove()

◆ set()

◆ set_bool()

◆ set_channels()

◆ set_int()

◆ set_multi()

◆ set_operation()

◆ set_pattern()

◆ set_start()

◆ set_stop()

◆ set_uint()

◆ size()

◆ URL()