80 #ifndef LIBSERIALPORT_LIBSERIALPORT_H
81 #define LIBSERIALPORT_LIBSERIALPORT_H
1208 #define SP_PACKAGE_VERSION_MAJOR 0
1211 #define SP_PACKAGE_VERSION_MINOR 1
1214 #define SP_PACKAGE_VERSION_MICRO 0
1217 #define SP_PACKAGE_VERSION_STRING "0.1.0"
1224 #define SP_LIB_VERSION_CURRENT 0
1227 #define SP_LIB_VERSION_REVISION 0
1230 #define SP_LIB_VERSION_AGE 0
1233 #define SP_LIB_VERSION_STRING "0:0:0"
void sp_free_event_set(struct sp_event_set *event_set)
Free a structure allocated by sp_new_event_set().
enum sp_return sp_set_config_xon_xoff(struct sp_port_config *config, enum sp_xonxoff xon_xoff)
Set the XON/XOFF configuration in a port configuration.
A system error occured while executing the operation.
enum sp_return sp_get_config_dsr(const struct sp_port_config *config, enum sp_dsr *dsr_ptr)
Get the DSR pin behaviour from a port configuration.
CTS used for flow control.
Operation completed successfully.
Hardware flow control using DTR/DSR signals.
int sp_get_micro_package_version(void)
Get the micro libserialport package version number.
enum sp_return sp_set_stopbits(struct sp_port *port, int stopbits)
Set the stop bits for the specified serial port.
enum sp_event * masks
Array of bitmasks indicating which events apply for each handle.
enum sp_return sp_set_config_flowcontrol(struct sp_port_config *config, enum sp_flowcontrol flowcontrol)
Set the flow control type in a port configuration.
void sp_free_error_message(char *message)
Free an error message returned by sp_last_error_message().
enum sp_return sp_get_port_handle(const struct sp_port *port, void *result_ptr)
Get the operating system handle for a port.
enum sp_return sp_set_rts(struct sp_port *port, enum sp_rts rts)
Set the RTS pin behaviour for the specified serial port.
An opaque structure representing the configuration for a serial port.
A set of handles to wait on for events.
enum sp_return sp_flush(struct sp_port *port, enum sp_buffer buffers)
Flush serial port buffers.
enum sp_return sp_input_waiting(struct sp_port *port)
Gets the number of bytes waiting in the input buffer.
enum sp_return sp_get_signals(struct sp_port *port, enum sp_signal *signals)
Gets the status of the control signals for the specified port.
Open port for read access.
Special value to indicate setting should be left alone.
A memory allocation failed while executing the operation.
enum sp_return sp_output_waiting(struct sp_port *port)
Gets the number of bytes waiting in the output buffer.
enum sp_return sp_nonblocking_read(struct sp_port *port, void *buf, size_t count)
Read bytes from the specified serial port, without blocking.
Open port for write access.
enum sp_return sp_end_break(struct sp_port *port)
Take the port transmit line out of the break state.
enum sp_return sp_set_flowcontrol(struct sp_port *port, enum sp_flowcontrol flowcontrol)
Set the flow control type for the specified serial port.
enum sp_return sp_get_port_by_name(const char *portname, struct sp_port **port_ptr)
Obtain a pointer to a new sp_port structure representing the named port.
void sp_set_debug_handler(void(*handler)(const char *format,...))
Set the handler function for library debugging messages.
enum sp_return sp_nonblocking_write(struct sp_port *port, const void *buf, size_t count)
Write bytes to the specified serial port, without blocking.
enum sp_return sp_new_event_set(struct sp_event_set **result_ptr)
Allocate storage for a set of events.
void sp_free_port_list(struct sp_port **ports)
Free a port list obtained from sp_list_ports().
int sp_get_major_package_version(void)
Get the major libserialport package version number.
enum sp_return sp_set_config_cts(struct sp_port_config *config, enum sp_cts cts)
Set the CTS pin behaviour in a port configuration.
enum sp_return sp_new_config(struct sp_port_config **config_ptr)
Allocate a port configuration structure.
XON/XOFF enabled for input and output.
enum sp_return sp_get_config_cts(const struct sp_port_config *config, enum sp_cts *cts_ptr)
Get the CTS pin behaviour from a port configuration.
char * sp_get_port_name(const struct sp_port *port)
Get the name of a port.
enum sp_return sp_get_config_xon_xoff(const struct sp_port_config *config, enum sp_xonxoff *xon_xoff_ptr)
Get the XON/XOFF configuration from a port configuration.
enum sp_return sp_set_config_rts(struct sp_port_config *config, enum sp_rts rts)
Set the RTS pin behaviour in a port configuration.
enum sp_return sp_set_xon_xoff(struct sp_port *port, enum sp_xonxoff xon_xoff)
Set the XON/XOFF configuration for the specified serial port.
The requested operation is not supported by this system or device.
enum sp_return sp_start_break(struct sp_port *port)
Put the port transmit line into the break state.
void * handles
Array of OS-specific handles.
RTS used for flow control.
enum sp_return sp_add_port_events(struct sp_event_set *event_set, const struct sp_port *port, enum sp_event mask)
Add events to a struct sp_event_set for a given port.
Invalid arguments were passed to the function.
Special value to indicate setting should be left alone.
enum sp_return sp_get_config_stopbits(const struct sp_port_config *config, int *stopbits_ptr)
Get the stop bits from a port configuration.
int sp_last_error_code(void)
Get the error code for a failed operation.
enum sp_return sp_close(struct sp_port *port)
Close the specified serial port.
enum sp_return sp_drain(struct sp_port *port)
Wait for buffered data to be transmitted.
sp_parity
Parity settings.
sp_mode
Port access modes.
int sp_get_minor_package_version(void)
Get the minor libserialport package version number.
enum sp_return sp_set_config_stopbits(struct sp_port_config *config, int stopbits)
Set the stop bits in a port configuration.
enum sp_return sp_set_bits(struct sp_port *port, int bits)
Set the data bits for the specified serial port.
enum sp_return sp_set_config_bits(struct sp_port_config *config, int bits)
Set the data bits in a port configuration.
const char * sp_get_lib_version_string(void)
Get the libserialport library version number as a string.
unsigned int count
Number of handles.
enum sp_return sp_set_baudrate(struct sp_port *port, int baudrate)
Set the baud rate for the specified serial port.
Special value to indicate setting should be left alone.
enum sp_return sp_set_parity(struct sp_port *port, enum sp_parity parity)
Set the parity setting for the specified serial port.
XON/XOFF enabled for input only.
enum sp_return sp_open(struct sp_port *port, enum sp_mode flags)
Open the specified serial port.
char * sp_last_error_message(void)
Get the error message for a failed operation.
enum sp_return sp_get_config_baudrate(const struct sp_port_config *config, int *baudrate_ptr)
Get the baud rate from a port configuration.
int sp_get_age_lib_version(void)
Get the "age" part of the libserialport library version number.
enum sp_return sp_set_config_baudrate(struct sp_port_config *config, int baudrate)
Set the baud rate in a port configuration.
enum sp_return sp_get_config(struct sp_port *port, struct sp_port_config *config)
Get the current configuration of the specified serial port.
sp_xonxoff
XON/XOFF flow control behaviour.
Special value to indicate setting should be left alone.
enum sp_return sp_get_config_rts(const struct sp_port_config *config, enum sp_rts *rts_ptr)
Get the RTS pin behaviour from a port configuration.
enum sp_return sp_set_dsr(struct sp_port *port, enum sp_dsr dsr)
Set the DSR pin behaviour for the specified serial port.
enum sp_return sp_set_config_parity(struct sp_port_config *config, enum sp_parity parity)
Set the parity setting in a port configuration.
void sp_default_debug_handler(const char *format,...)
Default handler function for library debugging messages.
enum sp_return sp_blocking_read(struct sp_port *port, void *buf, size_t count, unsigned int timeout)
Read bytes from the specified serial port, blocking until complete.
const char * sp_get_package_version_string(void)
Get the libserialport package version number as a string.
enum sp_return sp_blocking_write(struct sp_port *port, const void *buf, size_t count, unsigned int timeout)
Write bytes to the specified serial port, blocking until complete.
Software flow control using XON/XOFF characters.
sp_buffer
Buffer selection.
XON/XOFF enabled for output only.
int sp_get_revision_lib_version(void)
Get the "revision" part of the libserialport library version number.
sp_flowcontrol
Standard flow control combinations.
enum sp_return sp_set_cts(struct sp_port *port, enum sp_cts cts)
Set the CTS pin behaviour for the specified serial port.
enum sp_return sp_list_ports(struct sp_port ***list_ptr)
List the serial ports available on the system.
enum sp_return sp_get_config_bits(const struct sp_port_config *config, int *bits_ptr)
Get the data bits from a port configuration.
void sp_free_config(struct sp_port_config *config)
Free a port configuration structure.
enum sp_return sp_set_config(struct sp_port *port, const struct sp_port_config *config)
Set the configuration for the specified serial port.
enum sp_return sp_get_config_parity(const struct sp_port_config *config, enum sp_parity *parity_ptr)
Get the parity setting from a port configuration.
enum sp_return sp_set_config_dsr(struct sp_port_config *config, enum sp_dsr dsr)
Set the DSR pin behaviour in a port configuration.
Hardware flow control using RTS/CTS signals.
enum sp_return sp_copy_port(const struct sp_port *port, struct sp_port **copy_ptr)
Make a new copy of a sp_port structure.
void sp_free_port(struct sp_port *port)
Free a port structure obtained from sp_get_port_by_name() or sp_copy_port().
An opaque structure representing a serial port.
DTR used for flow control.
DSR used for flow control.
int sp_get_current_lib_version(void)
Get the "current" part of the libserialport library version number.
enum sp_return sp_get_config_dtr(const struct sp_port_config *config, enum sp_dtr *dtr_ptr)
Get the DTR pin behaviour from a port configuration.
Special value to indicate setting should be left alone.
Special value to indicate setting should be left alone.
enum sp_return sp_wait(struct sp_event_set *event_set, unsigned int timeout)
Wait for any of a set of events to occur.
enum sp_return sp_set_config_dtr(struct sp_port_config *config, enum sp_dtr dtr)
Set the DTR pin behaviour in a port configuration.
enum sp_return sp_set_dtr(struct sp_port *port, enum sp_dtr dtr)
Set the DTR pin behaviour for the specified serial port.