hitec_line.h

Go to the documentation of this file.

#ifndef HITEC_LINE_H
#define HITEC_LINE_H
 
#include <stdbool.h>
#include <stdint.h>
 
#include "hitec_pio.h"
#include "hitec_pre.h"
#include "hitec_wire.h"
 
#ifdef __cplusplus
extern "C" {
#endif

#define HITEC_LINE_GRACE_US 1000u
 
typedef enum {
    HITEC_LINE_OK = 0,
    HITEC_LINE_ERR_ARG,
    HITEC_LINE_ERR_CLOCK,
    HITEC_LINE_ERR_PIO,
    HITEC_LINE_ERR_DMA,
} hitec_line_err_t;

typedef struct {
    hitec_pio_clock_t clock;
    hitec_pio_run_t   run;
    void    *pio;
    uint32_t sm;
    uint32_t offset;
    uint32_t t_start_us;
    int8_t   dma_tx;
    int8_t   dma_rx;
    uint8_t  pin;
    uint8_t  family;
    uint8_t  drive;
    uint8_t  open;
    uint8_t  busy;
    uint8_t  aborted;
    uint8_t  kept;      
    uint8_t  cut;       
    uint32_t tx[HITEC_PIO_TX_WORDS];    
    uint32_t rx[HITEC_RX_MAX];          
    /* PRECHARGE: the sampler and its run. */
    uint8_t  rx_mode;   
    uint8_t  pre_on;    
    uint8_t  pre_held;  
    uint8_t  pre_stall; 
    int8_t   dma_pre;
    void    *pre_pio;
    uint32_t pre_sm;
    uint32_t pre_offset;
    uint32_t pre_len;
    uint32_t pre_t_us;      
    uint32_t pre_tx_us;     
    uint32_t pre_span_us;   
    uint32_t pre_ctrl;      
    uint32_t pre_pad;       
    uint16_t pre_prog[HITEC_PRE_PROGRAM_MAX];
    hitec_pre_timing_t pre_timing;
    hitec_pre_run_t    pre;
    uint32_t samples[HITEC_PRE_WORDS];
} hitec_line_t;

void hitec_line_init(hitec_line_t *line);

hitec_line_err_t hitec_line_open(hitec_line_t *line, unsigned pin,
                                 uint8_t family, uint8_t drive);

hitec_line_err_t hitec_line_open_rx(hitec_line_t *line, unsigned pin,
                                    uint8_t family, uint8_t drive,
                                    uint8_t rx);

uint8_t hitec_line_rx_mode(const hitec_line_t *line);

void hitec_line_close(hitec_line_t *line);

bool hitec_line_is_open(const hitec_line_t *line);

bool hitec_line_busy(const hitec_line_t *line);

uint32_t hitec_line_bit_ns(const hitec_line_t *line);

void hitec_line_abort(hitec_line_t *line);

bool hitec_line_start(void *ctx, const hitec_xfer_t *xfer);
bool hitec_line_poll(void *ctx, hitec_capture_t *out);
uint32_t hitec_line_now_us(void *ctx);

hitec_driver_t hitec_line_driver(hitec_line_t *line);
 
#ifdef __cplusplus
}
#endif
 
#endif /* HITEC_LINE_H */