2020-03-18 19:07:41 -07:00
|
|
|
/**
|
|
|
|
* @file can_msg_tx.h
|
|
|
|
*
|
|
|
|
* CAN message transmission
|
|
|
|
*
|
|
|
|
* @date Mar 13, 2020
|
|
|
|
* @author Matthew Kennedy, (c) 2012-2020
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <cstdint>
|
|
|
|
#include <cstddef>
|
|
|
|
|
|
|
|
#include "os_access.h"
|
2021-12-08 09:01:28 -08:00
|
|
|
#include "can.h"
|
2020-03-18 19:07:41 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Represent a message to be transmitted over CAN.
|
|
|
|
*
|
|
|
|
* Usage:
|
|
|
|
* * Create an instance of CanTxMessage
|
|
|
|
* * Set any data you'd like to transmit either using the subscript operator to directly access bytes, or any of the helper functions.
|
|
|
|
* * Upon destruction, the message is transmitted.
|
|
|
|
*/
|
|
|
|
class CanTxMessage
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Create a new CAN message, with the specified extended ID.
|
|
|
|
*/
|
2020-12-12 13:34:21 -08:00
|
|
|
explicit CanTxMessage(uint32_t eid, uint8_t dlc = 8, bool isExtended = false);
|
2020-03-18 19:07:41 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Destruction of an instance of CanTxMessage will transmit the message over the wire.
|
|
|
|
*/
|
|
|
|
~CanTxMessage();
|
|
|
|
|
2021-02-05 20:57:28 -08:00
|
|
|
#if EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
/**
|
|
|
|
* Configures the device for all messages to transmit from.
|
|
|
|
*/
|
|
|
|
static void setDevice(CANDriver* device);
|
2021-02-05 20:57:28 -08:00
|
|
|
#endif // EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
/**
|
|
|
|
* @brief Read & write the raw underlying 8-byte buffer.
|
|
|
|
*/
|
|
|
|
uint8_t& operator[](size_t);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Write a 16-bit short value to the buffer. Note: this writes in big endian byte order.
|
|
|
|
*/
|
|
|
|
void setShortValue(uint16_t value, size_t offset);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Set a single bit in the transmit buffer. Useful for single-bit flags.
|
|
|
|
*/
|
|
|
|
void setBit(size_t byteIdx, size_t bitIdx);
|
|
|
|
|
2021-07-16 11:06:26 -07:00
|
|
|
void setDlc(uint8_t dlc);
|
|
|
|
|
2021-12-08 09:01:28 -08:00
|
|
|
//#if ! EFI_SIMULATOR
|
|
|
|
const CANTxFrame *getFrame() const {
|
|
|
|
return &m_frame;
|
|
|
|
}
|
|
|
|
//#endif // EFI_SIMULATOR
|
|
|
|
|
2020-03-18 19:07:41 -07:00
|
|
|
protected:
|
2021-12-08 09:01:28 -08:00
|
|
|
//#if ! EFI_SIMULATOR
|
2020-03-18 19:07:41 -07:00
|
|
|
CANTxFrame m_frame;
|
2021-12-08 09:01:28 -08:00
|
|
|
//#endif // EFI_SIMULATOR
|
2020-03-18 19:07:41 -07:00
|
|
|
|
|
|
|
private:
|
2021-02-05 20:57:28 -08:00
|
|
|
#if EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
static CANDriver* s_device;
|
2021-02-05 20:57:28 -08:00
|
|
|
#endif // EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A CAN message based on a type, removing the need for manually flipping bits/bytes.
|
|
|
|
*/
|
|
|
|
template <typename TData>
|
|
|
|
class CanTxTyped final : public CanTxMessage
|
|
|
|
{
|
2021-02-05 20:57:28 -08:00
|
|
|
#if EFI_CAN_SUPPORT
|
2021-03-09 15:54:01 -08:00
|
|
|
static_assert(sizeof(TData) <= sizeof(CANTxFrame::data8));
|
2021-02-05 20:57:28 -08:00
|
|
|
#endif // EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
|
|
|
|
public:
|
2021-11-28 11:59:26 -08:00
|
|
|
explicit CanTxTyped(uint32_t id, bool isExtended) : CanTxMessage(id, sizeof(TData), isExtended) { }
|
2020-03-18 19:07:41 -07:00
|
|
|
|
2021-02-05 20:57:28 -08:00
|
|
|
#if EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
/**
|
|
|
|
* Access members of the templated type.
|
|
|
|
*
|
|
|
|
* So you can do:
|
|
|
|
* CanTxTyped<MyType> d;
|
|
|
|
* d->memberOfMyType = 23;
|
|
|
|
*/
|
|
|
|
TData* operator->() {
|
|
|
|
return reinterpret_cast<TData*>(&m_frame.data8);
|
|
|
|
}
|
2020-03-19 14:58:46 -07:00
|
|
|
|
|
|
|
TData& get() {
|
|
|
|
return *reinterpret_cast<TData*>(&m_frame.data8);
|
|
|
|
}
|
2021-02-05 20:57:28 -08:00
|
|
|
#endif // EFI_CAN_SUPPORT
|
2020-03-18 19:07:41 -07:00
|
|
|
};
|
2020-03-19 14:58:46 -07:00
|
|
|
|
|
|
|
template <typename TData>
|
2021-11-28 11:59:26 -08:00
|
|
|
void transmitStruct(uint32_t id, bool isExtended)
|
2020-03-19 14:58:46 -07:00
|
|
|
{
|
2021-11-28 11:59:26 -08:00
|
|
|
CanTxTyped<TData> frame(id, isExtended);
|
2020-03-31 17:57:52 -07:00
|
|
|
// Destruction of an instance of CanTxMessage will transmit the message over the wire.
|
|
|
|
// see CanTxMessage::~CanTxMessage()
|
2020-03-19 14:58:46 -07:00
|
|
|
populateFrame(frame.get());
|
|
|
|
}
|