link_update_host.h

Go to the documentation of this file.

#ifndef RCBENCH_LINK_UPDATE_HOST_H
#define RCBENCH_LINK_UPDATE_HOST_H
 
#include <stdbool.h>
#include <stdint.h>
 
#include "link_host.h"
#include "link_pages.h"
#include "link_port.h"
#include "link_sha256.h"
#include "link_update_image.h"
 
#ifdef __cplusplus
extern "C" {
#endif

#define LINK_UPH_HASH_STEP   8192u
#define LINK_UPH_LOST_MS     4000u
#define LINK_UPH_RESTARTS    3u
#define LINK_UPH_BLOCK_TRIES 3u
#define LINK_UPH_BUSY_MS     10000u
#define LINK_UPH_HASH_MS     10000u
#define LINK_UPH_SETTLE_MS   500u
#define LINK_UPH_CONFIRM_MS  12000u

typedef enum {
    LINK_UPH_IDLE = 0,
    LINK_UPH_CHECK_HASH,  
    LINK_UPH_CHECK_ASK,   
    LINK_UPH_CHECK_WAIT,  
    LINK_UPH_PREPARE,     
    LINK_UPH_BEGIN,
    LINK_UPH_SEND,        
    LINK_UPH_RESYNC,      
    LINK_UPH_FINISH,
    LINK_UPH_VERIFY,
    LINK_UPH_ACTIVATE,
    LINK_UPH_RESTARTING,  
    LINK_UPH_BUY,
    LINK_UPH_DONE,        
} link_uph_phase_t;

typedef enum {
    LINK_UPH_NONE = 0,     
    LINK_UPH_SAME,         
    LINK_UPH_DIFFERENT,    
    LINK_UPH_TRIAL,        
    LINK_UPH_NEEDS_USB,    
    LINK_UPH_NO_ANSWER,    
    LINK_UPH_REFUSED,      
    LINK_UPH_BAD_DIGEST,   
    LINK_UPH_BUSY,         
    LINK_UPH_RESTARTED_OUT, 
    LINK_UPH_NOT_STARTED,  
    LINK_UPH_UPDATED,      
} link_uph_result_t;

typedef struct {
    const uint8_t *img;
    uint32_t       len;
    int32_t        flag_at;   
 
    link_uph_phase_t phase;
    uint8_t  result;          
    uint8_t  error;           
    bool     missing;         
    uint8_t  restarts;                  
    uint8_t  block_tries;               
    uint8_t  after_resync;    
    bool     aborted;         
 
    uint8_t  build[LINK_SHA256_BYTES];   
    uint8_t  expect[LINK_SHA256_BYTES];  
    uint8_t  digest[LINK_SHA256_BYTES];  
    link_image_hash_t hash;             
 
    uint16_t block;           
    uint16_t blocks;                    
    uint16_t slot;            
    uint16_t block_tried;     
    bool     busy;            
    uint32_t busy_ms;                   
    uint32_t since_ms;        
    uint32_t missing_ms;      
 
    bool     have_ident;
    uint16_t ident[LINK_ID_COUNT]; 
} link_uph_t;

void link_uph_check(link_uph_t *u, const uint8_t *img, uint32_t len,
                    uint32_t now_ms);

void link_uph_update(link_uph_t *u, const uint8_t *img, uint32_t len,
                     uint32_t now_ms);

void link_uph_confirm(link_uph_t *u, uint32_t now_ms);

link_uph_phase_t link_uph_step(link_uph_t *u, link_host_t *h,
                               const link_port_t *port);

uint16_t link_uph_permille(const link_uph_t *u);

typedef struct {
    bool told;   
    bool owed;   
} link_uph_mismatch_t;

bool link_uph_mismatch_probe(link_uph_mismatch_t *m, bool mismatch);

bool link_uph_mismatch_answers(const link_uph_mismatch_t *m);

void link_uph_mismatch_rearm(link_uph_mismatch_t *m);
 
#ifdef __cplusplus
}
#endif
 
#endif /* RCBENCH_LINK_UPDATE_HOST_H */