link_bringup.h

Go to the documentation of this file.

 
#ifndef RCBENCH_LINK_BRINGUP_H
#define RCBENCH_LINK_BRINGUP_H
 
#include <stdbool.h>
#include <stdint.h>
 
#include "link_msg.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    /* The panel's view: what it asked, and what came back. */
    uint32_t polls;
    uint32_t replies;
    uint32_t timeouts;
    uint32_t mismatches;    
    uint32_t nacks;
    uint32_t rx_crc_errors; 
    uint32_t rx_resyncs;
 
    /* The IOmcu's view of itself, read from the STATUS page.  Absent
     * until a status read succeeds, which is itself informative. */
    bool     have_status;
    uint32_t dev_frames;    
    uint32_t dev_crc_errors;
    uint32_t dev_resyncs;
    bool     have_refused;
    uint32_t dev_refused;
 
    /* Identity, read once at link-up. */
    bool     have_identity;
    uint16_t proto_major;
    uint16_t proto_minor;
 
    /* Round trip: request sent to reply accepted. */
    uint32_t rt_samples;
    uint32_t rt_min_us;
    uint32_t rt_max_us;
    uint32_t rt_mean_us;
} link_bringup_t;

typedef enum {
    LINK_DIAG_OK = 0,
    LINK_DIAG_SILENT,
    LINK_DIAG_PROTOCOL_MISMATCH,
    LINK_DIAG_REPLIES_LOST,
    LINK_DIAG_CORRUPT,
    LINK_DIAG_STALE,
    LINK_DIAG_INTERMITTENT,
} link_diag_t;

link_diag_t link_bringup_diagnose(const link_bringup_t *b);

void link_bringup_window(const link_bringup_t *now,
                         const link_bringup_t *prev, link_bringup_t *out);

const char *link_diag_text(link_diag_t d);

const char *link_diag_hint(link_diag_t d);
 
/* ------------------------------------------------------------ status page */

uint8_t link_bringup_status_count(uint16_t minor);

bool link_bringup_take_status(link_bringup_t *b, const link_msg_t *st,
                              uint16_t *faults);
 
/* ------------------------------------------------------- round-trip stats */

void link_bringup_add_rtt(link_bringup_t *b, uint32_t us);
 
#ifdef __cplusplus
}
#endif
 
#endif /* RCBENCH_LINK_BRINGUP_H */