#include <rtl_device.h>

Inheritance diagram for RTLDevice:

Data Structures
struct	DeviceInfo_t

struct	PacketData_t

struct	TestConfig_t

struct	TestResult_t

Public Types
enum	TEST_MODE { TM_CONT_TX, TM_CONT_RX, TM_PACKET_TX, TM_PACKET_RX }

enum	TEST_RESULT { TST_OK, TST_FAILED, TST_PKT_RECEIVED, TST_PKT_RX_BUF_OVERFLOW, TST_UNKNOWN }

enum	TEST_STATE { STATE_DAL, STATE_FPL }

Public Member Functions
	RTLDevice (void)

virtual	~RTLDevice (void)

virtual int	addDynamicOverride (const QString &devId, const QString &type, const QString &value, const QString &id)=0

virtual int	removeDynamicOverride (const QString &devId, const QString &id)=0

virtual void	appendError (const QString &error)
	Append error. More...

virtual void	clearAllErrors (void)
	Clear errors. More...

virtual int	connect (const QString rfDevName, const QString &devId)
	Connect to target device. More...

virtual int	deleteFileObject (FPLFile *pFplFile)
	Delete file Object. More...

virtual int	disconnect (const QString &devId)
	Disconnect target device. More...

virtual int	doLinkTest (const QString &txId, const QString &rxId, TestResult_t *pTestResult)=0

virtual QStringList	enumerateEbs (bool enableXdsDev=false)
	Enumerate EB devices. More...

virtual QString	getRfDevNameFromDevId (const QString devId)
	Get RF Device name from Device ID. More...

virtual int	eraseFlash (const QString &devName, const QString &devId, EraseInfo_t pEraseInfo=NULL, FPLFile pFile=NULL)=0

virtual int	executeCmd (const QString &devId, const QString &cmdName)
	Execute command. More...

virtual int	getAverageRssi (void)

virtual QString	getLastError (void)
	Get last error. More...

virtual QString	getRfState (const QString &devId)
	Get RF State. More...

virtual int	getRssi (const QString &devId, QString pRssiInDbm, QString pRssiRaw)
	Get RSSI. More...

virtual int	initPacketTx (const QString rfDevName, const QString &devId)
	Initialize Packet TX. More...

virtual bool	isConnected (const QString &devId)

virtual int	isPacketReceived (const QString rfDevName, const QString &devId)
	Is Packet Received. More...

virtual int	programFlash (const QString &devName, const QString &devId, FPLFile pFplFile, ProgramInfo_t pProgInfo=NULL)=0

virtual int	programFlash (const QString &devName, const QString &devId, const quint32 &address, const quint32 &length, quint8 *pBuffer)=0

virtual int	readCmdSettingsFromFile (const QString &devId, TestConfig_t &testConfig)=0

virtual FPLFile *	readFile (const QString &devName, const QString &devId, const QString &fileName, const quint32 &startAddress=0)
	Read File. More...

virtual int	readFrequencyOffset (const QString &devId, TestResult_t *pTestResult)

virtual int	readFrequencyOffsetCW (const QString &devId, TestResult_t *pTestResult)

virtual int	readPacket (const QString rfDevName, const QString &devId, PacketData_t *pPacketData)
	Read Packet. More...

virtual int	readMcuReg (const QString &devId, const quint32 &address, quint32 *pValue)=0

virtual int	readMemory (const QString &devName, const QString &devId, const quint32 &address, quint32 pLength, quint8 pBuffer)=0

virtual int	readRfReg (const QString &devId, const quint32 &address, quint32 *pValue)=0

virtual int	resetTarget (const QString rfDevName, const QString &devId, RESET_MODE mode)
	Reset Target device. More...

virtual int	sendPacket (const QString rfDevName, const QString &devId)
	Send Packet. More...

virtual int	setParameter (const QString &devId, const QString &parName, const QString &parValue)
	Set Parameter. More...

virtual void	setPacketData (char *pPayload, int len)
	Set packet Data. More...

virtual int	setPacketInterval (const QString &devId, const int &interval)
	Set Packet interval. More...

virtual void	setNbrOfPackets (int n)

virtual int	setIdle (const QString rfDevName, const QString &devId)
	Set device in Idle. More...

virtual int	startContTx (const QString rfDevName, const QString &devId, TestResult_t *pTestResult)
	Start continuous TX. More...

virtual int	startContRx (const QString rfDevName, const QString &devId, TestResult_t *pTestResult)
	Start continuous RX. More...

virtual int	startPacketRx (const QString rfDevName, const QString &devId)
	Start Packet RX. More...

virtual int	verifyFlash (const QString &devName, const QString &devId, FPLFile pFplFile, ProgramInfo_t pProgInfo=NULL)=0

virtual int	writeMcuReg (const QString &devId, const quint32 &address, const quint32 &value)=0

virtual int	writeMemory (const QString &devName, const QString &devId, const quint32 &address, const quint32 &length, quint8 *pBuffer)=0

virtual int	writeRfReg (const QString &devId, const quint32 &address, const quint32 &value)=0

virtual int	runCpu (const QString &devName, const QString &devId, bool debugMode)=0

virtual int	haltCpu (const QString &devName, const QString &devId)=0

virtual int	writeCpuReg (const QString &devName, const QString &devId, const CM3_CPU_REGISTERS &regNumber, const uint32_t &value)=0

virtual int	readCpuReg (const QString &devName, const QString &devId, const CM3_CPU_REGISTERS &regNumber, uint32_t *pValue)=0

virtual int	setCapArrayDelta (const QString &devId, const qint16 &value)=0

Static Public Member Functions
static void	initEraseInfo (EraseInfo_t *pEraseInfo)

static void	initProgramInfo (ProgramInfo_t *pProgInfo)

static void	setCallBackProgressFunction (_PROGRESS_FUNC_PTR pPf)

Protected Member Functions
QString	normDeviceName (const QString &rfDevName)
	Function to normalize the device name for use in DAL. More...

virtual int	initDALApi (const QString &devId)=0
	Function used to initiate DAL API. This is required after the FPL API has been used. More...

RTLFlashHandler *	getFlashHandler (const QString &devName, const QString &devId)
	Get Flash Handler. More...

bool	fwUpdateRequired (const QString &devId)
	The function will return true if FW updated is required. More...

Protected Attributes
int	m_averageRssi
	Used to keep the average RSSI value calculated during a link test. More...

QByteArray	m_packetData
	Buffer used for packet data during link test. More...

int	m_nbrOfPackets
	Number of packets that will be sent during the link test. More...

QList< DeviceInfo_t >	m_ebList
	List of connected EB devices (XDS serial number) returned from DALEbDevice::enumEB() More...

QMap< QString, DALEbDevice * >	m_mapConDevices
	Map of connected devices. More...

QMultiMap< char, int >	m_mapFreqOffset
	List used to average the frequency offset value. The offset value is used as key and the packet number as value. More...

QMap< QString, RTLFlashHandler * >	m_mapFlashHandlers
	Mapped list of Flash handler objects. More...

Static Protected Attributes
static _PROGRESS_FUNC_PTR	sm_pProgressFunction = NULL
	Static function pointer used to give feedback on progress. More...

Member Enumeration Documentation

§ TEST_MODE

enum RTLDevice::TEST_MODE

Enumerator
TM_CONT_TX
TM_CONT_RX
TM_PACKET_TX
TM_PACKET_RX

§ TEST_RESULT

enum RTLDevice::TEST_RESULT

Enumerator
TST_OK
TST_FAILED
TST_PKT_RECEIVED
TST_PKT_RX_BUF_OVERFLOW
TST_UNKNOWN

§ TEST_STATE

enum RTLDevice::TEST_STATE

Enumerator
STATE_DAL
STATE_FPL

Constructor & Destructor Documentation

§ RTLDevice()

RTLDevice::RTLDevice ( void )

References m_averageRssi, and m_nbrOfPackets.

§ ~RTLDevice()

RTLDevice::~RTLDevice ( void )

virtual

References m_mapConDevices, and m_mapFlashHandlers.

Member Function Documentation

§ addDynamicOverride()

virtual int RTLDevice::addDynamicOverride	(	const QString &	devId,
		const QString &	type,
		const QString &	value,
		const QString &	id
	)

pure virtual

Implemented in RTLDevice26_13xx.

§ removeDynamicOverride()

virtual int RTLDevice::removeDynamicOverride	(	const QString &	devId,
		const QString &	id
	)

pure virtual

Implemented in RTLDevice26_13xx.

§ appendError()

void RTLDevice::appendError ( const QString & error )

virtual

Append error.

Should be called to get a detailed description of the error when a function returns with an error code.

Parameters

[in] error A string describing the error

Referenced by connect(), RTLDevice26_13xx::eraseFlash(), executeCmd(), getFlashHandler(), getRssi(), initPacketTx(), RTLFlashHandler::initProgramInfo(), isPacketReceived(), RTLDevice26_13xx::programFlash(), RTLDevice26_13xx::readCmdSettingsFromFile(), RTLDevice26_13xx::readFrequencyOffsetCW(), readPacket(), sendPacket(), RTLDevice26_13xx::setCapArrayDelta(), setIdle(), setPacketInterval(), setParameter(), startContRx(), startContTx(), startPacketRx(), RTLDevice26_13xx::startPacketTx(), and RTLDevice26_13xx::verifyFlash().

§ clearAllErrors()

void RTLDevice::clearAllErrors ( void )

virtual

Clear errors.

Clear all errors

Referenced by RTLDevice26_13xx::readCmdSettingsFromFile().

§ connect()

int RTLDevice::connect	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Connect to target device.

This function should be called to setup a connection with given target. If the target doesn't exist in the list of devices, enum in DAL must be called. If DAL object for given device already exist, it will be delete and a new object created.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_OK or TST_FAILED

Reimplemented in RTLDevice26_13xx.

References appendError(), enumerateEbs(), fwUpdateRequired(), m_ebList, m_mapConDevices, m_mapFlashHandlers, normDeviceName(), TST_FAILED, and TST_OK.

Referenced by RTLDevice26_13xx::connect().

§ deleteFileObject()

int RTLDevice::deleteFileObject ( FPLFile * pFplFile )

virtual

Delete file Object.

Delete given File Object.

Parameters

[in] pFplFile Pointer to FPL file object

Returns: int TST_OK or TST_FAILED

References RTLFlashHandler::deleteFileObject().

§ disconnect()

int RTLDevice::disconnect ( const QString & devId )

virtual

Disconnect target device.

Called to end connection and delete device object.

Parameters

[in] devId USB Device ID. E.g.: "XDS-L2000010"

Returns: int TST_OK or TST_FAILED

References m_mapConDevices, m_mapFlashHandlers, TST_FAILED, and TST_OK.

§ doLinkTest()

virtual int RTLDevice::doLinkTest	(	const QString &	txId,
		const QString &	rxId,
		TestResult_t *	pTestResult
	)

pure virtual

Implemented in RTLDevice26_13xx.

§ enumerateEbs()

QStringList RTLDevice::enumerateEbs ( bool enableXdsDev = false )

virtual

Enumerate EB devices.

Returns a list of connected EB devices. The following emulators are supported: XDS100v3, XDS110 and XDS200

Returns: QStringList List of EB device identifiers

References RTLDevice::DeviceInfo_t::deviceId, RTLDevice::DeviceInfo_t::fwUpdateReq, and m_ebList.

Referenced by connect(), and getRfDevNameFromDevId().

§ getRfDevNameFromDevId()

QString RTLDevice::getRfDevNameFromDevId ( const QString devId )

virtual

Get RF Device name from Device ID.

This function returns the device name (E.g CC2650) that corresponds to the device id (E.g.: "XDS-06EB12100472A"). If the device is not in the list, it will call enumerateEbs(), to get the list.

Parameters

[in] devId USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: QString RF Device name

References enumerateEbs().

§ eraseFlash()

virtual int RTLDevice::eraseFlash	(	const QString &	devName,
		const QString &	devId,
		EraseInfo_t *	pEraseInfo = `NULL`,
		FPLFile *	pFile = `NULL`
	)

pure virtual

Implemented in RTLDevice26_13xx.

§ executeCmd()

int RTLDevice::executeCmd	(	const QString &	devId,
		const QString &	name
	)

virtual

Execute command.

The command that should be executed must have been populated with the configure method before this method is called.

Parameters

[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[in]	name	Name of the command

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

§ getAverageRssi()

virtual int RTLDevice::getAverageRssi ( void )

inlinevirtual

References getLastError(), getRfState(), getRssi(), initPacketTx(), and m_averageRssi.

§ getLastError()

QString RTLDevice::getLastError ( void )

virtual

Get last error.

Should be called to get a detailed description of the error when a function returns with an error code. The error will be removed from the list of errors.

Returns: QString A description of the last error that occurred.

Referenced by getAverageRssi(), getFlashHandler(), and printLastError().

§ getRfState()

QString RTLDevice::getRfState ( const QString & devId )

virtual

Get RF State.

Note: Not yet supported in DAL

Parameters

[in] devId USB Device ID. E.g.: "XDS-06EB12100472A"

References initDALApi(), and m_mapConDevices.

Referenced by getAverageRssi().

§ getRssi()

int RTLDevice::getRssi	(	const QString &	devId,
		QString *	pRssiInDbm,
		QString *	pRssiRaw
	)

virtual

Get RSSI.

Prior to calling this function the device must be put in RX mode.

Parameters

[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[out]	pRssiInDbm	RSSI value given in dBm
[out]	pRssiRaw	The RSSI value as read from the device register.

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by getAverageRssi().

§ initPacketTx()

int RTLDevice::initPacketTx	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Initialize Packet TX.

This function should be called to initialize Packet TX. The configuration function must be called before this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by getAverageRssi().

§ isConnected()

virtual bool RTLDevice::isConnected ( const QString & devId )

inlinevirtual

References isPacketReceived(), m_mapConDevices, programFlash(), readCmdSettingsFromFile(), and readFile().

§ isPacketReceived()

int RTLDevice::isPacketReceived	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Is Packet Received.

This function should be called after startPacketRx() to check if a packet has been received or not.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_PKT_RECEIVED if packet received, TST_OK if execution OK but no packet received, TST_FAILED if execution failed.; int TST_OK or TST_FAILED

References appendError(), m_mapConDevices, TST_FAILED, TST_OK, and TST_PKT_RECEIVED.

Referenced by isConnected().

§ programFlash() [1/2]

virtual int RTLDevice::programFlash	(	const QString &	devName,
		const QString &	devId,
		FPLFile *	pFplFile,
		ProgramInfo_t *	pProgInfo = `NULL`
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by isConnected().

§ programFlash() [2/2]

virtual int RTLDevice::programFlash	(	const QString &	devName,
		const QString &	devId,
		const quint32 &	address,
		const quint32 &	length,
		quint8 *	pBuffer
	)

pure virtual

Implemented in RTLDevice26_13xx.

§ readCmdSettingsFromFile()

virtual int RTLDevice::readCmdSettingsFromFile	(	const QString &	devId,
		TestConfig_t &	testConfig
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by isConnected(), and rssiTest().

§ readFile()

FPLFile * RTLDevice::readFile	(	const QString &	devName,
		const QString &	devId,
		const QString &	fileName,
		const quint32 &	startAddress = `0`
	)

virtual

Read File.

Read given file and create FPL File object.

Parameters

[in]	devName	Device name
[in]	devId	USB Device ID
[in]	fileName	File name with relative or absolute path
[in]	startAddress	The start address is required if the input file is a binary file (.bin)

Returns: FPLFile Pointer to FPL file object or NULL if function failed.

References getFlashHandler().

Referenced by isConnected().

§ readFrequencyOffset()

virtual int RTLDevice::readFrequencyOffset	(	const QString &	devId,
		TestResult_t *	pTestResult
	)

inlinevirtual

Reimplemented in RTLDevice26_13xx.

References RTLDevice::TestResult_t::qsError.

§ readFrequencyOffsetCW()

virtual int RTLDevice::readFrequencyOffsetCW	(	const QString &	devId,
		TestResult_t *	pTestResult
	)

inlinevirtual

Reimplemented in RTLDevice26_13xx.

References RTLDevice::TestResult_t::qsError, readMcuReg(), readMemory(), readPacket(), readRfReg(), resetTarget(), sendPacket(), setPacketData(), setPacketInterval(), and setParameter().

§ readPacket()

int RTLDevice::readPacket	(	const QString	rfDevName,
		const QString &	devId,
		PacketData_t *	pPacketData
	)

virtual

Read Packet.

This function should be called when isPacketReceived() has returned TST_PKT_RECEIVED. The packet data structure is used as both input and output. A data buffer with a maximum length must be created before calling this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[in,out]	pPacketData	Pointer to a packet data structure.

Returns: int TST_OK or TST_FAILED

References appendError(), RTLDevice::PacketData_t::crcOk, m_mapConDevices, RTLDevice::PacketData_t::maxLength, RTLDevice::PacketData_t::pData, rssi(), RTLDevice::PacketData_t::rssi, TST_FAILED, TST_OK, and TST_PKT_RX_BUF_OVERFLOW.

Referenced by readFrequencyOffsetCW().

§ readMcuReg()

virtual int RTLDevice::readMcuReg	(	const QString &	devId,
		const quint32 &	address,
		quint32 *	pValue
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by configureIOPinsForRangeExtender(), and readFrequencyOffsetCW().

§ readMemory()

virtual int RTLDevice::readMemory	(	const QString &	devName,
		const QString &	devId,
		const quint32 &	address,
		quint32 *	pLength,
		quint8 *	pBuffer
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by readFrequencyOffsetCW().

§ readRfReg()

virtual int RTLDevice::readRfReg	(	const QString &	devId,
		const quint32 &	address,
		quint32 *	pValue
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by readFrequencyOffsetCW().

§ resetTarget()

int RTLDevice::resetTarget	(	const QString	rfDevName,
		const QString &	devId,
		RESET_MODE	mode
	)

virtual

Reset Target device.

Reset target device.

Reset modes
1. RM_NORMAL Normal reset controlled by the Debugger API and the JTAG interface.
2. RM_PIN Debugger use the reset pins.
3. RM_PIN_HIB Same as RM_PIN but in addition the device will Halt in Boot-loader.

The connection to the target device will be lost after a reset.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[in]	mode	Reset mode

Returns: int TST_OK or TST_FAILED

References getFlashHandler(), and TST_FAILED.

Referenced by readFrequencyOffsetCW().

§ sendPacket()

int RTLDevice::sendPacket	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Send Packet.

This function should be called to send one packet. The setPacketData() and initPacketTx() functions must be called before this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, m_packetData, TST_FAILED, and TST_OK.

Referenced by readFrequencyOffsetCW().

§ setParameter()

int RTLDevice::setParameter	(	const QString &	devId,
		const QString &	parName,
		const QString &	parValue
	)

virtual

Set Parameter.

Called to set parameter value for given device. This is an overload function of setParameter and should be used for CC26xx and CC13xx.

The supported parameter names are given per device type in the param_definition.xml file.

Below is a list of parameter names and values. The list is divided in CC26xx and CC13xx devices.

-- CC26xx --
channel	0 - 39
frequency	Decimal value depending on the target device.
whitening	"true" of "false"
txPower	See SmartRF Studio for validated values.
modulated	"true" of "false".
accessAddress	Hex value of 4 bytes. Default: "8e89bed6"
-- CC13xx --
carrier_frequency	A decimal Value depending on the target device. E.g.: "868.3"
symbolRate	Decimal value.E.g.: "34.8"
deviation	Decimal value.E.g.: "25.0"
rxFilterBw	See SmartRF Studio for valid values.
txPower	See SmartRF Studio for validated values.
whitening	"true" of "false"
modulated	"true" of "false".
dataFormat	See SmartRF Studio for valid values.
preambleCount	See SmartRF Studio for valid values.
preambleMode	See SmartRF Studio for valid values.
syncWord	Hex value of 4 bytes. E.g.: "0x930b51de"
syncWordLength	1 - 32
packetLengthConfig	"Variable" or "Fixed"
packetLengthTx	Integer value depending on the target device.
packetLengthRx	Integer value depending on the target device.
fixedPacketLength	Integer value depending on the target device.
address	Hex value of 1 byte. E.g.: "0A".
addressMode	See SmartRF Studio for valid values.

Note: The listed parameters is not valid for all device types. The applicable parameters for the selected device type can be seen from the param_definition.xml file. Or, by using SmartRF Studio in off line mode for the required device.

Parameters

[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[in]	parName	Name of the parameter
[in]	parValue	Parameter value

Returns: int TST_OK or TST_FAILED

References appendError(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by readFrequencyOffsetCW(), and rssiTest().

§ setPacketData()

void RTLDevice::setPacketData	(	char *	pData,
		int	len
	)

virtual

Set packet Data.

The data will be used to setup the packet buffer sent by the transmitter. For the link test, the receiver will also use the data to compare with the data received over the air.

Parameters

[in]	pData	Buffer with payload data.
[in]	len	Length of the buffer

References m_packetData.

Referenced by readFrequencyOffsetCW().

§ setPacketInterval()

int RTLDevice::setPacketInterval	(	const QString &	devId,
		const int &	interval
	)

virtual

Set Packet interval.

Parameters

[in]	devId	Device ID
[in]	interval	Packet interval given in ms

Returns: int TST_OK or TST_FAILED

References appendError(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by readFrequencyOffsetCW().

§ setNbrOfPackets()

virtual void RTLDevice::setNbrOfPackets ( int n )

inlinevirtual

References haltCpu(), m_nbrOfPackets, readCpuReg(), runCpu(), setCapArrayDelta(), setIdle(), startContRx(), startContTx(), startPacketRx(), verifyFlash(), writeCpuReg(), writeMcuReg(), writeMemory(), and writeRfReg().

§ setIdle()

int RTLDevice::setIdle	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Set device in Idle.

This function should be called to set device in IDLE

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by setNbrOfPackets().

§ startContTx()

int RTLDevice::startContTx	(	const QString	rfDevName,
		const QString &	devId,
		TestResult_t *	pTestResult
	)

virtual

Start continuous TX.

This function should be called to start cont. TX. The configuration function must be called before this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[out]	pTestResult	Pointer to structure with test results.

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by setNbrOfPackets().

§ startContRx()

int RTLDevice::startContRx	(	const QString	rfDevName,
		const QString &	devId,
		TestResult_t *	pTestResult
	)

virtual

Start continuous RX.

This function should be called to start cont. RX. The configuration function must be called before this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"
[out]	pTestResult	Pointer to structure with test results.

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by setNbrOfPackets().

§ startPacketRx()

int RTLDevice::startPacketRx	(	const QString	rfDevName,
		const QString &	devId
	)

virtual

Start Packet RX.

This function should be called to start Packet RX. The configuration function must be called before this function.

Parameters

[in]	rfDevName	RF Device name like "CC2650"
[in]	devId	USB Device ID. E.g.: "XDS-06EB12100472A"

Returns: int TST_OK or TST_FAILED

References appendError(), initDALApi(), m_mapConDevices, TST_FAILED, and TST_OK.

Referenced by setNbrOfPackets().

§ verifyFlash()

virtual int RTLDevice::verifyFlash	(	const QString &	devName,
		const QString &	devId,
		FPLFile *	pFplFile,
		ProgramInfo_t *	pProgInfo = `NULL`
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ writeMcuReg()

virtual int RTLDevice::writeMcuReg	(	const QString &	devId,
		const quint32 &	address,
		const quint32 &	value
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by configureIOPinsForRangeExtender(), and setNbrOfPackets().

§ writeMemory()

virtual int RTLDevice::writeMemory	(	const QString &	devName,
		const QString &	devId,
		const quint32 &	address,
		const quint32 &	length,
		quint8 *	pBuffer
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ writeRfReg()

virtual int RTLDevice::writeRfReg	(	const QString &	devId,
		const quint32 &	address,
		const quint32 &	value
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ runCpu()

virtual int RTLDevice::runCpu	(	const QString &	devName,
		const QString &	devId,
		bool	debugMode
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ haltCpu()

virtual int RTLDevice::haltCpu	(	const QString &	devName,
		const QString &	devId
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ writeCpuReg()

virtual int RTLDevice::writeCpuReg	(	const QString &	devName,
		const QString &	devId,
		const CM3_CPU_REGISTERS &	regNumber,
		const uint32_t &	value
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ readCpuReg()

virtual int RTLDevice::readCpuReg	(	const QString &	devName,
		const QString &	devId,
		const CM3_CPU_REGISTERS &	regNumber,
		uint32_t *	pValue
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setNbrOfPackets().

§ setCapArrayDelta()

virtual int RTLDevice::setCapArrayDelta	(	const QString &	devId,
		const qint16 &	value
	)

pure virtual

Implemented in RTLDevice26_13xx.

Referenced by setCapArrayTuning(), and setNbrOfPackets().

§ initEraseInfo()

static void RTLDevice::initEraseInfo ( EraseInfo_t * pEraseInfo )

inlinestatic

References RTLFlashHandler::initEraseInfo().

§ initProgramInfo()

static void RTLDevice::initProgramInfo ( ProgramInfo_t * pProgInfo )

inlinestatic

References RTLFlashHandler::initProgramInfo().

§ setCallBackProgressFunction()

static void RTLDevice::setCallBackProgressFunction ( _PROGRESS_FUNC_PTR pPf )

inlinestatic

References sm_pProgressFunction.

§ normDeviceName()

QString RTLDevice::normDeviceName ( const QString & rfDevName )

protected

Function to normalize the device name for use in DAL.

Normalize device name.

Some of the device names need to be changed in order to be recognized by the DAL library.

Parameters

[in] rfDevName RF Device name like "CC2650"

Returns: QString The normalized device name

Referenced by connect().

§ initDALApi()

virtual int RTLDevice::initDALApi ( const QString & devId )

protectedpure virtual

Function used to initiate DAL API. This is required after the FPL API has been used.

Referenced by executeCmd(), getRfState(), getRssi(), initPacketTx(), sendPacket(), setIdle(), startContRx(), startContTx(), and startPacketRx().

§ getFlashHandler()

RTLFlashHandler * RTLDevice::getFlashHandler	(	const QString &	devName,
		const QString &	devId
	)

protected

Get Flash Handler.

Get pointer to the Flash Handler object.

Parameters

[in]	devName	Device name
[in]	devId	Device ID

Returns: RTLFlashHandler Pointer to Flash handler object

References appendError(), getLastError(), m_mapConDevices, and m_mapFlashHandlers.

Referenced by RTLDevice26_13xx::eraseFlash(), RTLDevice26_13xx::haltCpu(), RTLDevice26_13xx::programFlash(), RTLDevice26_13xx::readCpuReg(), readFile(), RTLDevice26_13xx::readMemory(), resetTarget(), RTLDevice26_13xx::runCpu(), RTLDevice26_13xx::verifyFlash(), RTLDevice26_13xx::writeCpuReg(), and RTLDevice26_13xx::writeMemory().

§ fwUpdateRequired()

bool RTLDevice::fwUpdateRequired ( const QString & devId )

protected

The function will return true if FW updated is required.

FW update required.

Read list of connected evaluation boards and check if FW update is required.

Parameters

[in] devId USB Device ID

Returns: bool true if FW update is required, else false.

References m_ebList.

Referenced by connect().

Field Documentation

§ m_averageRssi

int RTLDevice::m_averageRssi

protected

Used to keep the average RSSI value calculated during a link test.

Referenced by RTLDevice26_13xx::doLinkTest(), getAverageRssi(), and RTLDevice().

§ m_packetData

QByteArray RTLDevice::m_packetData

protected

Buffer used for packet data during link test.

Referenced by RTLDevice26_13xx::doLinkTest(), sendPacket(), setPacketData(), and RTLDevice26_13xx::startPacketTx().

§ m_nbrOfPackets

int RTLDevice::m_nbrOfPackets

protected

Number of packets that will be sent during the link test.

Referenced by RTLDevice26_13xx::doLinkTest(), RTLDevice(), setNbrOfPackets(), and RTLDevice26_13xx::startPacketTx().

§ m_ebList

QList<DeviceInfo_t> RTLDevice::m_ebList

protected

List of connected EB devices (XDS serial number) returned from DALEbDevice::enumEB()

Referenced by connect(), enumerateEbs(), and fwUpdateRequired().

§ m_mapConDevices

QMap<QString, DALEbDevice *> RTLDevice::m_mapConDevices

protected

§ m_mapFreqOffset

QMultiMap<char, int> RTLDevice::m_mapFreqOffset

protected

List used to average the frequency offset value. The offset value is used as key and the packet number as value.

Referenced by RTLDevice26_13xx::doLinkTest(), and RTLDevice26_13xx::readFrequencyOffsetCW().

§ sm_pProgressFunction

_PROGRESS_FUNC_PTR RTLDevice::sm_pProgressFunction = NULL

staticprotected

Static function pointer used to give feedback on progress.

Referenced by RTLDevice26_13xx::doLinkTest(), setCallBackProgressFunction(), and RTLDevice26_13xx::startPacketTx().

§ m_mapFlashHandlers

QMap<QString, RTLFlashHandler *> RTLDevice::m_mapFlashHandlers

protected

Mapped list of Flash handler objects.

Referenced by connect(), disconnect(), getFlashHandler(), ~RTLDevice(), and RTLDevice26_13xx::~RTLDevice26_13xx().

The documentation for this class was generated from the following files:

Data Structures

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Member Enumeration Documentation

§ TEST_MODE

§ TEST_RESULT

§ TEST_STATE

Constructor & Destructor Documentation

§ RTLDevice()

§ ~RTLDevice()

Member Function Documentation

§ addDynamicOverride()

§ removeDynamicOverride()

§ appendError()

§ clearAllErrors()

§ connect()

§ deleteFileObject()

§ disconnect()

§ doLinkTest()

§ enumerateEbs()

§ getRfDevNameFromDevId()

§ eraseFlash()

§ executeCmd()

§ getAverageRssi()

§ getLastError()

§ getRfState()

§ getRssi()

§ initPacketTx()

§ isConnected()

§ isPacketReceived()

§ programFlash() [1/2]

§ programFlash() [2/2]

§ readCmdSettingsFromFile()

§ readFile()

§ readFrequencyOffset()

§ readFrequencyOffsetCW()

§ readPacket()

§ readMcuReg()

§ readMemory()

§ readRfReg()

§ resetTarget()

§ sendPacket()

§ setParameter()

§ setPacketData()

§ setPacketInterval()

§ setNbrOfPackets()

§ setIdle()

§ startContTx()

§ startContRx()

§ startPacketRx()

§ verifyFlash()

§ writeMcuReg()

§ writeMemory()

§ writeRfReg()

§ runCpu()

§ haltCpu()

§ writeCpuReg()

§ readCpuReg()

§ setCapArrayDelta()

§ initEraseInfo()

§ initProgramInfo()

§ setCallBackProgressFunction()

§ normDeviceName()

§ initDALApi()

§ getFlashHandler()

§ fwUpdateRequired()

Field Documentation

§ m_averageRssi

§ m_packetData

§ m_nbrOfPackets

§ m_ebList

§ m_mapConDevices

§ m_mapFreqOffset

§ sm_pProgressFunction

§ m_mapFlashHandlers