libserialport_internal.h

   1 /*
   2  * This file is part of the libserialport project.
   3  *
   4  * Copyright (C) 2014 Martin Ling <martin-libserialport@earth.li>
   5  * Copyright (C) 2014 Aurelien Jacobs <aurel@gnuage.org>
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Lesser General Public License as
   9  * published by the Free Software Foundation, either version 3 of the
  10  * License, or (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 #ifndef LIBSERIALPORT_LIBSERIALPORT_INTERNAL_H
  22 #define LIBSERIALPORT_LIBSERIALPORT_INTERNAL_H
  23
  24
  25 #ifdef __linux__
  26 /* For timeradd, timersub, timercmp, realpath. */
  27 #define _BSD_SOURCE 1 /* for glibc < 2.19 */
  28 #define _DEFAULT_SOURCE 1 /* for glibc >= 2.20 */
  29 /* For clock_gettime and associated types. */
  30 #define _POSIX_C_SOURCE 199309L
  31 #endif
  32
  33 #include <string.h>
  34 #include <sys/types.h>
  35 #include <sys/stat.h>
  36 #include <fcntl.h>
  37 #include <unistd.h>
  38 #include <stdlib.h>
  39 #include <errno.h>
  40 #include <stdio.h>
  41 #include <stdarg.h>
  42 #include <stdbool.h>
  43 #include <stdint.h>
  44 #ifdef _WIN32
  45 #include <windows.h>
  46 #include <tchar.h>
  47 #include <setupapi.h>
  48 #include <cfgmgr32.h>
  49 #undef DEFINE_GUID
  50 #define DEFINE_GUID(name,l,w1,w2,b1,b2,b3,b4,b5,b6,b7,b8) \
  51         static const GUID name = { l,w1,w2,{ b1,b2,b3,b4,b5,b6,b7,b8 } }
  52 #include <usbioctl.h>
  53 #include <usbiodef.h>
  54 #include "windows_ddk.h"
  55 #else
  56 #include <limits.h>
  57 #include <termios.h>
  58 #include <sys/ioctl.h>
  59 #include <sys/time.h>
  60 #include <time.h>
  61 #include <poll.h>
  62 #endif
  63 #ifdef __APPLE__
  64 #include <CoreFoundation/CoreFoundation.h>
  65 #include <IOKit/IOKitLib.h>
  66 #include <IOKit/serial/IOSerialKeys.h>
  67 #include <IOKit/serial/ioss.h>
  68 #include <sys/syslimits.h>
  69 #include <mach/mach_time.h>
  70 #endif
  71 #ifdef __linux__
  72 #include <dirent.h>
  73 /* Android only has linux/serial.h from platform 21 onwards. */
  74 #if !(defined(__ANDROID__) && (__ANDROID_API__ < 21))
  75 #include <linux/serial.h>
  76 #endif
  77 #include "linux_termios.h"
  78
  79 /* TCGETX/TCSETX is not available everywhere. */
  80 #if defined(TCGETX) && defined(TCSETX) && defined(HAVE_STRUCT_TERMIOX)
  81 #define USE_TERMIOX
  82 #endif
  83 #endif
  84
  85 /* TIOCINQ/TIOCOUTQ is not available everywhere. */
  86 #if !defined(TIOCINQ) && defined(FIONREAD)
  87 #define TIOCINQ FIONREAD
  88 #endif
  89 #if !defined(TIOCOUTQ) && defined(FIONWRITE)
  90 #define TIOCOUTQ FIONWRITE
  91 #endif
  92
  93 /*
  94  * O_CLOEXEC is not available everywhere, fallback to not setting the
  95  * flag on those systems.
  96  */
  97 #ifndef _WIN32
  98 #ifndef O_CLOEXEC
  99 #define O_CLOEXEC 0
 100 #endif
 101 #endif
 102
 103 /* Non-standard baudrates are not available everywhere. */
 104 #if (defined(HAVE_TERMIOS_SPEED) || defined(HAVE_TERMIOS2_SPEED)) && HAVE_DECL_BOTHER
 105 #define USE_TERMIOS_SPEED
 106 #endif
 107
 108 struct sp_port {
 109         char *name;
 110         char *description;
 111         enum sp_transport transport;
 112         int usb_bus;
 113         int usb_address;
 114         int usb_vid;
 115         int usb_pid;
 116         char *usb_manufacturer;
 117         char *usb_product;
 118         char *usb_serial;
 119         char *bluetooth_address;
 120 #ifdef _WIN32
 121         char *usb_path;
 122         HANDLE hdl;
 123         COMMTIMEOUTS timeouts;
 124         OVERLAPPED write_ovl;
 125         OVERLAPPED read_ovl;
 126         OVERLAPPED wait_ovl;
 127         DWORD events;
 128         BYTE *write_buf;
 129         DWORD write_buf_size;
 130         BOOL writing;
 131         BOOL wait_running;
 132 #else
 133         int fd;
 134 #endif
 135 };
 136
 137 struct sp_port_config {
 138         int baudrate;
 139         int bits;
 140         enum sp_parity parity;
 141         int stopbits;
 142         enum sp_rts rts;
 143         enum sp_cts cts;
 144         enum sp_dtr dtr;
 145         enum sp_dsr dsr;
 146         enum sp_xonxoff xon_xoff;
 147 };
 148
 149 struct port_data {
 150 #ifdef _WIN32
 151         DCB dcb;
 152 #else
 153         struct termios term;
 154         int controlbits;
 155         int termiox_supported;
 156         int rts_flow;
 157         int cts_flow;
 158         int dtr_flow;
 159         int dsr_flow;
 160 #endif
 161 };
 162
 163 #ifdef _WIN32
 164 typedef HANDLE event_handle;
 165 #else
 166 typedef int event_handle;
 167 #endif
 168
 169 /* Standard baud rates. */
 170 #ifdef _WIN32
 171 #define BAUD_TYPE DWORD
 172 #define BAUD(n) {CBR_##n, n}
 173 #else
 174 #define BAUD_TYPE speed_t
 175 #define BAUD(n) {B##n, n}
 176 #endif
 177
 178 struct std_baudrate {
 179         BAUD_TYPE index;
 180         int value;
 181 };
 182
 183 #define ARRAY_SIZE(x) (sizeof(x) / sizeof(x[0]))
 184
 185 extern void (*sp_debug_handler)(const char *format, ...);
 186
 187 /* Debug output macros. */
 188 #define DEBUG_FMT(fmt, ...) do { \
 189         if (sp_debug_handler) \
 190                 sp_debug_handler(fmt ".\n", __VA_ARGS__); \
 191 } while (0)
 192 #define DEBUG(msg) DEBUG_FMT(msg, NULL)
 193 #define DEBUG_ERROR(err, msg) DEBUG_FMT("%s returning " #err ": " msg, __func__)
 194 #define DEBUG_FAIL(msg) do {               \
 195         char *errmsg = sp_last_error_message(); \
 196         DEBUG_FMT("%s returning SP_ERR_FAIL: " msg ": %s", __func__, errmsg); \
 197         sp_free_error_message(errmsg); \
 198 } while (0);
 199 #define RETURN() do { \
 200         DEBUG_FMT("%s returning", __func__); \
 201         return; \
 202 } while (0)
 203 #define RETURN_CODE(x) do { \
 204         DEBUG_FMT("%s returning " #x, __func__); \
 205         return x; \
 206 } while (0)
 207 #define RETURN_CODEVAL(x) do { \
 208         switch (x) { \
 209         case SP_OK: RETURN_CODE(SP_OK); \
 210         case SP_ERR_ARG: RETURN_CODE(SP_ERR_ARG); \
 211         case SP_ERR_FAIL: RETURN_CODE(SP_ERR_FAIL); \
 212         case SP_ERR_MEM: RETURN_CODE(SP_ERR_MEM); \
 213         case SP_ERR_SUPP: RETURN_CODE(SP_ERR_SUPP); \
 214         default: RETURN_CODE(SP_ERR_FAIL); \
 215         } \
 216 } while (0)
 217 #define RETURN_OK() RETURN_CODE(SP_OK);
 218 #define RETURN_ERROR(err, msg) do { \
 219         DEBUG_ERROR(err, msg); \
 220         return err; \
 221 } while (0)
 222 #define RETURN_FAIL(msg) do { \
 223         DEBUG_FAIL(msg); \
 224         return SP_ERR_FAIL; \
 225 } while (0)
 226 #define RETURN_INT(x) do { \
 227         int _x = x; \
 228         DEBUG_FMT("%s returning %d", __func__, _x); \
 229         return _x; \
 230 } while (0)
 231 #define RETURN_STRING(x) do { \
 232         char *_x = x; \
 233         DEBUG_FMT("%s returning %s", __func__, _x); \
 234         return _x; \
 235 } while (0)
 236 #define RETURN_POINTER(x) do { \
 237         void *_x = x; \
 238         DEBUG_FMT("%s returning %p", __func__, _x); \
 239         return _x; \
 240 } while (0)
 241 #define SET_ERROR(val, err, msg) do { DEBUG_ERROR(err, msg); val = err; } while (0)
 242 #define SET_FAIL(val, msg) do { DEBUG_FAIL(msg); val = SP_ERR_FAIL; } while (0)
 243 #define TRACE(fmt, ...) DEBUG_FMT("%s(" fmt ") called", __func__, __VA_ARGS__)
 244 #define TRACE_VOID() DEBUG_FMT("%s() called", __func__)
 245
 246 #define TRY(x) do { int retval = x; if (retval != SP_OK) RETURN_CODEVAL(retval); } while (0)
 247
 248 SP_PRIV struct sp_port **list_append(struct sp_port **list, const char *portname);
 249
 250 /* OS-specific Helper functions. */
 251 SP_PRIV enum sp_return get_port_details(struct sp_port *port);
 252 SP_PRIV enum sp_return list_ports(struct sp_port ***list);
 253
 254 #endif