ser.h

Go to the documentation of this file.

#ifndef DRV_SER_H
#define DRV_SER_H

#include <kern/kfile.h>
#include <mware/fifobuf.h>
#include <cfg/compiler.h>

#if OS_HOSTED
    #include <cfg/macros.h> /* BV() */

    typedef uint16_t serstatus_t;

    /* Software errors */
    #define SERRF_RXFIFOOVERRUN  BV(0)  
    #define SERRF_RXTIMEOUT      BV(1)  
    #define SERRF_TXTIMEOUT      BV(2)  
    /* Hardware errors */
    #define SERRF_RXSROVERRUN    0      
    #define SERRF_FRAMEERROR     0      
    #define SERRF_PARITYERROR    0      
    #define SERRF_NOISEERROR     0      
    enum
    {
        SER_UART0,
        SER_UART1,

        SER_CNT  
    };

#else
    #include CPU_HEADER(ser)
#endif

#include <appconfig.h>



#define SERRF_RX \
    ( SERRF_RXFIFOOVERRUN \
    | SERRF_RXTIMEOUT \
    | SERRF_RXSROVERRUN \
    | SERRF_PARITYERROR \
    | SERRF_FRAMEERROR \
    | SERRF_NOISEERROR)
#define SERRF_TX  (SERRF_TXTIMEOUT)
/*\}*/

#define SER_MSB_FIRST 0
#define SER_LSB_FIRST 1
/*\}*/

#define SER_PARITY_NONE  0
#define SER_PARITY_EVEN  2
#define SER_PARITY_ODD   3
/*\}*/


struct SerialHardware;

extern const char * const serial_errors[8];

typedef struct Serial
{
    unsigned int unit;

#ifdef _DEBUG
    bool is_open;
#endif

    FIFOBuffer txfifo;
    FIFOBuffer rxfifo;
    /* \} */

#if CONFIG_SER_RXTIMEOUT != -1
    ticks_t rxtimeout;
#endif
#if CONFIG_SER_TXTIMEOUT != -1
    ticks_t txtimeout;
#endif

    volatile serstatus_t status;

    struct SerialHardware* hw;
} Serial;

typedef struct KFileSerial
{
    KFile fd;
    Serial *ser;
} KFileSerial;

#define KFT_SERIAL MAKE_ID('S', 'E', 'R', 'L')


INLINE KFileSerial * KFILESERIAL(KFile *fd)
{
    ASSERT(fd->_type == KFT_SERIAL);
    return (KFileSerial *)fd;
}

/* Function prototypes */
//extern int ser_getchar_nowait(struct Serial *port);

void ser_setbaudrate(struct KFileSerial *fd, unsigned long rate);
void ser_setparity(struct KFileSerial *fd, int parity);
void ser_settimeouts(struct KFileSerial *fd, mtime_t rxtimeout, mtime_t txtimeout);
void ser_resync(struct KFileSerial *fd, mtime_t delay);
int ser_getchar_nowait(struct KFileSerial *fd);

void ser_purgeRx(struct KFileSerial *fd);
void ser_purgeTx(struct KFileSerial *fd);
void ser_purge(struct KFileSerial *fd);
void ser_init(struct KFileSerial *fds, unsigned int unit);
void spimaster_init(KFileSerial *fds, unsigned int unit);


#define ser_getstatus(h)    ((h)->status)
#define ser_setstatus(h, x) ((h)->status = (x))
/* \} */

#endif /* DRV_SER_H */