mip_interface.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
#include <stddef.h>
 
#include "mip_parser.h"
#include "mip_cmdqueue.h"
#include "mip_dispatch.h"
 
#ifdef __cplusplus
namespace mip{
namespace C {
extern "C" {
#endif
 
 
struct mip_interface;
 
typedef bool (*mip_update_callback)(struct mip_interface* device, bool blocking);
 
typedef struct mip_interface
{
    mip_parser           _parser;          
    mip_cmd_queue        _queue;           
    mip_dispatcher       _dispatcher;      
    unsigned int         _max_update_pkts; 
    mip_update_callback  _update_function; 
    void*                _user_pointer;    
} mip_interface;
 
void mip_interface_init(mip_interface* device, uint8_t* parse_buffer, size_t parse_buffer_size, timeout_type parse_timeout, timeout_type base_reply_timeout);
 
//
// Communications
//
 
remaining_count mip_interface_receive_bytes(mip_interface* device, const uint8_t* data, size_t length, timestamp_type timestamp);
void mip_interface_process_unparsed_packets(mip_interface* device);
bool mip_interface_update(mip_interface* device, bool blocking);
bool mip_interface_default_update(mip_interface* device, bool blocking);
 
bool mip_interface_send_to_device(mip_interface* device, const uint8_t* data, size_t length);
 
bool mip_interface_parse_callback(void* device, const mip_packet* packet, timestamp_type timestamp);
void mip_interface_receive_packet(mip_interface* device, const mip_packet* packet, timestamp_type timestamp);
 
//
// Commands
//
 
enum mip_cmd_result mip_interface_wait_for_reply(mip_interface* device, const mip_pending_cmd* cmd);
enum mip_cmd_result mip_interface_run_command(mip_interface* device, uint8_t descriptor_set, uint8_t field_descriptor, const uint8_t* payload, uint8_t payload_length);
enum mip_cmd_result mip_interface_run_command_with_response(mip_interface* device, uint8_t descriptor_set, uint8_t field_descriptor, const uint8_t* payload, uint8_t payload_length, uint8_t response_descriptor, uint8_t* response_data, uint8_t* response_length_inout);
enum mip_cmd_result mip_interface_run_command_packet(mip_interface* device, const mip_packet* packet, mip_pending_cmd* cmd);
 
bool mip_interface_start_command_packet(mip_interface* device, const mip_packet* packet, mip_pending_cmd* cmd);
 
//
// Data Callbacks
//
 
void mip_interface_register_packet_callback(mip_interface* device, mip_dispatch_handler* handler, uint8_t descriptor_set, bool after_fields, mip_dispatch_packet_callback callback, void* user_data);
void mip_interface_register_field_callback(mip_interface* device, mip_dispatch_handler* handler, uint8_t descriptor_set, uint8_t field_descriptor, mip_dispatch_field_callback callback, void* user_data);
void mip_interface_register_extractor(mip_interface* device, mip_dispatch_handler* handler, uint8_t descriptor_set, uint8_t field_descriptor, mip_dispatch_extractor callback, void* field_ptr);
 
//
// Accessors
//
 
void mip_interface_set_update_function(mip_interface* device, mip_update_callback function);
void mip_interface_set_user_pointer(mip_interface* device, void* pointer);
void mip_interface_set_max_packets_per_update(mip_interface* device, unsigned int max_packets);
unsigned int mip_interface_max_packets_per_update(const mip_interface* device);
 
mip_update_callback mip_interface_update_function(mip_interface* device);
void* mip_interface_user_pointer(const mip_interface* device);
mip_parser*    mip_interface_parser(mip_interface* device);
mip_cmd_queue* mip_interface_cmd_queue(mip_interface* device);
 
 
extern bool mip_interface_user_recv_from_device(mip_interface* device, uint8_t* buffer, size_t max_length, size_t* out_length, timestamp_type* timestamp_out);
 
 
extern bool mip_interface_user_send_to_device(mip_interface* device, const uint8_t* data, size_t length);
 
 
 
 
#ifdef __cplusplus
} // namespace mip
} // namespace C
} // extern "C"
#endif