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;

// Documentation is in source file.
typedef bool (*mip_send_callback)(struct mip_interface* device, const uint8_t* data, size_t length);
typedef bool (*mip_recv_callback)(struct mip_interface* device, uint8_t* buffer, size_t max_length, timeout_type wait_time, size_t* out_length, timestamp_type* timestamp_out);
typedef bool (*mip_update_callback)(struct mip_interface* device, timeout_type timeout);


typedef struct mip_interface
{
    mip_parser          _parser;          
    mip_cmd_queue       _queue;           
    mip_dispatcher      _dispatcher;      
    unsigned int        _max_update_pkts; 
    mip_send_callback   _send_callback;   
    mip_recv_callback   _recv_callback;   
    mip_update_callback _update_callback; 
    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,
    mip_send_callback send, mip_recv_callback recv,
    mip_update_callback update, void* user_pointer
);

//
// Communications
//

bool mip_interface_send_to_device(mip_interface* device, const uint8_t* data, size_t length);
bool mip_interface_recv_from_device(mip_interface* device, uint8_t* buffer, size_t max_length, timeout_type timeout, size_t* length_out, timestamp_type* now);
bool mip_interface_update(mip_interface* device, timeout_type wait_time);

bool mip_interface_default_update(mip_interface* device, timeout_type wait_time);
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_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, 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_recv_function(mip_interface* device, mip_recv_callback function);
void mip_interface_set_send_function(mip_interface* device, mip_send_callback function);
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_recv_callback   mip_interface_recv_function(const mip_interface* device);
mip_send_callback   mip_interface_send_function(const mip_interface* device);
mip_update_callback mip_interface_update_function(const 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);


#ifdef __cplusplus
} // namespace mip
} // namespace C
} // extern "C"
#endif