RadioTestLibrary  1.32.0
Data Structures | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Static Protected Attributes
RTLDevice Class Referenceabstract

#include <rtl_device.h>

Inheritance diagram for RTLDevice:
Inheritance graph
[legend]

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...
 
RTLFlashHandlergetFlashHandler (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_tm_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

Enumerator
TM_CONT_TX 
TM_CONT_RX 
TM_PACKET_TX 
TM_PACKET_RX 

§ TEST_RESULT

Enumerator
TST_OK 
TST_FAILED 
TST_PKT_RECEIVED 
TST_PKT_RX_BUF_OVERFLOW 
TST_UNKNOWN 

§ 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

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

§ 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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]pFplFilePointer 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]devIdUSB 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]devIdUSB 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]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[in]nameName 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

§ 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]devIdUSB 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]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[out]pRssiInDbmRSSI value given in dBm
[out]pRssiRawThe 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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

§ 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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]devNameDevice name
[in]devIdUSB Device ID
[in]fileNameFile name with relative or absolute path
[in]startAddressThe 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

§ 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[in,out]pPacketDataPointer 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

§ 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[in]modeReset 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[in]parNameName of the parameter
[in]parValueParameter 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]pDataBuffer with payload data.
[in]lenLength 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]devIdDevice ID
[in]intervalPacket 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

§ 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[out]pTestResultPointer 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB Device ID. E.g.: "XDS-06EB12100472A"
[out]pTestResultPointer 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]rfDevNameRF Device name like "CC2650"
[in]devIdUSB 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

§ 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

§ initProgramInfo()

static void RTLDevice::initProgramInfo ( ProgramInfo_t pProgInfo)
inlinestatic

§ 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]rfDevNameRF 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

§ 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]devIdUSB 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:
© Copyright 1995-2023, Texas Instruments Incorporated. All rights reserved.
Trademarks | Privacy policy | Terms of use | Terms of sale