nut-debian/drivers/serial.h
2022-07-10 09:23:45 +02:00

84 lines
2.8 KiB
C

#ifndef SERIAL_H_SEEN
#define SERIAL_H_SEEN 1
#include "attribute.h"
#include "config.h"
#if defined(HAVE_SYS_TERMIOS_H)
# include <sys/termios.h> /* for speed_t */
#else
# include <termios.h>
#endif /* HAVE_SYS_TERMIOS_H */
#include <unistd.h> /* for usleep() and useconds_t, latter also might be via <sys/types.h> */
#include <sys/types.h>
#include <sys/select.h> /* for suseconds_t */
/* limit the amount of spew that goes in the syslog when we lose the UPS */
#define SER_ERR_LIMIT 10 /* start limiting after 10 in a row */
#define SER_ERR_RATE 100 /* then only print every 100th error */
int ser_open_nf(const char *port);
int ser_open(const char *port);
int ser_set_speed_nf(int fd, const char *port, speed_t speed);
int ser_set_speed(int fd, const char *port, speed_t speed);
/* set the state of modem control lines */
int ser_set_dtr(int fd, int state);
int ser_set_rts(int fd, int state);
/* get the status of modem control lines */
int ser_get_dsr(int fd);
int ser_get_cts(int fd);
int ser_get_dcd(int fd);
int ser_flush_io(int fd);
int ser_close(int fd, const char *port);
ssize_t ser_send_char(int fd, unsigned char ch);
/* send the results of the format string with d_usec delay after each char */
ssize_t ser_send_pace(int fd, useconds_t d_usec, const char *fmt, ...)
__attribute__ ((__format__ (__printf__, 3, 4)));
/* send the results of the format string with no delay */
ssize_t ser_send(int fd, const char *fmt, ...)
__attribute__ ((__format__ (__printf__, 2, 3)));
/* send buflen bytes from buf with no delay */
ssize_t ser_send_buf(int fd, const void *buf, size_t buflen);
/* send buflen bytes from buf with d_usec delay after each char */
ssize_t ser_send_buf_pace(int fd, useconds_t d_usec, const void *buf,
size_t buflen);
ssize_t ser_get_char(int fd, void *ch, time_t d_sec, useconds_t d_usec);
ssize_t ser_get_buf(int fd, void *buf, size_t buflen, time_t d_sec, useconds_t d_usec);
/* keep reading until buflen bytes are received or a timeout occurs */
ssize_t ser_get_buf_len(int fd, void *buf, size_t buflen, time_t d_sec, useconds_t d_usec);
/* reads a line up to <endchar>, discarding anything else that may follow,
with callouts to the handler if anything matches the alertset */
ssize_t ser_get_line_alert(int fd, void *buf, size_t buflen, char endchar,
const char *ignset, const char *alertset, void handler (char ch),
time_t d_sec, useconds_t d_usec);
/* as above, only with no alertset handling (just a wrapper) */
ssize_t ser_get_line(int fd, void *buf, size_t buflen, char endchar,
const char *ignset, time_t d_sec, useconds_t d_usec);
ssize_t ser_flush_in(int fd, const char *ignset, int verbose);
/* unified failure reporting: call these often */
void ser_comm_fail(const char *fmt, ...)
__attribute__ ((__format__ (__printf__, 1, 2)));
void ser_comm_good(void);
#endif /* SERIAL_H_SEEN */