MIP_SDK  v3.0.0-736-g212583cf
MicroStrain Communications Library for embedded systems
mip_parser.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include "mip_packet.h"
4 
5 #include "mip_types.h"
6 
7 #ifdef __cplusplus
8 namespace mip {
9 namespace C {
10 extern "C" {
11 #endif
12 
19 
20 
36 
37 
47 typedef bool (*mip_packet_callback)(void* user, const mip_packet_view* packet, mip_timestamp timestamp);
48 
49 
57 typedef struct mip_parser
58 {
59  mip_timestamp _start_time;
60  mip_timeout _timeout;
61 
62  mip_packet_callback _callback;
63  void* _callback_object;
64 
65 #ifdef MIP_ENABLE_DIAGNOSTICS
66  uint32_t _diag_bytes_read;
67  uint32_t _diag_bytes_skipped;
68  uint32_t _diag_packet_bytes;
69  uint32_t _diag_valid_packets;
70  uint32_t _diag_invalid_packets;
71  uint32_t _diag_timeouts;
72 #endif // MIP_ENABLE_DIAGNOSTICS
73 
74  uint16_t _buffered_length;
75  uint8_t _buffer[MIP_PACKET_LENGTH_MAX];
76 
77 } mip_parser;
78 
79 
80 
81 #define MIP_PARSER_DEFAULT_TIMEOUT_MS 100
82 
83 
84 void mip_parser_init(mip_parser* parser, mip_packet_callback callback, void* callback_object, mip_timeout timeout);
85 size_t mip_parser_parse(mip_parser* parser, const uint8_t* input_buffer, size_t input_length, mip_timestamp timestamp);
86 void mip_parser_flush(mip_parser* parser);
87 
88 void mip_parser_reset(mip_parser* parser);
89 
90 uint_least16_t mip_parser_get_write_ptr(mip_parser* parser, uint8_t** ptr_out);
91 
92 //
93 // Accessors
94 //
95 
97 void mip_parser_set_timeout(mip_parser* parser, mip_timeout timeout);
98 
99 void mip_parser_set_callback(mip_parser* parser, mip_packet_callback callback, void* callback_object);
101 void* mip_parser_callback_object(const mip_parser* parser);
102 
104 
105 
106 //
107 // Diagnostics
108 //
109 
110 #ifdef MIP_ENABLE_DIAGNOSTICS
111 
112 uint32_t mip_parser_diagnostic_bytes_read(const mip_parser* parser);
113 uint32_t mip_parser_diagnostic_bytes_skipped(const mip_parser* parser);
114 uint32_t mip_parser_diagnostic_packet_bytes(const mip_parser* parser);
115 
116 uint32_t mip_parser_diagnostic_valid_packets(const mip_parser* parser);
117 uint32_t mip_parser_diagnostic_invalid_packets(const mip_parser* parser);
118 uint32_t mip_parser_diagnostic_timeouts(const mip_parser* parser);
119 
120 #endif // MIP_ENABLE_DIAGNOSTICS
121 
122 
123 //
124 // Misc
125 //
126 
127 mip_timeout mip_timeout_from_baudrate(uint32_t baudrate);
128 
132 
133 #ifdef __cplusplus
134 } // extern "C"
135 } // namespace C
136 } // namespace mip
137 #endif
mip_packet.h
mip::C::mip_parser_parse
size_t mip_parser_parse(mip_parser *parser, const uint8_t *input_buffer, size_t input_length, mip_timestamp timestamp)
Parse packets from a buffer.
Definition: mip_parser.c:185
mip
A collection of C++ classes and functions covering the full mip api.
Definition: commands_3dm.c:11
mip::C::mip_parser_set_callback
void mip_parser_set_callback(mip_parser *parser, mip_packet_callback callback, void *callback_object)
mip_parser_set_callback
Definition: mip_parser.c:462
mip::C::mip_parser_timeout
mip_timeout mip_parser_timeout(const mip_parser *parser)
Returns the packet timeout of the parser.
Definition: mip_parser.c:438
mip_types.h
mip::C::mip_parser_callback_object
void * mip_parser_callback_object(const mip_parser *parser)
mip_parser_callback
Definition: mip_parser.c:488
mip::C::mip_parser_set_timeout
void mip_parser_set_timeout(mip_parser *parser, mip_timeout timeout)
Changes the timeout of the MIP parser.
Definition: mip_parser.c:450
mip::C::mip_parser_current_timestamp
mip_timestamp mip_parser_current_timestamp(const mip_parser *parser)
Gets the timestamp of the last parsed packet.
Definition: mip_parser.c:511
mip::C::mip_packet_view
Structure representing a MIP Packet.
Definition: mip_packet.h:63
mip::C::mip_timeout
microstrain::C::microstrain_embedded_timestamp mip_timeout
Definition: mip_types.h:16
mip::C::mip_packet_callback
bool(* mip_packet_callback)(void *user, const mip_packet_view *packet, mip_timestamp timestamp)
Callback function which receives parsed MIP packets.
Definition: mip_parser.h:47
mip::C::mip_parser_flush
void mip_parser_flush(mip_parser *parser)
Processes all previously buffered data.
Definition: mip_parser.c:392
mip::C::mip_parser
MIP Parser state.
Definition: mip_parser.h:57
mip::C::mip_parser_callback
mip_packet_callback mip_parser_callback(const mip_parser *parser)
mip_parser_callback
Definition: mip_parser.c:475
mip::C::mip_parser_init
void mip_parser_init(mip_parser *parser, mip_packet_callback callback, void *callback_object, mip_timeout timeout)
Initializes the MIP parser.
Definition: mip_parser.c:30
mip::C::mip_parser_get_write_ptr
uint_least16_t mip_parser_get_write_ptr(mip_parser *parser, uint8_t **ptr_out)
Gets a pointer into which a small amount of data may be written for parsing.
Definition: mip_parser.c:425
mip::C::mip_parser_reset
void mip_parser_reset(mip_parser *parser)
Resets the MIP parser.
Definition: mip_parser.c:49
mip::C::mip_timeout_from_baudrate
mip_timeout mip_timeout_from_baudrate(uint32_t baudrate)
Computes an appropriate packet timeout for a given serial baud rate.
Definition: mip_parser.c:602
mip::C::MIP_PACKET_LENGTH_MAX
@ MIP_PACKET_LENGTH_MAX
Definition: mip_packet.h:85
mip::C::mip_timestamp
microstrain::C::microstrain_embedded_timestamp mip_timestamp
Definition: mip_types.h:15
mip::C::mip_parser
struct mip::C::mip_parser mip_parser
MIP Parser state.