inj_line_id.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define INJ_LINE_GLITCH         2u    
#define INJ_LINE_IDLE_NS        10000u 
#define INJ_LINE_MIN_TX         20u   
#define INJ_LINE_MIN_AGREE_PCT  95u   
 
/* Bit 0 of a state is GP4, bit 1 GP5; 1 is high. */
#define INJ_LINE_GP4 0x1u
#define INJ_LINE_GP5 0x2u

typedef struct {
    uint32_t at;     /* sample index */
    uint8_t  state;
} inj_edge_t;
 
typedef enum {
    INJ_WIRING_NONE = 0,  /* no check run since reset                 */
    INJ_WIRING_OK,        /* GP4 is SDA, GP5 is SCL                   */
    INJ_WIRING_SWAPPED,   /* GP5 is SDA, GP4 is SCL                   */
    INJ_WIRING_IDLE,      /* both lines high, no traffic              */
    INJ_WIRING_LOW,       /* a line low for the whole window          */
    INJ_WIRING_NOISE,     /* edges, but no verdict                    */
} inj_wiring_t;
 
typedef struct {
    inj_wiring_t verdict;
    uint32_t     tx;          /* transactions seen whole              */
    uint32_t     agree_pct;   /* majority share of the named, %       */
    uint32_t     edges4;      /* level changes on GP4, after glitches */
    uint32_t     edges5;
    uint8_t      end_state;   /* the lines at the end of the window   */
    uint32_t     rate_ksps;   /* sample rate, ksample/s (as given)    */
    uint32_t     named;       /* transactions that name a line        */
} inj_line_result_t;

void inj_line_classify(uint8_t first, const inj_edge_t *edges, uint32_t n,
                       uint32_t samples, uint32_t rate_ksps,
                       inj_line_result_t *out);

const char *inj_wiring_name(inj_wiring_t v);
 
#ifdef __cplusplus
}
#endif