moved comments to the header file

pull/9/head 0.1
Ondřej Hruška 8 years ago
parent 80cc7e71e7
commit 60a2a90059
  1. 574
      TinyFrame.c
  2. 134
      TinyFrame.h
  3. 7
      test.c

@ -9,425 +9,345 @@
enum TFState { enum TFState {
TFState_SOF = 0, //!< Wait for SOF TFState_SOF = 0, //!< Wait for SOF
TFState_ID, //!< Wait for ID TFState_ID, //!< Wait for ID
TFState_NOB, //!< Wait for Number Of Bytes TFState_NOB, //!< Wait for Number Of Bytes
TFState_PAYLOAD, //!< Receive payload TFState_PAYLOAD, //!< Receive payload
TFState_CKSUM //!< Wait for Checksum TFState_CKSUM //!< Wait for Checksum
}; };
typedef struct _IdListener_struct { typedef struct _IdListener_struct {
unsigned int id; unsigned int id;
TinyFrameListener fn; TinyFrameListener fn;
} IdListener; } IdListener;
typedef struct _TypeListener_struct_ { typedef struct _TypeListener_struct_ {
unsigned char type; unsigned char type;
TinyFrameListener fn; TinyFrameListener fn;
} TypeListener; } TypeListener;
typedef struct _GenericListener_struct_ { typedef struct _GenericListener_struct_ {
TinyFrameListener fn; TinyFrameListener fn;
} GenericListener; } GenericListener;
/** /**
* Frame parser internal state * Frame parser internal state
*/ */
static struct TinyFrameStruct { static struct TinyFrameStruct {
/* Own state */ /* Own state */
bool peer_bit; //!< Own peer bit (unqiue to avoid msg ID clash) bool peer_bit; //!< Own peer bit (unqiue to avoid msg ID clash)
unsigned int next_id; //!< Next frame / frame chain ID unsigned int next_id; //!< Next frame / frame chain ID
/* Parser state */ /* Parser state */
enum TFState state; enum TFState state;
unsigned int id; //!< Incoming packet ID unsigned int id; //!< Incoming packet ID
unsigned int nob; //!< Payload length unsigned int nob; //!< Payload length
unsigned char pldbuf[TF_MAX_PAYLOAD+1]; //!< Payload byte buffer unsigned char pldbuf[TF_MAX_PAYLOAD+1]; //!< Payload byte buffer
unsigned int rxi; //!< Receive counter (for payload or other fields) unsigned int rxi; //!< Receive counter (for payload or other fields)
unsigned int cksum; //!< Continually updated checksum unsigned int cksum; //!< Continually updated checksum
/* --- Callbacks --- */ /* --- Callbacks --- */
/* Transaction callbacks */ /* Transaction callbacks */
IdListener id_listeners[TF_MAX_ID_LST]; IdListener id_listeners[TF_MAX_ID_LST];
TypeListener type_listeners[TF_MAX_TYPE_LST]; TypeListener type_listeners[TF_MAX_TYPE_LST];
GenericListener generic_listeners[TF_MAX_GEN_LST]; GenericListener generic_listeners[TF_MAX_GEN_LST];
char sendbuf[TF_MAX_PAYLOAD+1]; char sendbuf[TF_MAX_PAYLOAD+1];
} tf; } tf;
/**
* Initialize the TinyFrame engine.
* This can also be used to completely reset it (removing all listeners etc)
*
* @param peer_bit - peer bit to use for self
*/
void TF_Init(bool peer_bit) void TF_Init(bool peer_bit)
{ {
memset(&tf, 0, sizeof(struct TinyFrameStruct)); memset(&tf, 0, sizeof(struct TinyFrameStruct));
tf.peer_bit = peer_bit; tf.peer_bit = peer_bit;
} }
/**
* Reset the frame parser state machine.
*/
void TF_ResetParser(void) void TF_ResetParser(void)
{ {
tf.state = TFState_SOF; tf.state = TFState_SOF;
tf.cksum = 0; tf.cksum = 0;
} }
/**
* Register a frame type listener.
*
* @param frame_type - frame ID to listen for
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddIdListener(unsigned int frame_id, TinyFrameListener cb) int TF_AddIdListener(unsigned int frame_id, TinyFrameListener cb)
{ {
int i; int i;
for (i = 0; i < TF_MAX_ID_LST; i++) { for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn == NULL) { if (tf.id_listeners[i].fn == NULL) {
tf.id_listeners[i].fn = cb; tf.id_listeners[i].fn = cb;
tf.id_listeners[i].id = frame_id; tf.id_listeners[i].id = frame_id;
return i; return i;
} }
} }
return TF_ERROR; return TF_ERROR;
} }
/**
* Register a frame type listener.
*
* @param frame_type - frame type to listen for
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddTypeListener(unsigned char frame_type, TinyFrameListener cb) int TF_AddTypeListener(unsigned char frame_type, TinyFrameListener cb)
{ {
int i; int i;
for (i = 0; i < TF_MAX_TYPE_LST; i++) { for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn == NULL) { if (tf.type_listeners[i].fn == NULL) {
tf.type_listeners[i].fn = cb; tf.type_listeners[i].fn = cb;
tf.type_listeners[i].type = frame_type; tf.type_listeners[i].type = frame_type;
return TF_MAX_ID_LST + i; return TF_MAX_ID_LST + i;
} }
} }
return TF_ERROR; return TF_ERROR;
} }
/**
* Register a generic listener.
*
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddGenericListener(TinyFrameListener cb) int TF_AddGenericListener(TinyFrameListener cb)
{ {
int i; int i;
for (i = 0; i < TF_MAX_GEN_LST; i++) { for (i = 0; i < TF_MAX_GEN_LST; i++) {
if (tf.generic_listeners[i].fn == NULL) { if (tf.generic_listeners[i].fn == NULL) {
tf.generic_listeners[i].fn = cb; tf.generic_listeners[i].fn = cb;
return TF_MAX_ID_LST + TF_MAX_TYPE_LST + i; return TF_MAX_ID_LST + TF_MAX_TYPE_LST + i;
} }
} }
return TF_ERROR; return TF_ERROR;
} }
/**
* Remove a rx callback function by the index received when registering it
*
* @param index - index in the callbacks table
*/
void TF_RemoveListener(unsigned int index) void TF_RemoveListener(unsigned int index)
{ {
// all listener arrays share common "address space" // all listener arrays share common "address space"
if (index < TF_MAX_ID_LST) { if (index < TF_MAX_ID_LST) {
tf.id_listeners[index].fn = NULL; tf.id_listeners[index].fn = NULL;
} }
else if (index < TF_MAX_ID_LST + TF_MAX_TYPE_LST) { else if (index < TF_MAX_ID_LST + TF_MAX_TYPE_LST) {
tf.type_listeners[index - TF_MAX_ID_LST].fn = NULL; tf.type_listeners[index - TF_MAX_ID_LST].fn = NULL;
} }
else if (index < TF_MAX_ID_LST + TF_MAX_TYPE_LST + TF_MAX_GEN_LST) { else if (index < TF_MAX_ID_LST + TF_MAX_TYPE_LST + TF_MAX_GEN_LST) {
tf.generic_listeners[index - TF_MAX_ID_LST - TF_MAX_TYPE_LST].fn = NULL; tf.generic_listeners[index - TF_MAX_ID_LST - TF_MAX_TYPE_LST].fn = NULL;
} }
} }
void TF_RemoveIdListener(unsigned int frame_id) void TF_RemoveIdListener(unsigned int frame_id)
{ {
int i; int i;
for (i = 0; i < TF_MAX_ID_LST; i++) { for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn != NULL && tf.id_listeners[i].id == frame_id) { if (tf.id_listeners[i].fn != NULL && tf.id_listeners[i].id == frame_id) {
tf.id_listeners[i].fn = NULL; tf.id_listeners[i].fn = NULL;
} }
} }
} }
void TF_RemoveTypeListener(unsigned char type) void TF_RemoveTypeListener(unsigned char type)
{ {
int i; int i;
for (i = 0; i < TF_MAX_TYPE_LST; i++) { for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn != NULL && tf.type_listeners[i].type == type) { if (tf.type_listeners[i].fn != NULL && tf.type_listeners[i].type == type) {
tf.type_listeners[i].fn = NULL; tf.type_listeners[i].fn = NULL;
} }
} }
} }
/**
* Remove a callback by the function pointer
*
* @param cb - callback function to remove
*/
void TF_RemoveListenerFn(TinyFrameListener cb) void TF_RemoveListenerFn(TinyFrameListener cb)
{ {
int i; int i;
for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn == cb) {
tf.id_listeners[i].fn = NULL;
}
}
for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn == cb) {
tf.type_listeners[i].fn = NULL;
}
}
for (i = 0; i < TF_MAX_GEN_LST; i++) {
if (tf.generic_listeners[i].fn == cb) {
tf.generic_listeners[i].fn = NULL;
}
}
}
for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn == cb) {
tf.id_listeners[i].fn = NULL;
}
}
for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn == cb) {
tf.type_listeners[i].fn = NULL;
}
}
for (i = 0; i < TF_MAX_GEN_LST; i++) {
if (tf.generic_listeners[i].fn == cb) {
tf.generic_listeners[i].fn = NULL;
}
}
}
/**
* Accept incoming bytes & parse frames
*
* @param buffer - byte buffer to process
* @param count - nr of bytes in the buffer
*/
void TF_Accept(const unsigned char *buffer, unsigned int count) void TF_Accept(const unsigned char *buffer, unsigned int count)
{ {
unsigned int i; unsigned int i;
for (i = 0; i < count; i++) { for (i = 0; i < count; i++) {
TF_AcceptChar(buffer[i]); TF_AcceptChar(buffer[i]);
} }
} }
/**
* Process a single received character
*
* @param c - rx character
*/
void TF_AcceptChar(unsigned char c) void TF_AcceptChar(unsigned char c)
{ {
int i; int i;
bool rv, brk; bool rv, brk;
switch (tf.state) switch (tf.state)
{ {
case TFState_SOF: case TFState_SOF:
if (c == TF_SOF_BYTE) { if (c == TF_SOF_BYTE) {
tf.cksum = 0; tf.cksum = 0;
tf.state = TFState_ID; tf.state = TFState_ID;
}
break;
case TFState_ID:
tf.id = c;
tf.state = TFState_NOB;
break;
case TFState_NOB:
tf.nob = c + 1; // using 0..255 as 1..256
tf.state = TFState_PAYLOAD;
tf.rxi = 0;
break;
case TFState_PAYLOAD:
tf.pldbuf[tf.rxi++] = c;
if (tf.rxi == tf.nob) {
tf.state = TFState_CKSUM;
}
break;
case TFState_CKSUM:
tf.state = TFState_SOF;
if (tf.cksum == (unsigned int)c) {
// Add 0 at the end of the data in the buffer (useful if it was a string)
tf.pldbuf[tf.rxi] = '\0';
brk = false;
// Fire listeners
for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn && tf.id_listeners[i].id == tf.id) {
rv = tf.id_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
brk = true;
break;
}
}
}
if (!brk) {
for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn &&
tf.type_listeners[i].type == tf.pldbuf[0]) {
rv = tf.type_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
brk = true;
break;
}
}
}
}
if (!brk) {
for (i = 0; i < TF_MAX_GEN_LST; i++) {
if (tf.generic_listeners[i].fn) {
rv = tf.generic_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
break;
}
}
}
}
} else {
// Fail, return to base state
tf.state = TFState_SOF;
} }
break; break;
}
case TFState_ID:
tf.id = c;
tf.state = TFState_NOB;
break;
case TFState_NOB:
tf.nob = c + 1; // using 0..255 as 1..256
tf.state = TFState_PAYLOAD;
tf.rxi = 0;
break;
case TFState_PAYLOAD:
tf.pldbuf[tf.rxi++] = c;
if (tf.rxi == tf.nob) {
tf.state = TFState_CKSUM;
}
break;
case TFState_CKSUM:
tf.state = TFState_SOF;
if (tf.cksum == (unsigned int)c) {
// Add 0 at the end of the data in the buffer (useful if it was a string)
tf.pldbuf[tf.rxi] = '\0';
brk = false;
// Fire listeners
for (i = 0; i < TF_MAX_ID_LST; i++) {
if (tf.id_listeners[i].fn && tf.id_listeners[i].id == tf.id) {
rv = tf.id_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
brk = true;
break;
}
}
}
if (!brk) {
for (i = 0; i < TF_MAX_TYPE_LST; i++) {
if (tf.type_listeners[i].fn &&
tf.type_listeners[i].type == tf.pldbuf[0]) {
rv = tf.type_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
brk = true;
break;
}
}
}
}
if (!brk) {
for (i = 0; i < TF_MAX_GEN_LST; i++) {
if (tf.generic_listeners[i].fn) {
rv = tf.generic_listeners[i].fn(tf.id, tf.pldbuf, tf.nob);
if (rv) {
break;
}
}
}
}
} else {
// Fail, return to base state
tf.state = TFState_SOF;
}
break;
}
// Update the checksum // Update the checksum
tf.cksum ^= c; tf.cksum ^= c;
} }
/**
* Compose a frame
*
* @param outbuff - buffer to store the result in
* @param msgid - message ID is stored here, if not NULL
* @param payload - data buffer
* @param len - payload size in bytes, 0 to use strlen
* @param explicit_id - ID to use, -1 to chose next free
* @return nr of bytes in outbuff used by the frame, -1 on failure
*/
int TF_Compose(unsigned char *outbuff, unsigned int *msgid, int TF_Compose(unsigned char *outbuff, unsigned int *msgid,
const unsigned char *payload, unsigned int payload_len, const unsigned char *payload, unsigned int payload_len,
int explicit_id int explicit_id
) { ) {
unsigned int i; unsigned int i;
unsigned int id; unsigned int id;
int xor; int xor;
// sanitize len // sanitize len
if (payload_len > TF_MAX_PAYLOAD) return TF_ERROR; if (payload_len > TF_MAX_PAYLOAD) return TF_ERROR;
if (payload_len == 0) payload_len = strlen(payload); if (payload_len == 0) payload_len = strlen(payload);
// Gen ID // Gen ID
if (explicit_id == TF_NEXT_ID) { if (explicit_id == TF_NEXT_ID) {
id = tf.next_id++; id = tf.next_id++;
if (tf.peer_bit) { if (tf.peer_bit) {
id |= 0x80; id |= 0x80;
} }
if (tf.next_id > 0x7F) {
tf.next_id = 0;
}
} else {
id = explicit_id;
}
outbuff[0] = TF_SOF_BYTE;
outbuff[1] = id & 0xFF;
outbuff[2] = (payload_len - 1) & 0xFF; // use 0..255 as 1..256
memcpy(outbuff+3, payload, payload_len);
xor = 0;
for (i = 0; i < payload_len + 3; i++) {
xor ^= outbuff[i];
}
outbuff[payload_len + 3] = xor;
if (msgid != NULL) *msgid = id;
return payload_len + 4;
}
if (tf.next_id > 0x7F) {
tf.next_id = 0;
}
} else {
id = explicit_id;
}
outbuff[0] = TF_SOF_BYTE;
outbuff[1] = id & 0xFF;
outbuff[2] = (payload_len - 1) & 0xFF; // use 0..255 as 1..256
memcpy(outbuff+3, payload, payload_len);
xor = 0;
for (i = 0; i < payload_len + 3; i++) {
xor ^= outbuff[i];
}
outbuff[payload_len + 3] = xor;
if (msgid != NULL) *msgid = id;
return payload_len + 4;
}
/**
* Send a frame, and optionally attach an ID listener for response.
*
* @param payload - data to send
* @param payload_len - nr of bytes to send
* @return listener ID if listener was attached, else -1 (FT_ERROR)
*/
int TF_Send(const unsigned char *payload, int TF_Send(const unsigned char *payload,
unsigned int payload_len, unsigned int payload_len,
TinyFrameListener listener) TinyFrameListener listener,
unsigned int *id_ptr)
{ {
unsigned int msgid; unsigned int msgid;
int len; int len;
int lstid = TF_ERROR; int lstid = TF_ERROR;
len = TF_Compose(tf.sendbuf, &msgid, payload, payload_len, TF_NEXT_ID); len = TF_Compose(tf.sendbuf, &msgid, payload, payload_len, TF_NEXT_ID);
if (listener) lstid = TF_AddIdListener(msgid, listener); if (listener) lstid = TF_AddIdListener(msgid, listener);
TF_WriteImpl(tf.sendbuf, len); TF_WriteImpl(tf.sendbuf, len);
return lstid;
}
if (id_ptr) *id_ptr = msgid;
return lstid;
}
/**
* Send a response to a received message.
*
* @param payload - data to send
* @param payload_len - nr of bytes to send
* @param frame_id - ID of the original frame
*/
void TF_Respond(const unsigned char *payload, void TF_Respond(const unsigned char *payload,
unsigned int payload_len, unsigned int payload_len,
int frame_id) unsigned int frame_id)
{ {
int len; int len;
len = TF_Compose(tf.sendbuf, NULL, payload, payload_len, frame_id); len = TF_Compose(tf.sendbuf, NULL, payload, payload_len, frame_id);
TF_WriteImpl(tf.sendbuf, len); TF_WriteImpl(tf.sendbuf, len);
} }
int TF_Send1(const unsigned char b0, int TF_Send1(const unsigned char b0,
TinyFrameListener listener) TinyFrameListener listener,
unsigned int *id_ptr)
{ {
unsigned char b[] = {b0}; unsigned char b[] = {b0};
return TF_Send(b, 1, listener); return TF_Send(b, 1, listener, id_ptr);
} }
int TF_Send2(const unsigned char b0, int TF_Send2(const unsigned char b0,
const unsigned char b1, const unsigned char b1,
TinyFrameListener listener) TinyFrameListener listener,
unsigned int *id_ptr)
{ {
unsigned char b[] = {b0, b1}; unsigned char b[] = {b0, b1};
return TF_Send(b, 2, listener); return TF_Send(b, 2, listener, id_ptr);
} }

@ -20,64 +20,148 @@
# define TF_MAX_GEN_LST 4 # define TF_MAX_GEN_LST 4
#endif #endif
#define TF_NEXT_ID -1
#define TF_ERROR -1
/** /**
* TinyFrame receive callback type. * TinyFrame receive callback type.
*
* @param frame_id - ID of the received frame * @param frame_id - ID of the received frame
* @param buff - byte buffer with the payload * @param buff - byte buffer with the payload
* @param len - number of bytes in the buffer * @param len - number of bytes in the buffer
* @return true if the frame was consumed * @return true if the frame was consumed
*/ */
typedef bool (*TinyFrameListener)( typedef bool (*TinyFrameListener)(unsigned int frame_id,
unsigned int frame_id, const unsigned char *buff,
const unsigned char *buff, unsigned int len);
unsigned int len
);
// Forward declarations (comments in .c) /**
* Initialize the TinyFrame engine.
* This can also be used to completely reset it (removing all listeners etc)
* @param peer_bit - peer bit to use for self
*/
void TF_Init(bool peer_bit);
/**
* Reset the frame parser state machine.
*/
void TF_ResetParser(void); void TF_ResetParser(void);
void TF_Init(bool peer_bit);
/**
* Accept incoming bytes & parse frames
* @param buffer - byte buffer to process
* @param count - nr of bytes in the buffer
*/
void TF_Accept(const unsigned char *buffer, unsigned int count); void TF_Accept(const unsigned char *buffer, unsigned int count);
/**
* Accept a single incoming byte
* @param c - a received char
*/
void TF_AcceptChar(unsigned char c); void TF_AcceptChar(unsigned char c);
// Add?Listener all return a unique listener ID /**
* Register a frame type listener.
* @param frame_type - frame ID to listen for
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddIdListener(unsigned int frame_id, TinyFrameListener cb); int TF_AddIdListener(unsigned int frame_id, TinyFrameListener cb);
/**
* Register a frame type listener.
* @param frame_type - frame type to listen for
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddTypeListener(unsigned char frame_type, TinyFrameListener cb); int TF_AddTypeListener(unsigned char frame_type, TinyFrameListener cb);
/**
* Register a generic listener.
* @param cb - callback
* @return slot index (for removing), or TF_ERROR (-1)
*/
int TF_AddGenericListener(TinyFrameListener cb); int TF_AddGenericListener(TinyFrameListener cb);
/**
* Remove any listener by the index received when registering it
* @param index - index in the callbacks table
*/
void TF_RemoveListener(unsigned int index); void TF_RemoveListener(unsigned int index);
/**
* Remove a listener by the message ID it's registered for
* @param frame_id - the frame we're listening for
*/
void TF_RemoveIdListener(unsigned int frame_id); void TF_RemoveIdListener(unsigned int frame_id);
/**
* Remove a listener by type.
* @param type - the type it's registered for
*/
void TF_RemoveTypeListener(unsigned char type); void TF_RemoveTypeListener(unsigned char type);
void TF_RemoveListenerFn(TinyFrameListener cb); // search all listener types
#define TF_NEXT_ID -1 /**
#define TF_ERROR -1 * Remove a callback by the function pointer
* @param cb - callback function to remove
*/
void TF_RemoveListenerFn(TinyFrameListener cb); // search all listener types
// returns nr of bytes in the output buffer used, or TF_ERROR /**
* Compose a frame
*
* @param outbuff - buffer to store the result in
* @param msgid - message ID is stored here, if not NULL
* @param payload - data buffer
* @param len - payload size in bytes, 0 to use strlen
* @param explicit_id - ID to use, TF_NEXT_ID (-1) to chose next free
* @return nr of bytes in outbuff used by the frame, TF_ERROR (-1) on failure
*/
int TF_Compose(unsigned char *outbuff, unsigned int *msgid, int TF_Compose(unsigned char *outbuff, unsigned int *msgid,
const unsigned char *payload, unsigned int payload_len, const unsigned char *payload, unsigned int payload_len,
int explicit_id); int explicit_id);
// returns listener ID (-1 if listener is NULL - does not indicate error) /**
* Send a frame, and optionally attach an ID listener for response.
*
* @param payload - data to send
* @param payload_len - nr of bytes to send
* @param id_ptr - store the ID here, NULL to don't store.
* The ID may be used to unbind the listener after a timeout.
* @return listener ID if listener was attached, else -1 (FT_ERROR).
* If the listener arg was NULL, returned -1 does not indicate an error.
*/
int TF_Send(const unsigned char *payload, int TF_Send(const unsigned char *payload,
unsigned int payload_len, unsigned int payload_len,
TinyFrameListener listener); TinyFrameListener listener, unsigned int *id_ptr);
/**
* A shorthand for TF_Send() with just one byte as the payload
*/
int TF_Send1(const unsigned char b0, int TF_Send1(const unsigned char b0,
TinyFrameListener listener); TinyFrameListener listener, unsigned int *id_ptr);
/**
* A shorthand for TF_Send() with just 2 bytes as the payload
*/
int TF_Send2(const unsigned char b0, int TF_Send2(const unsigned char b0,
const unsigned char b1, const unsigned char b1,
TinyFrameListener listener); TinyFrameListener listener, unsigned int *id_ptr);
// Respond with the same ID /**
* Send a response to a received message.
*
* @param payload - data to send
* @param payload_len - nr of bytes to send
* @param frame_id - ID of the original frame
*/
void TF_Respond(const unsigned char *payload, void TF_Respond(const unsigned char *payload,
unsigned int payload_len, unsigned int payload_len,
int frame_id); unsigned int frame_id);
/** Write implementation for TF, to be provided by user code */ /**
* Write implementation for TF, to be provided by user code.
* This sends frames composed by TinyFrame to UART
*/
extern void TF_WriteImpl(const unsigned char *buff, unsigned int len); extern void TF_WriteImpl(const unsigned char *buff, unsigned int len);
#endif #endif

@ -42,9 +42,10 @@ void main()
printf("------ Simulate sending a message --------\n"); printf("------ Simulate sending a message --------\n");
// Send a message, not expecting any reply // Send a message
// Returns Listener ID (if the listener is not NULL, like here) // args - payload, length (0 = strlen), listener, id_ptr (for storing the frame ID)
TF_Send("Hello TinyFrame", 0, NULL); // (see the .h file for details)
TF_Send("Hello TinyFrame", 0, NULL, NULL);
// This builds the frame in an internal buffer and sends it to // This builds the frame in an internal buffer and sends it to
// TF_WriteImpl() // TF_WriteImpl()

Loading…
Cancel
Save