sense_map_link.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
 
#include "link_pages.h"
#include "sense_link.h"
 
#ifdef __cplusplus
extern "C" {
#endif

#define SENSE_MAP_LINK_SETTLE_MS SENSE_LINK_SETTLE_MS
#define SENSE_MAP_LINK_READ_MS 500u
#define SENSE_MAP_LINK_EVENT_GAP_MS SENSE_LINK_EVENT_GAP_MS
 
#define SENSE_MAP_LINK_ACK       SENSE_LINK_ACK
#define SENSE_MAP_LINK_NO_ANSWER SENSE_LINK_NO_ANSWER

enum {
    SENSE_MAP_LINK_EV_REFUSED = 0x01,
    SENSE_MAP_LINK_EV_DARK    = 0x02,
    SENSE_MAP_LINK_EV_SILENT  = 0x04,
    SENSE_MAP_LINK_EV_WRONG   = 0x08,
};

typedef enum {
    SENS_PART_UNKNOWN = 0,  
    SENS_PART_PENDING,      
    SENS_PART_SEARCHING,    
    SENS_PART_ONLINE,       
    SENS_PART_SILENT,       
    SENS_PART_WRONG,        
    SENS_PART_REFUSED,      
    SENS_PART_DARK,         
    SENS_PART_SAME_ADDR,    
    SENS_PART_OLD,          
    SENS_PART_NO_BUS,       
    SENS_PART_COUNT
} sens_part_t;

typedef struct {
    uint16_t regs[LINK_SM_KEPT];  
    uint8_t  dark;                
    uint8_t  i228_addr;
    bool     nobus;
} sense_map_want_t;

typedef enum {
    SENSE_MAP_LINK_OP_NONE = 0,
    SENSE_MAP_LINK_OP_READ,     
    SENSE_MAP_LINK_OP_WRITE,    
    SENSE_MAP_LINK_OP_STATUS,   
} sense_map_link_op_kind_t;

typedef struct {
    sense_map_link_op_kind_t kind;
    bool     write;
    uint8_t  page;
    uint8_t  off, n;
    const uint16_t *regs;     
} sense_map_link_op_t;

typedef struct {
    bool     up;              
    bool     page;            
    bool     known;           
 
    bool     want_set;
    uint16_t want[LINK_SM_KEPT];  
    uint8_t  dark;                      
    uint8_t  clash;           
    uint8_t  fitted;          
    bool     nobus;           
    uint32_t want_ms;                   
 
    uint16_t held[LINK_SM_KEPT];
    bool     refused;         
    bool     reread;          
    bool     forced;          
    uint32_t setup_ms;        
 
    sense_map_link_op_kind_t pending;
    bool     asked;
    uint32_t asked_ms;
    bool     have_status;     
    uint16_t ids[LINK_SM_PARTS];        
    uint16_t wrong_id[LINK_SM_PARTS];  
    uint16_t flags;                     
    uint16_t was_flags;                 
 
    bool     silent_told[LINK_SM_PARTS];
    bool     online_seen[LINK_SM_PARTS];
    uint8_t  ev_parts[4];     
    uint8_t  events;                    
    bool     told;            
    uint32_t told_ms;                   
} sense_map_link_t;

void sense_map_link_init(sense_map_link_t *s);

void sense_map_link_lost(sense_map_link_t *s);

void sense_map_link_came_up(sense_map_link_t *s, uint16_t minor,
                            uint32_t now_ms);

void sense_map_link_want(sense_map_link_t *s, const sense_map_want_t *w,
                         uint32_t now_ms);

bool sense_map_link_next(sense_map_link_t *s, uint32_t now_ms, bool idle,
                         sense_map_link_op_t *op);

void sense_map_link_done(sense_map_link_t *s, int result,
                         const uint16_t *regs, uint32_t now_ms);

bool sense_map_link_page(const sense_map_link_t *s);

uint16_t sense_map_link_mirror_dmohm(const sense_map_link_t *s, unsigned ch);

bool sense_map_link_waits_for_pins(const sense_map_link_t *s,
                                   const sense_link_t *sl);

bool sense_map_link_held(const sense_map_link_t *s);

bool sense_map_link_in_force(const sense_map_link_t *s);

bool sense_map_link_take_reread(sense_map_link_t *s);

uint8_t sense_map_link_event(sense_map_link_t *s, uint32_t now_ms,
                             uint8_t *part, uint16_t *id);

bool sense_map_link_event_stands(const sense_map_link_t *s, uint8_t ev,
                                 uint8_t part);

void sense_map_link_event_back(sense_map_link_t *s, uint8_t ev,
                               uint8_t part);

sens_part_t sense_map_link_part(const sense_map_link_t *s,
                                const sense_link_t *sl, unsigned a,
                                unsigned mirror, uint32_t now_ms);

uint16_t sense_map_link_status(const sense_map_link_t *s,
                               const sense_link_t *sl, unsigned mirror,
                               uint32_t now_ms);

#define SENS_PART_OF(word, a) ((sens_part_t)(((word) >> (4u * (a))) & 0x0Fu))
 
#ifdef __cplusplus
}
#endif