feetech_reader.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2017 Inria
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser General
5  * Public License v2.1. See the file LICENSE in the top level directory for more
6  * details.
7  */
8 
9 #pragma once
10 
22 #include "feetech_protocol.h"
23 
24 #include <stdint.h>
25 #include <stdbool.h>
26 #include <stdlib.h>
27 
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31 
32 #define FEETECH_ACK_SIZE (6)
33 #define FEETECH_RESPONSE_SIZE(len) (6 + len)
34 
38 typedef struct {
39  const uint8_t *buffer;
40  size_t size;
42 
50 static inline void feetech_reader_init(feetech_reader_t *reader, const uint8_t *buffer, size_t size)
51 {
52  reader->buffer = buffer;
53  reader->size = size;
54 }
55 
64 
73 static inline bool feetech_reader_check_minsize(const feetech_reader_t *reader)
74 {
75  return 5 < reader->size;
76 }
77 
86 static inline bool feetech_reader_check_start(const feetech_reader_t *reader)
87 {
88  return
89  reader->buffer[0] == FEETECH_START &&
90  reader->buffer[1] == FEETECH_START;
91 }
92 
101 static inline bool feetech_reader_check_size(const feetech_reader_t *reader)
102 {
103  return reader->size == (size_t)(reader->buffer[3] + 4);
104 }
105 
114 static inline bool feetech_reader_check_sum(const feetech_reader_t *reader)
115 {
116  return feetech_reader_compute_sum(reader) == reader->buffer[reader->size - 1];
117 }
118 
128 
136 static inline uint8_t feetech_reader_get_id(const feetech_reader_t *reader)
137 {
138  return reader->buffer[2];
139 }
140 
148 static inline uint8_t feetech_reader_get_instr(const feetech_reader_t *reader)
149 {
150  return reader->buffer[4];
151 }
152 
160 static inline const uint8_t *feetech_reader_response_get_payload(const feetech_reader_t *reader)
161 {
162  return &reader->buffer[5];
163 }
164 
173 {
174  return reader->buffer[3] - 2;
175 }
176 
184 static inline const uint8_t *feetech_reader_write_get_payload(const feetech_reader_t *reader)
185 {
186  return &reader->buffer[6];
187 }
188 
196 static inline size_t feetech_reader_write_get_payload_size(const feetech_reader_t *reader)
197 {
198  return reader->buffer[3] - 3;
199 }
200 
208 static inline uint8_t feetech_reader_write_get_reg(const feetech_reader_t *reader)
209 {
210  return reader->buffer[5];
211 }
212 
220 static inline size_t feetech_reader_read_get_size(const feetech_reader_t *reader)
221 {
222  return reader->buffer[6];
223 }
224 
232 static inline uint8_t feetech_reader_read_get_reg(const feetech_reader_t *reader)
233 {
234  return reader->buffer[5];
235 }
236 
245 {
246  return reader->buffer[6];
247 }
248 
256 static inline uint8_t feetech_reader_sync_write_get_reg(const feetech_reader_t *reader)
257 {
258  return reader->buffer[5];
259 }
260 
269 
278 uint8_t feetech_reader_sync_write_item_get_id(const feetech_reader_t *reader, uint8_t index);
279 
288 const uint8_t *feetech_reader_sync_write_item_get_payload(const feetech_reader_t *reader, uint8_t index);
289 
290 #ifdef __cplusplus
291 }
292 #endif
293 
Feetech protocol definitions.
static uint8_t feetech_reader_write_get_reg(const feetech_reader_t *reader)
Get the packet's target register address (WRITE)
uint8_t feetech_reader_sync_write_item_get_id(const feetech_reader_t *reader, uint8_t index)
Get the packet item's device id (SYNC_WRITE)
size_t feetech_reader_sync_write_get_items_count(const feetech_reader_t *reader)
Get the packet items' count (SYNC_WRITE)
static bool feetech_reader_check_sum(const feetech_reader_t *reader)
Check if the computed sum and the sum of the packet are equal.
static size_t feetech_reader_sync_write_get_payload_size(const feetech_reader_t *reader)
Get the packet items' payload size (SYNC_WRITE)
static uint8_t feetech_reader_get_id(const feetech_reader_t *reader)
Get the packet's device id.
static bool feetech_reader_check_start(const feetech_reader_t *reader)
Check if the packet begins with 2 FEETECH_START bits.
bool feetech_reader_is_valid(const feetech_reader_t *reader)
Check if the packet is valid.
static uint8_t feetech_reader_read_get_reg(const feetech_reader_t *reader)
Get the packet's target register address (READ)
static uint8_t feetech_reader_sync_write_get_reg(const feetech_reader_t *reader)
Get the packet's target register address (SYNC_WRITE)
static size_t feetech_reader_read_get_size(const feetech_reader_t *reader)
Get the packet's READ size.
static void feetech_reader_init(feetech_reader_t *reader, const uint8_t *buffer, size_t size)
Initialize the Feetech packet reader.
static const uint8_t * feetech_reader_write_get_payload(const feetech_reader_t *reader)
Get the packet's payload (WRITE)
static const uint8_t * feetech_reader_response_get_payload(const feetech_reader_t *reader)
Get the packet's payload (response)
static uint8_t feetech_reader_get_instr(const feetech_reader_t *reader)
Get the packet's instruction code.
static bool feetech_reader_check_size(const feetech_reader_t *reader)
Check if the packet's size is the same as the buffer's size.
static size_t feetech_reader_response_get_payload_size(const feetech_reader_t *reader)
Get the packet's payload size (response)
static bool feetech_reader_check_minsize(const feetech_reader_t *reader)
Check if the packet has the minimum required size.
static size_t feetech_reader_write_get_payload_size(const feetech_reader_t *reader)
Get the packet's payload size (WRITE)
uint8_t feetech_reader_compute_sum(const feetech_reader_t *reader)
Compute the packet's sum.
const uint8_t * feetech_reader_sync_write_item_get_payload(const feetech_reader_t *reader, uint8_t index)
Get the packet item's payload (SYNC_WRITE)
Feetech packet reader struct.
const uint8_t * buffer
data buffer
size_t size
data buffer's size