|
|
| ADTF_IID (ICANCoder, "can_coder.axle.can.sdk.devicetb.adtf.iid") |
| |
| virtual tResult | Begin (const adtf::streaming::ant::ISampleBuffer *pData)=0 |
| |
| virtual tResult | Begin (const void *pData, int64_t nSize)=0 |
| |
| virtual tResult | End ()=0 |
| |
| virtual tResult | SetMessageInfo (tChannelID nChannel, tMessageID nMsgID, bool bExtended)=0 |
| |
| virtual tResult | GetMessageInfo (tChannelID *pnChannel, tMessageID *pnMsgID, bool *pbExtended)=0 |
| |
| virtual tResult | Set (const char *strValueID, const void *pValue)=0 |
| |
| virtual tResult | Get (const char *strValueID, void *pValue)=0 |
| |
| virtual tResult | SetSignalValue (tSignalID nSignalID, const tSignalValue *pSignalValue)=0 |
| |
| virtual tResult | GetSignalValue (tSignalID nSignalID, tSignalValue *pSignalValue) const =0 |
| |
| virtual tResult | SetRawData (const uint8_t *pData, uint8_t nLength)=0 |
| |
| virtual tResult | GetRawData (const uint8_t **pData, uint8_t *nLength) const =0 |
| |
| virtual tResult | GetSignalID (tChannelID nChannel, const char *strValueID, tSignalID *pSignalID) const =0 |
| |
| virtual tResult | GetDatabase (tChannelID nChannel, adtf::ucom::ant::iobject_ptr< ICANDatabase > &pCANDatabase) const =0 |
| |
| virtual tResult | SetDatabase (tChannelID nChannel, const char *strFileName)=0 |
| |
◆ Begin() [1/2]
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::Begin |
( |
const adtf::streaming::ant::ISampleBuffer * | pData | ) |
|
|
pure virtual |
Sets the CAN message buffer the coder operates on.
- Parameters
-
| [in] | pData | The sample buffer to operate on. |
- Returns
- A tResult.
◆ Begin() [2/2]
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::Begin |
( |
const void * | pData, |
|
|
int64_t | nSize ) |
|
pure virtual |
Sets the CAN message buffer the coder operates on.
- Parameters
-
| [in] | pData | The raw message to operate on. |
| [in] | nSize | The size of the passed message buffer. |
- Returns
- A tResult.
◆ End()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::End |
( |
| ) |
|
|
pure virtual |
Releases the the message which was acquired by any of the Begin() functions.
- Returns
- A tResult.
◆ Get()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::Get |
( |
const char * | strValueID, |
|
|
void * | pValue ) |
|
pure virtual |
Gets the value, which is defined with strValueID. This value is defined within the data area of the stream. The real data area is the buffer allocated by the given by the data pointer of Begin method. The data will be copied in the pValue.
- Attention
- You need to allocate the memory of pValue with the right size!
- Parameters
-
| [in] | strValueID | The value ID specified in the stream (NULL terminated). |
| [out] | pValue | Pointer to the value to get, this is a reference to the memory area within the given pData by Begin. |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the given data by Begin has no valid size. |
| ERR_INVALID_ARG | The given strValueID is not specified. |
◆ GetDatabase()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::GetDatabase |
( |
tChannelID | nChannel, |
|
|
adtf::ucom::ant::iobject_ptr< ICANDatabase > & | pCANDatabase ) const |
|
pure virtual |
Returns the CAN Database for the channel
- Parameters
-
| [in] | nChannel | CAN Channel number |
| [out] | pCANDatabase | Pointer to CAN database |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_NOT_FOUND | For the given channel no CAN database is defined |
◆ GetMessageInfo()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::GetMessageInfo |
( |
tChannelID * | pnChannel, |
|
|
tMessageID * | pnMsgID, |
|
|
bool * | pbExtended ) |
|
pure virtual |
Returns information about the CAN message
- Parameters
-
| [in,out] | pnChannel | Pointer to variable to receive the CAN channel number |
| [in,out] | pnMsgID | Pointer to variable to receive the CAN message ID |
| [in,out] | pbExtended | Pointer to variable to receive the CAN message type |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the data given by Begin() has no valid size for this message. |
| ERR_NOT_FOUND | The given nMsgID is not valid. |
◆ GetRawData()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::GetRawData |
( |
const uint8_t ** | pData, |
|
|
uint8_t * | nLength ) const |
|
pure virtual |
Returns the the raw data and the length of the message given by Begin()
- Parameters
-
| [out] | pData | Pointer of pointer to raw message data |
| [out] | nLength | Length of raw message data |
- Return values
-
◆ GetSignalID()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::GetSignalID |
( |
tChannelID | nChannel, |
|
|
const char * | strValueID, |
|
|
tSignalID * | pSignalID ) const |
|
pure virtual |
Returns the value ID of a given CAN signal name for the specified channel
- Parameters
-
| [in] | nChannel | CAN Channel number |
| [in] | strValueID | Name of CAN signal |
| [in,out] | pSignalID | Pointer to variable which receives the ID |
- Note
- Relevant value id strings for gettings specific signal ids within a CAN message. In these cases the nChannel is negligible:
-
"ui8Tag" - returns CAN_SIGNALID_HEADER_TAG
-
"ui8Channel" - returns CAN_SIGNALID_HEADER_CHANNEL
-
"tmTimeStamp" - returns CAN_SIGNALID_HEADER_HWTIME
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_NOT_FOUND | The given Name is not valid. |
◆ GetSignalValue()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::GetSignalValue |
( |
tSignalID | nSignalID, |
|
|
tSignalValue * | pSignalValue ) const |
|
pure virtual |
Returns the decoded value of one CAN signal from the data area given by Begin() On return the field tSignalValue::nTypeTag and the corresponding field in the union will be filled with the appropriate value. To get the signal raw value, the field tSignalValue::nTypeTag has to be set to TAG_RAW_VALUE before calling this method.
- Parameters
-
| [in] | nSignalID | Value ID |
| [in,out] | pSignalValue | Pointer to structure which receives the value |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the data given by Begin() has no valid size for this message. |
| ERR_NOT_FOUND | The given nSignalID is not in the current CAN message. |
| ERR_INVALID_INDEX | The signal is not in the actual multiplexor group |
◆ Set()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::Set |
( |
const char * | strValueID, |
|
|
const void * | pValue ) |
|
pure virtual |
Sets the value, which is defined with strValueID. The content of pValue will be copied. This value is defined within the data area of the coder. The real data area is the buffer allocated by the given by the Begin method. If no data is given by Begin then the setValue failed.
- Parameters
-
| [in] | strValueID | The value ID specified in the stream (NULL terminated). |
| [in] | pValue | Pointer to the value to set. |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the data given by Begin has no valid size for this coder. |
| ERR_NOT_FOUND | The given strValueID is not specified. |
◆ SetDatabase()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::SetDatabase |
( |
tChannelID | nChannel, |
|
|
const char * | strFileName ) |
|
pure virtual |
Loads the DBC file and uses it for (de-)coding of signal values for the specified channel
- Parameters
-
| [in] | nChannel | CAN Channel number |
| [in] | strFileName | Name of dbc file to be loaded |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_NOT_FOUND | The given file is not valid. |
◆ SetMessageInfo()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::SetMessageInfo |
( |
tChannelID | nChannel, |
|
|
tMessageID | nMsgID, |
|
|
bool | bExtended ) |
|
pure virtual |
Inits a new CAN message. The length of the CAN message will be set automatically. This method has to be called if a new CAN message has to be created.
- Parameters
-
| [in] | nChannel | CAN channel number |
| [in] | nMsgID | CAN message ID |
| [in] | bExtended | True if message is an extended CAN message |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the data given by Begin() has no valid size for this message. |
| ERR_NOT_FOUND | The given nMsgID is not valid. |
◆ SetRawData()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::SetRawData |
( |
const uint8_t * | pData, |
|
|
uint8_t | nLength ) |
|
pure virtual |
Copies the given raw data to the raw data of the message given by Begin().
- Parameters
-
| [in] | pData | Point of raw message data to set |
| [in] | nLength | Length of raw message data |
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_INVALID_ARG | The specified length of the message given by Begin() and nLength does not match. |
◆ SetSignalValue()
| virtual tResult adtf::devicetb::sdk::can::axle::ICANCoder::SetSignalValue |
( |
tSignalID | nSignalID, |
|
|
const tSignalValue * | pSignalValue ) |
|
pure virtual |
Sets the value of one CAN signal in the data area given by ICANCoder::Begin To set the raw value directly, the field tSignalValue::nTypeTag has to be set to TAG_RAW_VALUE and the field tSignalValue::n64RawValue to the new raw value.
- Parameters
-
| [in] | nSignalID | Value ID |
| [in] | pSignalValue | Value to be written to CAN message |
- Note
- Relevant signal ids for setting specific values within a CAN message:
-
CAN_SIGNALID_HEADER_TAG - specifying the hardware tag
-
CAN_SIGNALID_HEADER_CHANNEL - specifying the hardware channel
-
CAN_SIGNALID_HEADER_HWTIME - specifying the hardware time
- Return values
-
| ERR_NOERROR | No Error. |
| ERR_MEMORY | The buffer area of the data given by Begin() has no valid size for this message. |
| ERR_NOT_FOUND | The given nSignalID is not in the current CAN message. |
| ERR_INVALID_INDEX | The signal is not in the actual multiplexor group |
The documentation for this class was generated from the following file: