]>
Commit | Line | Data |
---|---|---|
74510d4b ML |
1 | /* |
2 | * This file is part of the libserialport project. | |
3 | * | |
4 | * Copyright (C) 2010-2012 Bert Vermeulen <bert@biot.com> | |
5 | * Copyright (C) 2010-2012 Uwe Hermann <uwe@hermann-uwe.de> | |
6 | * Copyright (C) 2013 Martin Ling <martin-libserialport@earth.li> | |
31b3a8f5 | 7 | * Copyright (C) 2013 Matthias Heidbrink <m-sigrok@heidbrink.biz> |
a93fb468 | 8 | * Copyright (C) 2014 Aurelien Jacobs <aurel@gnuage.org> |
74510d4b ML |
9 | * |
10 | * This program is free software: you can redistribute it and/or modify | |
11 | * it under the terms of the GNU Lesser General Public License as | |
12 | * published by the Free Software Foundation, either version 3 of the | |
13 | * License, or (at your option) any later version. | |
14 | * | |
15 | * This program is distributed in the hope that it will be useful, | |
16 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | * GNU General Public License for more details. | |
19 | * | |
20 | * You should have received a copy of the GNU Lesser General Public License | |
21 | * along with this program. If not, see <http://www.gnu.org/licenses/>. | |
22 | */ | |
23 | ||
f6a1fb65 | 24 | #include "libserialport.h" |
e33dcf90 | 25 | #include "libserialport_internal.h" |
da2748bf | 26 | |
6c6aebe7 | 27 | static const struct std_baudrate std_baudrates[] = { |
da2748bf ML |
28 | #ifdef _WIN32 |
29 | /* | |
30 | * The baudrates 50/75/134/150/200/1800/230400/460800 do not seem to | |
31 | * have documented CBR_* macros. | |
32 | */ | |
33 | BAUD(110), BAUD(300), BAUD(600), BAUD(1200), BAUD(2400), BAUD(4800), | |
34 | BAUD(9600), BAUD(14400), BAUD(19200), BAUD(38400), BAUD(57600), | |
eac329d2 | 35 | BAUD(115200), BAUD(128000), BAUD(256000), |
da2748bf | 36 | #else |
eac329d2 UH |
37 | BAUD(50), BAUD(75), BAUD(110), BAUD(134), BAUD(150), BAUD(200), |
38 | BAUD(300), BAUD(600), BAUD(1200), BAUD(1800), BAUD(2400), BAUD(4800), | |
39 | BAUD(9600), BAUD(19200), BAUD(38400), BAUD(57600), BAUD(115200), | |
40 | BAUD(230400), | |
da2748bf | 41 | #if !defined(__APPLE__) && !defined(__OpenBSD__) |
eac329d2 | 42 | BAUD(460800), |
da2748bf ML |
43 | #endif |
44 | #endif | |
45 | }; | |
46 | ||
6c6aebe7 UH |
47 | #define NUM_STD_BAUDRATES ARRAY_SIZE(std_baudrates) |
48 | ||
863b35e6 ML |
49 | void (*sp_debug_handler)(const char *format, ...) = sp_default_debug_handler; |
50 | ||
eb6ed20f ML |
51 | static enum sp_return get_config(struct sp_port *port, struct port_data *data, |
52 | struct sp_port_config *config); | |
e33dcf90 | 53 | |
eb6ed20f ML |
54 | static enum sp_return set_config(struct sp_port *port, struct port_data *data, |
55 | const struct sp_port_config *config); | |
80186526 | 56 | |
970f279a | 57 | SP_API enum sp_return sp_get_port_by_name(const char *portname, struct sp_port **port_ptr) |
d54e9004 ML |
58 | { |
59 | struct sp_port *port; | |
5a8810e2 | 60 | #ifndef NO_PORT_METADATA |
a93fb468 | 61 | enum sp_return ret; |
5a8810e2 | 62 | #endif |
5919c913 | 63 | int len; |
d54e9004 | 64 | |
c33efc48 ML |
65 | TRACE("%s, %p", portname, port_ptr); |
66 | ||
32b5ac05 | 67 | if (!port_ptr) |
c33efc48 | 68 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); |
32b5ac05 | 69 | |
77f262c4 ML |
70 | *port_ptr = NULL; |
71 | ||
d4babed2 | 72 | if (!portname) |
c33efc48 | 73 | RETURN_ERROR(SP_ERR_ARG, "Null port name"); |
d4babed2 | 74 | |
7890cef6 | 75 | DEBUG_FMT("Building structure for port %s", portname); |
ea667be7 | 76 | |
d54e9004 | 77 | if (!(port = malloc(sizeof(struct sp_port)))) |
c33efc48 | 78 | RETURN_ERROR(SP_ERR_MEM, "Port structure malloc failed"); |
d54e9004 | 79 | |
5919c913 ML |
80 | len = strlen(portname) + 1; |
81 | ||
eac329d2 | 82 | if (!(port->name = malloc(len))) { |
d54e9004 | 83 | free(port); |
c33efc48 | 84 | RETURN_ERROR(SP_ERR_MEM, "Port name malloc failed"); |
d54e9004 ML |
85 | } |
86 | ||
87 | memcpy(port->name, portname, len); | |
88 | ||
8f471c66 | 89 | #ifdef _WIN32 |
e31f2c6b | 90 | port->usb_path = NULL; |
8f471c66 ML |
91 | port->hdl = INVALID_HANDLE_VALUE; |
92 | #else | |
93 | port->fd = -1; | |
94 | #endif | |
95 | ||
e33dcf90 ML |
96 | port->description = NULL; |
97 | port->transport = SP_TRANSPORT_NATIVE; | |
98 | port->usb_bus = -1; | |
99 | port->usb_address = -1; | |
100 | port->usb_vid = -1; | |
101 | port->usb_pid = -1; | |
102 | port->usb_manufacturer = NULL; | |
103 | port->usb_product = NULL; | |
104 | port->usb_serial = NULL; | |
105 | port->bluetooth_address = NULL; | |
106 | ||
e4ce975a | 107 | #ifndef NO_PORT_METADATA |
e33dcf90 | 108 | if ((ret = get_port_details(port)) != SP_OK) { |
a93fb468 AJ |
109 | sp_free_port(port); |
110 | return ret; | |
111 | } | |
e4ce975a | 112 | #endif |
a93fb468 | 113 | |
77f262c4 ML |
114 | *port_ptr = port; |
115 | ||
c33efc48 | 116 | RETURN_OK(); |
d54e9004 ML |
117 | } |
118 | ||
970f279a | 119 | SP_API char *sp_get_port_name(const struct sp_port *port) |
1c5aae9d ML |
120 | { |
121 | TRACE("%p", port); | |
122 | ||
123 | if (!port) | |
124 | return NULL; | |
125 | ||
9caa2e86 | 126 | RETURN_STRING(port->name); |
1c5aae9d ML |
127 | } |
128 | ||
f1480939 | 129 | SP_API char *sp_get_port_description(const struct sp_port *port) |
a93fb468 AJ |
130 | { |
131 | TRACE("%p", port); | |
132 | ||
133 | if (!port || !port->description) | |
134 | return NULL; | |
135 | ||
9caa2e86 | 136 | RETURN_STRING(port->description); |
a93fb468 AJ |
137 | } |
138 | ||
ad036cc8 | 139 | SP_API enum sp_transport sp_get_port_transport(const struct sp_port *port) |
a93fb468 AJ |
140 | { |
141 | TRACE("%p", port); | |
142 | ||
143 | if (!port) | |
144 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
145 | ||
9caa2e86 | 146 | RETURN_INT(port->transport); |
a93fb468 AJ |
147 | } |
148 | ||
970f279a AJ |
149 | SP_API enum sp_return sp_get_port_usb_bus_address(const struct sp_port *port, |
150 | int *usb_bus,int *usb_address) | |
a93fb468 AJ |
151 | { |
152 | TRACE("%p", port); | |
153 | ||
154 | if (!port) | |
155 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
156 | if (port->transport != SP_TRANSPORT_USB) | |
157 | RETURN_ERROR(SP_ERR_ARG, "Port does not use USB transport"); | |
65172bef AJ |
158 | if (port->usb_bus < 0 || port->usb_address < 0) |
159 | RETURN_ERROR(SP_ERR_SUPP, "Bus and address values are not available"); | |
a93fb468 | 160 | |
dc422c04 UH |
161 | if (usb_bus) |
162 | *usb_bus = port->usb_bus; | |
163 | if (usb_address) | |
164 | *usb_address = port->usb_address; | |
a93fb468 AJ |
165 | |
166 | RETURN_OK(); | |
167 | } | |
168 | ||
970f279a AJ |
169 | SP_API enum sp_return sp_get_port_usb_vid_pid(const struct sp_port *port, |
170 | int *usb_vid, int *usb_pid) | |
a93fb468 AJ |
171 | { |
172 | TRACE("%p", port); | |
173 | ||
174 | if (!port) | |
175 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
176 | if (port->transport != SP_TRANSPORT_USB) | |
177 | RETURN_ERROR(SP_ERR_ARG, "Port does not use USB transport"); | |
65172bef AJ |
178 | if (port->usb_vid < 0 || port->usb_pid < 0) |
179 | RETURN_ERROR(SP_ERR_SUPP, "VID:PID values are not available"); | |
a93fb468 | 180 | |
dc422c04 UH |
181 | if (usb_vid) |
182 | *usb_vid = port->usb_vid; | |
183 | if (usb_pid) | |
184 | *usb_pid = port->usb_pid; | |
a93fb468 AJ |
185 | |
186 | RETURN_OK(); | |
187 | } | |
188 | ||
970f279a | 189 | SP_API char *sp_get_port_usb_manufacturer(const struct sp_port *port) |
a93fb468 AJ |
190 | { |
191 | TRACE("%p", port); | |
192 | ||
193 | if (!port || port->transport != SP_TRANSPORT_USB || !port->usb_manufacturer) | |
194 | return NULL; | |
195 | ||
9caa2e86 | 196 | RETURN_STRING(port->usb_manufacturer); |
a93fb468 AJ |
197 | } |
198 | ||
970f279a | 199 | SP_API char *sp_get_port_usb_product(const struct sp_port *port) |
a93fb468 AJ |
200 | { |
201 | TRACE("%p", port); | |
202 | ||
203 | if (!port || port->transport != SP_TRANSPORT_USB || !port->usb_product) | |
204 | return NULL; | |
205 | ||
9caa2e86 | 206 | RETURN_STRING(port->usb_product); |
a93fb468 AJ |
207 | } |
208 | ||
970f279a | 209 | SP_API char *sp_get_port_usb_serial(const struct sp_port *port) |
a93fb468 AJ |
210 | { |
211 | TRACE("%p", port); | |
212 | ||
213 | if (!port || port->transport != SP_TRANSPORT_USB || !port->usb_serial) | |
214 | return NULL; | |
215 | ||
9caa2e86 | 216 | RETURN_STRING(port->usb_serial); |
a93fb468 AJ |
217 | } |
218 | ||
970f279a | 219 | SP_API char *sp_get_port_bluetooth_address(const struct sp_port *port) |
a93fb468 AJ |
220 | { |
221 | TRACE("%p", port); | |
222 | ||
223 | if (!port || port->transport != SP_TRANSPORT_BLUETOOTH | |
224 | || !port->bluetooth_address) | |
225 | return NULL; | |
226 | ||
9caa2e86 | 227 | RETURN_STRING(port->bluetooth_address); |
a93fb468 AJ |
228 | } |
229 | ||
970f279a AJ |
230 | SP_API enum sp_return sp_get_port_handle(const struct sp_port *port, |
231 | void *result_ptr) | |
3c126654 | 232 | { |
00d8c56d | 233 | TRACE("%p, %p", port, result_ptr); |
3c126654 ML |
234 | |
235 | if (!port) | |
236 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
5f64c285 UH |
237 | if (!result_ptr) |
238 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); | |
3c126654 ML |
239 | |
240 | #ifdef _WIN32 | |
241 | HANDLE *handle_ptr = result_ptr; | |
242 | *handle_ptr = port->hdl; | |
243 | #else | |
244 | int *fd_ptr = result_ptr; | |
245 | *fd_ptr = port->fd; | |
246 | #endif | |
247 | ||
248 | RETURN_OK(); | |
249 | } | |
250 | ||
970f279a AJ |
251 | SP_API enum sp_return sp_copy_port(const struct sp_port *port, |
252 | struct sp_port **copy_ptr) | |
32b5ac05 | 253 | { |
c33efc48 ML |
254 | TRACE("%p, %p", port, copy_ptr); |
255 | ||
32b5ac05 | 256 | if (!copy_ptr) |
c33efc48 | 257 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); |
32b5ac05 ML |
258 | |
259 | *copy_ptr = NULL; | |
260 | ||
c33efc48 ML |
261 | if (!port) |
262 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
263 | ||
264 | if (!port->name) | |
265 | RETURN_ERROR(SP_ERR_ARG, "Null port name"); | |
32b5ac05 | 266 | |
ea667be7 ML |
267 | DEBUG("Copying port structure"); |
268 | ||
9caa2e86 | 269 | RETURN_INT(sp_get_port_by_name(port->name, copy_ptr)); |
32b5ac05 ML |
270 | } |
271 | ||
970f279a | 272 | SP_API void sp_free_port(struct sp_port *port) |
e3b2f7a4 | 273 | { |
c33efc48 ML |
274 | TRACE("%p", port); |
275 | ||
00d8c56d | 276 | if (!port) { |
c33efc48 ML |
277 | DEBUG("Null port"); |
278 | RETURN(); | |
279 | } | |
e3b2f7a4 | 280 | |
ea667be7 ML |
281 | DEBUG("Freeing port structure"); |
282 | ||
e3b2f7a4 ML |
283 | if (port->name) |
284 | free(port->name); | |
a93fb468 AJ |
285 | if (port->description) |
286 | free(port->description); | |
287 | if (port->usb_manufacturer) | |
288 | free(port->usb_manufacturer); | |
289 | if (port->usb_product) | |
290 | free(port->usb_product); | |
291 | if (port->usb_serial) | |
292 | free(port->usb_serial); | |
293 | if (port->bluetooth_address) | |
294 | free(port->bluetooth_address); | |
295 | #ifdef _WIN32 | |
296 | if (port->usb_path) | |
297 | free(port->usb_path); | |
298 | #endif | |
e3b2f7a4 ML |
299 | |
300 | free(port); | |
c33efc48 ML |
301 | |
302 | RETURN(); | |
e3b2f7a4 ML |
303 | } |
304 | ||
970f279a AJ |
305 | SP_PRIV struct sp_port **list_append(struct sp_port **list, |
306 | const char *portname) | |
3b63f34d ML |
307 | { |
308 | void *tmp; | |
309 | unsigned int count; | |
f92f1f0c | 310 | |
3b63f34d | 311 | for (count = 0; list[count]; count++); |
d54e9004 | 312 | if (!(tmp = realloc(list, sizeof(struct sp_port *) * (count + 2)))) |
3b63f34d ML |
313 | goto fail; |
314 | list = tmp; | |
77f262c4 | 315 | if (sp_get_port_by_name(portname, &list[count]) != SP_OK) |
3b63f34d | 316 | goto fail; |
db2794ce | 317 | list[count + 1] = NULL; |
3b63f34d | 318 | return list; |
f92f1f0c | 319 | |
3b63f34d ML |
320 | fail: |
321 | sp_free_port_list(list); | |
322 | return NULL; | |
323 | } | |
324 | ||
970f279a | 325 | SP_API enum sp_return sp_list_ports(struct sp_port ***list_ptr) |
3b63f34d | 326 | { |
23e7fa37 | 327 | #ifndef NO_ENUMERATION |
d54e9004 | 328 | struct sp_port **list; |
48a4076f | 329 | int ret; |
23e7fa37 | 330 | #endif |
24c1a4bb | 331 | |
c33efc48 ML |
332 | TRACE("%p", list_ptr); |
333 | ||
dec10e31 ML |
334 | if (!list_ptr) |
335 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); | |
336 | ||
63926415 UH |
337 | *list_ptr = NULL; |
338 | ||
8d12e620 ML |
339 | #ifdef NO_ENUMERATION |
340 | RETURN_ERROR(SP_ERR_SUPP, "Enumeration not supported on this platform"); | |
341 | #else | |
ea667be7 ML |
342 | DEBUG("Enumerating ports"); |
343 | ||
8d12e620 | 344 | if (!(list = malloc(sizeof(struct sp_port *)))) |
c33efc48 | 345 | RETURN_ERROR(SP_ERR_MEM, "Port list malloc failed"); |
24c1a4bb ML |
346 | |
347 | list[0] = NULL; | |
3b63f34d | 348 | |
48a4076f | 349 | ret = list_ports(&list); |
77f262c4 | 350 | |
8d12e620 | 351 | if (ret == SP_OK) { |
77f262c4 | 352 | *list_ptr = list; |
8d12e620 ML |
353 | } else { |
354 | sp_free_port_list(list); | |
77f262c4 ML |
355 | *list_ptr = NULL; |
356 | } | |
8d12e620 ML |
357 | |
358 | RETURN_CODEVAL(ret); | |
359 | #endif | |
3b63f34d ML |
360 | } |
361 | ||
970f279a | 362 | SP_API void sp_free_port_list(struct sp_port **list) |
3b63f34d ML |
363 | { |
364 | unsigned int i; | |
f92f1f0c | 365 | |
c33efc48 ML |
366 | TRACE("%p", list); |
367 | ||
dec10e31 ML |
368 | if (!list) { |
369 | DEBUG("Null list"); | |
370 | RETURN(); | |
371 | } | |
372 | ||
ea667be7 ML |
373 | DEBUG("Freeing port list"); |
374 | ||
3b63f34d | 375 | for (i = 0; list[i]; i++) |
e3b2f7a4 | 376 | sp_free_port(list[i]); |
3b63f34d | 377 | free(list); |
c33efc48 ML |
378 | |
379 | RETURN(); | |
3b63f34d ML |
380 | } |
381 | ||
c33efc48 | 382 | #define CHECK_PORT() do { \ |
dc422c04 | 383 | if (!port) \ |
c33efc48 | 384 | RETURN_ERROR(SP_ERR_ARG, "Null port"); \ |
dc422c04 | 385 | if (!port->name) \ |
dec10e31 ML |
386 | RETURN_ERROR(SP_ERR_ARG, "Null port name"); \ |
387 | } while (0) | |
388 | #ifdef _WIN32 | |
389 | #define CHECK_PORT_HANDLE() do { \ | |
c33efc48 ML |
390 | if (port->hdl == INVALID_HANDLE_VALUE) \ |
391 | RETURN_ERROR(SP_ERR_ARG, "Invalid port handle"); \ | |
dec10e31 | 392 | } while (0) |
74510d4b | 393 | #else |
dec10e31 | 394 | #define CHECK_PORT_HANDLE() do { \ |
c33efc48 ML |
395 | if (port->fd < 0) \ |
396 | RETURN_ERROR(SP_ERR_ARG, "Invalid port fd"); \ | |
dec10e31 | 397 | } while (0) |
74510d4b | 398 | #endif |
dec10e31 ML |
399 | #define CHECK_OPEN_PORT() do { \ |
400 | CHECK_PORT(); \ | |
401 | CHECK_PORT_HANDLE(); \ | |
402 | } while (0) | |
74510d4b | 403 | |
47fcf8ec ML |
404 | #ifdef WIN32 |
405 | /** To be called after port receive buffer is emptied. */ | |
406 | static enum sp_return restart_wait(struct sp_port *port) | |
407 | { | |
408 | DWORD wait_result; | |
409 | ||
410 | if (port->wait_running) { | |
411 | /* Check status of running wait operation. */ | |
412 | if (GetOverlappedResult(port->hdl, &port->wait_ovl, | |
413 | &wait_result, FALSE)) { | |
414 | DEBUG("Previous wait completed"); | |
415 | port->wait_running = FALSE; | |
416 | } else if (GetLastError() == ERROR_IO_INCOMPLETE) { | |
417 | DEBUG("Previous wait still running"); | |
418 | RETURN_OK(); | |
419 | } else { | |
420 | RETURN_FAIL("GetOverlappedResult() failed"); | |
421 | } | |
422 | } | |
423 | ||
424 | if (!port->wait_running) { | |
425 | /* Start new wait operation. */ | |
426 | if (WaitCommEvent(port->hdl, &port->events, | |
427 | &port->wait_ovl)) { | |
428 | DEBUG("New wait returned, events already pending"); | |
429 | } else if (GetLastError() == ERROR_IO_PENDING) { | |
430 | DEBUG("New wait running in background"); | |
431 | port->wait_running = TRUE; | |
432 | } else { | |
433 | RETURN_FAIL("WaitCommEvent() failed"); | |
434 | } | |
435 | } | |
436 | ||
437 | RETURN_OK(); | |
438 | } | |
439 | #endif | |
440 | ||
970f279a | 441 | SP_API enum sp_return sp_open(struct sp_port *port, enum sp_mode flags) |
74510d4b | 442 | { |
bccc7c9f ML |
443 | struct port_data data; |
444 | struct sp_port_config config; | |
445 | enum sp_return ret; | |
446 | ||
00d8c56d | 447 | TRACE("%p, 0x%x", port, flags); |
c33efc48 | 448 | |
dec10e31 ML |
449 | CHECK_PORT(); |
450 | ||
276ef1b9 | 451 | if (flags > SP_MODE_READ_WRITE) |
dec10e31 | 452 | RETURN_ERROR(SP_ERR_ARG, "Invalid flags"); |
74510d4b | 453 | |
7890cef6 | 454 | DEBUG_FMT("Opening port %s", port->name); |
ea667be7 | 455 | |
74510d4b | 456 | #ifdef _WIN32 |
537942c9 | 457 | DWORD desired_access = 0, flags_and_attributes = 0, errors; |
99945a1f | 458 | char *escaped_port_name; |
537942c9 | 459 | COMSTAT status; |
99945a1f ML |
460 | |
461 | /* Prefix port name with '\\.\' to work with ports above COM9. */ | |
e48f0ece | 462 | if (!(escaped_port_name = malloc(strlen(port->name) + 5))) |
c33efc48 | 463 | RETURN_ERROR(SP_ERR_MEM, "Escaped port name malloc failed"); |
99945a1f ML |
464 | sprintf(escaped_port_name, "\\\\.\\%s", port->name); |
465 | ||
74510d4b | 466 | /* Map 'flags' to the OS-specific settings. */ |
e3dcf906 | 467 | flags_and_attributes = FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED; |
a036341b ML |
468 | if (flags & SP_MODE_READ) |
469 | desired_access |= GENERIC_READ; | |
470 | if (flags & SP_MODE_WRITE) | |
74510d4b | 471 | desired_access |= GENERIC_WRITE; |
74510d4b | 472 | |
99945a1f | 473 | port->hdl = CreateFile(escaped_port_name, desired_access, 0, 0, |
74510d4b | 474 | OPEN_EXISTING, flags_and_attributes, 0); |
99945a1f ML |
475 | |
476 | free(escaped_port_name); | |
477 | ||
74510d4b | 478 | if (port->hdl == INVALID_HANDLE_VALUE) |
dc422c04 | 479 | RETURN_FAIL("Port CreateFile() failed"); |
e3dcf906 ML |
480 | |
481 | /* All timeouts initially disabled. */ | |
482 | port->timeouts.ReadIntervalTimeout = 0; | |
483 | port->timeouts.ReadTotalTimeoutMultiplier = 0; | |
484 | port->timeouts.ReadTotalTimeoutConstant = 0; | |
485 | port->timeouts.WriteTotalTimeoutMultiplier = 0; | |
486 | port->timeouts.WriteTotalTimeoutConstant = 0; | |
a3cb91f5 | 487 | |
e3dcf906 | 488 | if (SetCommTimeouts(port->hdl, &port->timeouts) == 0) { |
a3cb91f5 ML |
489 | sp_close(port); |
490 | RETURN_FAIL("SetCommTimeouts() failed"); | |
491 | } | |
e3dcf906 ML |
492 | |
493 | /* Prepare OVERLAPPED structures. */ | |
6f1186aa ML |
494 | #define INIT_OVERLAPPED(ovl) do { \ |
495 | memset(&port->ovl, 0, sizeof(port->ovl)); \ | |
496 | port->ovl.hEvent = INVALID_HANDLE_VALUE; \ | |
497 | if ((port->ovl.hEvent = CreateEvent(NULL, TRUE, TRUE, NULL)) \ | |
498 | == INVALID_HANDLE_VALUE) { \ | |
499 | sp_close(port); \ | |
500 | RETURN_FAIL(#ovl "CreateEvent() failed"); \ | |
501 | } \ | |
502 | } while (0) | |
503 | ||
504 | INIT_OVERLAPPED(read_ovl); | |
505 | INIT_OVERLAPPED(write_ovl); | |
506 | INIT_OVERLAPPED(wait_ovl); | |
507 | ||
508 | /* Set event mask for RX and error events. */ | |
509 | if (SetCommMask(port->hdl, EV_RXCHAR | EV_ERR) == 0) { | |
e3dcf906 | 510 | sp_close(port); |
6f1186aa | 511 | RETURN_FAIL("SetCommMask() failed"); |
e3dcf906 | 512 | } |
6f1186aa | 513 | |
e3dcf906 | 514 | port->writing = FALSE; |
47fcf8ec | 515 | port->wait_running = FALSE; |
e3dcf906 | 516 | |
47fcf8ec ML |
517 | ret = restart_wait(port); |
518 | ||
519 | if (ret < 0) { | |
520 | sp_close(port); | |
521 | RETURN_CODEVAL(ret); | |
522 | } | |
74510d4b | 523 | #else |
e3dcf906 | 524 | int flags_local = O_NONBLOCK | O_NOCTTY; |
f92f1f0c | 525 | |
74510d4b | 526 | /* Map 'flags' to the OS-specific settings. */ |
276ef1b9 | 527 | if ((flags & SP_MODE_READ_WRITE) == SP_MODE_READ_WRITE) |
74510d4b | 528 | flags_local |= O_RDWR; |
a036341b | 529 | else if (flags & SP_MODE_READ) |
74510d4b | 530 | flags_local |= O_RDONLY; |
a036341b ML |
531 | else if (flags & SP_MODE_WRITE) |
532 | flags_local |= O_WRONLY; | |
74510d4b ML |
533 | |
534 | if ((port->fd = open(port->name, flags_local)) < 0) | |
c33efc48 | 535 | RETURN_FAIL("open() failed"); |
bccc7c9f | 536 | #endif |
9cb98459 | 537 | |
e33ab9aa ML |
538 | ret = get_config(port, &data, &config); |
539 | ||
eac329d2 | 540 | if (ret < 0) { |
e33ab9aa | 541 | sp_close(port); |
c33efc48 | 542 | RETURN_CODEVAL(ret); |
e33ab9aa | 543 | } |
9cb98459 | 544 | |
bccc7c9f ML |
545 | /* Set sane port settings. */ |
546 | #ifdef _WIN32 | |
547 | data.dcb.fBinary = TRUE; | |
548 | data.dcb.fDsrSensitivity = FALSE; | |
549 | data.dcb.fErrorChar = FALSE; | |
550 | data.dcb.fNull = FALSE; | |
34442106 | 551 | data.dcb.fAbortOnError = FALSE; |
bccc7c9f | 552 | #else |
b251be4b | 553 | /* Turn off all fancy termios tricks, give us a raw channel. */ |
c3e05092 UH |
554 | data.term.c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IMAXBEL); |
555 | #ifdef IUCLC | |
556 | data.term.c_iflag &= ~IUCLC; | |
557 | #endif | |
558 | data.term.c_oflag &= ~(OPOST | ONLCR | OCRNL | ONOCR | ONLRET); | |
559 | #ifdef OLCUC | |
560 | data.term.c_oflag &= ~OLCUC; | |
561 | #endif | |
562 | #ifdef NLDLY | |
563 | data.term.c_oflag &= ~NLDLY; | |
564 | #endif | |
565 | #ifdef CRDLY | |
566 | data.term.c_oflag &= ~CRDLY; | |
567 | #endif | |
568 | #ifdef TABDLY | |
569 | data.term.c_oflag &= ~TABDLY; | |
570 | #endif | |
571 | #ifdef BSDLY | |
572 | data.term.c_oflag &= ~BSDLY; | |
573 | #endif | |
574 | #ifdef VTDLY | |
575 | data.term.c_oflag &= ~VTDLY; | |
576 | #endif | |
577 | #ifdef FFDLY | |
578 | data.term.c_oflag &= ~FFDLY; | |
579 | #endif | |
b251be4b | 580 | #ifdef OFILL |
9cb98459 ML |
581 | data.term.c_oflag &= ~OFILL; |
582 | #endif | |
c3e05092 | 583 | data.term.c_lflag &= ~(ISIG | ICANON | ECHO | IEXTEN); |
e3dcf906 | 584 | data.term.c_cc[VMIN] = 0; |
b251be4b | 585 | data.term.c_cc[VTIME] = 0; |
9cb98459 | 586 | |
b251be4b ML |
587 | /* Ignore modem status lines; enable receiver; leave control lines alone on close. */ |
588 | data.term.c_cflag |= (CLOCAL | CREAD | HUPCL); | |
bccc7c9f | 589 | #endif |
9cb98459 | 590 | |
537942c9 | 591 | #ifdef _WIN32 |
1a2a1544 UH |
592 | if (ClearCommError(port->hdl, &errors, &status) == 0) |
593 | RETURN_FAIL("ClearCommError() failed"); | |
537942c9 ML |
594 | #endif |
595 | ||
e33ab9aa ML |
596 | ret = set_config(port, &data, &config); |
597 | ||
eac329d2 | 598 | if (ret < 0) { |
e33ab9aa | 599 | sp_close(port); |
c33efc48 | 600 | RETURN_CODEVAL(ret); |
e33ab9aa | 601 | } |
74510d4b | 602 | |
c33efc48 | 603 | RETURN_OK(); |
74510d4b ML |
604 | } |
605 | ||
970f279a | 606 | SP_API enum sp_return sp_close(struct sp_port *port) |
74510d4b | 607 | { |
c33efc48 ML |
608 | TRACE("%p", port); |
609 | ||
dec10e31 | 610 | CHECK_OPEN_PORT(); |
74510d4b | 611 | |
7890cef6 | 612 | DEBUG_FMT("Closing port %s", port->name); |
ea667be7 | 613 | |
74510d4b ML |
614 | #ifdef _WIN32 |
615 | /* Returns non-zero upon success, 0 upon failure. */ | |
616 | if (CloseHandle(port->hdl) == 0) | |
dc422c04 | 617 | RETURN_FAIL("Port CloseHandle() failed"); |
8f471c66 | 618 | port->hdl = INVALID_HANDLE_VALUE; |
6f1186aa ML |
619 | |
620 | /* Close event handles for overlapped structures. */ | |
621 | #define CLOSE_OVERLAPPED(ovl) do { \ | |
622 | if (port->ovl.hEvent != INVALID_HANDLE_VALUE && \ | |
623 | CloseHandle(port->ovl.hEvent) == 0) \ | |
624 | RETURN_FAIL(# ovl "event CloseHandle() failed"); \ | |
625 | } while (0) | |
626 | CLOSE_OVERLAPPED(read_ovl); | |
627 | CLOSE_OVERLAPPED(write_ovl); | |
628 | CLOSE_OVERLAPPED(wait_ovl); | |
629 | ||
74510d4b ML |
630 | #else |
631 | /* Returns 0 upon success, -1 upon failure. */ | |
632 | if (close(port->fd) == -1) | |
c33efc48 | 633 | RETURN_FAIL("close() failed"); |
8f471c66 | 634 | port->fd = -1; |
74510d4b ML |
635 | #endif |
636 | ||
c33efc48 | 637 | RETURN_OK(); |
74510d4b ML |
638 | } |
639 | ||
970f279a | 640 | SP_API enum sp_return sp_flush(struct sp_port *port, enum sp_buffer buffers) |
74510d4b | 641 | { |
00d8c56d | 642 | TRACE("%p, 0x%x", port, buffers); |
c33efc48 | 643 | |
dec10e31 ML |
644 | CHECK_OPEN_PORT(); |
645 | ||
646 | if (buffers > SP_BUF_BOTH) | |
647 | RETURN_ERROR(SP_ERR_ARG, "Invalid buffer selection"); | |
74510d4b | 648 | |
0ba3e49b | 649 | const char *buffer_names[] = {"no", "input", "output", "both"}; |
ea667be7 | 650 | |
7890cef6 ML |
651 | DEBUG_FMT("Flushing %s buffers on port %s", |
652 | buffer_names[buffers], port->name); | |
ea667be7 | 653 | |
74510d4b | 654 | #ifdef _WIN32 |
fd8fd11a ML |
655 | DWORD flags = 0; |
656 | if (buffers & SP_BUF_INPUT) | |
657 | flags |= PURGE_RXCLEAR; | |
658 | if (buffers & SP_BUF_OUTPUT) | |
659 | flags |= PURGE_TXCLEAR; | |
660 | ||
74510d4b | 661 | /* Returns non-zero upon success, 0 upon failure. */ |
fd8fd11a | 662 | if (PurgeComm(port->hdl, flags) == 0) |
c33efc48 | 663 | RETURN_FAIL("PurgeComm() failed"); |
47fcf8ec ML |
664 | |
665 | if (buffers & SP_BUF_INPUT) | |
666 | TRY(restart_wait(port)); | |
74510d4b | 667 | #else |
fd8fd11a | 668 | int flags = 0; |
ad749855 | 669 | if (buffers == SP_BUF_BOTH) |
fd8fd11a | 670 | flags = TCIOFLUSH; |
ad749855 | 671 | else if (buffers == SP_BUF_INPUT) |
fd8fd11a | 672 | flags = TCIFLUSH; |
ad749855 | 673 | else if (buffers == SP_BUF_OUTPUT) |
fd8fd11a ML |
674 | flags = TCOFLUSH; |
675 | ||
74510d4b | 676 | /* Returns 0 upon success, -1 upon failure. */ |
fd8fd11a | 677 | if (tcflush(port->fd, flags) < 0) |
c33efc48 | 678 | RETURN_FAIL("tcflush() failed"); |
74510d4b | 679 | #endif |
c33efc48 | 680 | RETURN_OK(); |
74510d4b ML |
681 | } |
682 | ||
970f279a | 683 | SP_API enum sp_return sp_drain(struct sp_port *port) |
69a3739c | 684 | { |
c33efc48 ML |
685 | TRACE("%p", port); |
686 | ||
dec10e31 | 687 | CHECK_OPEN_PORT(); |
69a3739c | 688 | |
7890cef6 | 689 | DEBUG_FMT("Draining port %s", port->name); |
ea667be7 | 690 | |
69a3739c ML |
691 | #ifdef _WIN32 |
692 | /* Returns non-zero upon success, 0 upon failure. */ | |
693 | if (FlushFileBuffers(port->hdl) == 0) | |
c33efc48 | 694 | RETURN_FAIL("FlushFileBuffers() failed"); |
2c827b21 | 695 | RETURN_OK(); |
69a3739c | 696 | #else |
2c827b21 ML |
697 | int result; |
698 | while (1) { | |
33fd8804 ML |
699 | #ifdef __ANDROID__ |
700 | int arg = 1; | |
701 | result = ioctl(port->fd, TCSBRK, &arg); | |
702 | #else | |
2c827b21 | 703 | result = tcdrain(port->fd); |
33fd8804 | 704 | #endif |
2c827b21 ML |
705 | if (result < 0) { |
706 | if (errno == EINTR) { | |
707 | DEBUG("tcdrain() was interrupted"); | |
708 | continue; | |
709 | } else { | |
710 | RETURN_FAIL("tcdrain() failed"); | |
711 | } | |
712 | } else { | |
713 | RETURN_OK(); | |
714 | } | |
715 | } | |
69a3739c | 716 | #endif |
69a3739c ML |
717 | } |
718 | ||
970f279a | 719 | SP_API enum sp_return sp_blocking_write(struct sp_port *port, const void *buf, |
1b91c6ea | 720 | size_t count, unsigned int timeout_ms) |
e3dcf906 | 721 | { |
1b91c6ea | 722 | TRACE("%p, %p, %d, %d", port, buf, count, timeout_ms); |
e3dcf906 ML |
723 | |
724 | CHECK_OPEN_PORT(); | |
725 | ||
726 | if (!buf) | |
727 | RETURN_ERROR(SP_ERR_ARG, "Null buffer"); | |
728 | ||
1b91c6ea | 729 | if (timeout_ms) |
7890cef6 | 730 | DEBUG_FMT("Writing %d bytes to port %s, timeout %d ms", |
1b91c6ea | 731 | count, port->name, timeout_ms); |
e3dcf906 | 732 | else |
7890cef6 ML |
733 | DEBUG_FMT("Writing %d bytes to port %s, no timeout", |
734 | count, port->name); | |
e3dcf906 ML |
735 | |
736 | if (count == 0) | |
9caa2e86 | 737 | RETURN_INT(0); |
e3dcf906 ML |
738 | |
739 | #ifdef _WIN32 | |
740 | DWORD bytes_written = 0; | |
741 | BOOL result; | |
742 | ||
743 | /* Wait for previous non-blocking write to complete, if any. */ | |
744 | if (port->writing) { | |
745 | DEBUG("Waiting for previous write to complete"); | |
746 | result = GetOverlappedResult(port->hdl, &port->write_ovl, &bytes_written, TRUE); | |
747 | port->writing = 0; | |
748 | if (!result) | |
749 | RETURN_FAIL("Previous write failed to complete"); | |
750 | DEBUG("Previous write completed"); | |
751 | } | |
752 | ||
753 | /* Set timeout. */ | |
27a58c05 ML |
754 | if (port->timeouts.WriteTotalTimeoutConstant != timeout_ms) { |
755 | port->timeouts.WriteTotalTimeoutConstant = timeout_ms; | |
756 | if (SetCommTimeouts(port->hdl, &port->timeouts) == 0) | |
757 | RETURN_FAIL("SetCommTimeouts() failed"); | |
758 | } | |
e3dcf906 ML |
759 | |
760 | /* Start write. */ | |
bbe566fe | 761 | if (WriteFile(port->hdl, buf, count, NULL, &port->write_ovl)) { |
e3dcf906 | 762 | DEBUG("Write completed immediately"); |
9caa2e86 | 763 | RETURN_INT(count); |
bbe566fe ML |
764 | } else if (GetLastError() == ERROR_IO_PENDING) { |
765 | DEBUG("Waiting for write to complete"); | |
27911925 ML |
766 | if (GetOverlappedResult(port->hdl, &port->write_ovl, &bytes_written, TRUE) == 0) |
767 | RETURN_FAIL("GetOverlappedResult() failed"); | |
bbe566fe ML |
768 | DEBUG_FMT("Write completed, %d/%d bytes written", bytes_written, count); |
769 | RETURN_INT(bytes_written); | |
770 | } else { | |
771 | RETURN_FAIL("WriteFile() failed"); | |
e3dcf906 ML |
772 | } |
773 | #else | |
774 | size_t bytes_written = 0; | |
775 | unsigned char *ptr = (unsigned char *) buf; | |
776 | struct timeval start, delta, now, end = {0, 0}; | |
777 | fd_set fds; | |
778 | int result; | |
779 | ||
1b91c6ea | 780 | if (timeout_ms) { |
e3dcf906 ML |
781 | /* Get time at start of operation. */ |
782 | gettimeofday(&start, NULL); | |
783 | /* Define duration of timeout. */ | |
1b91c6ea UH |
784 | delta.tv_sec = timeout_ms / 1000; |
785 | delta.tv_usec = (timeout_ms % 1000) * 1000; | |
e3dcf906 ML |
786 | /* Calculate time at which we should give up. */ |
787 | timeradd(&start, &delta, &end); | |
788 | } | |
789 | ||
790 | /* Loop until we have written the requested number of bytes. */ | |
dc422c04 | 791 | while (bytes_written < count) { |
e3dcf906 ML |
792 | /* Wait until space is available. */ |
793 | FD_ZERO(&fds); | |
794 | FD_SET(port->fd, &fds); | |
1b91c6ea | 795 | if (timeout_ms) { |
e3dcf906 ML |
796 | gettimeofday(&now, NULL); |
797 | if (timercmp(&now, &end, >)) { | |
dc422c04 | 798 | DEBUG("Write timed out"); |
9caa2e86 | 799 | RETURN_INT(bytes_written); |
e3dcf906 ML |
800 | } |
801 | timersub(&end, &now, &delta); | |
802 | } | |
1b91c6ea | 803 | result = select(port->fd + 1, NULL, &fds, NULL, timeout_ms ? &delta : NULL); |
63a17c64 ML |
804 | if (result < 0) { |
805 | if (errno == EINTR) { | |
806 | DEBUG("select() call was interrupted, repeating"); | |
807 | continue; | |
808 | } else { | |
809 | RETURN_FAIL("select() failed"); | |
810 | } | |
811 | } else if (result == 0) { | |
dc422c04 | 812 | DEBUG("Write timed out"); |
9caa2e86 | 813 | RETURN_INT(bytes_written); |
e3dcf906 ML |
814 | } |
815 | ||
816 | /* Do write. */ | |
817 | result = write(port->fd, ptr, count - bytes_written); | |
818 | ||
819 | if (result < 0) { | |
820 | if (errno == EAGAIN) | |
821 | /* This shouldn't happen because we did a select() first, but handle anyway. */ | |
822 | continue; | |
823 | else | |
824 | /* This is an actual failure. */ | |
825 | RETURN_FAIL("write() failed"); | |
826 | } | |
827 | ||
828 | bytes_written += result; | |
829 | ptr += result; | |
830 | } | |
831 | ||
9caa2e86 | 832 | RETURN_INT(bytes_written); |
e3dcf906 ML |
833 | #endif |
834 | } | |
835 | ||
970f279a AJ |
836 | SP_API enum sp_return sp_nonblocking_write(struct sp_port *port, |
837 | const void *buf, size_t count) | |
74510d4b | 838 | { |
c33efc48 ML |
839 | TRACE("%p, %p, %d", port, buf, count); |
840 | ||
dec10e31 | 841 | CHECK_OPEN_PORT(); |
74510d4b ML |
842 | |
843 | if (!buf) | |
c33efc48 | 844 | RETURN_ERROR(SP_ERR_ARG, "Null buffer"); |
74510d4b | 845 | |
7890cef6 | 846 | DEBUG_FMT("Writing up to %d bytes to port %s", count, port->name); |
ea667be7 | 847 | |
a3cb91f5 | 848 | if (count == 0) |
9caa2e86 | 849 | RETURN_INT(0); |
a3cb91f5 | 850 | |
74510d4b ML |
851 | #ifdef _WIN32 |
852 | DWORD written = 0; | |
0765af56 | 853 | BYTE *ptr = (BYTE *) buf; |
f92f1f0c | 854 | |
e3dcf906 ML |
855 | /* Check whether previous write is complete. */ |
856 | if (port->writing) { | |
857 | if (HasOverlappedIoCompleted(&port->write_ovl)) { | |
858 | DEBUG("Previous write completed"); | |
859 | port->writing = 0; | |
860 | } else { | |
861 | DEBUG("Previous write not complete"); | |
862 | /* Can't take a new write until the previous one finishes. */ | |
9caa2e86 | 863 | RETURN_INT(0); |
a3cb91f5 | 864 | } |
e3dcf906 | 865 | } |
a3cb91f5 | 866 | |
e3dcf906 | 867 | /* Set timeout. */ |
27a58c05 ML |
868 | if (port->timeouts.WriteTotalTimeoutConstant != 0) { |
869 | port->timeouts.WriteTotalTimeoutConstant = 0; | |
870 | if (SetCommTimeouts(port->hdl, &port->timeouts) == 0) | |
871 | RETURN_FAIL("SetCommTimeouts() failed"); | |
872 | } | |
e3dcf906 | 873 | |
dc422c04 UH |
874 | /* |
875 | * Keep writing data until the OS has to actually start an async IO | |
876 | * for it. At that point we know the buffer is full. | |
877 | */ | |
878 | while (written < count) { | |
e3dcf906 ML |
879 | /* Copy first byte of user buffer. */ |
880 | port->pending_byte = *ptr++; | |
881 | ||
882 | /* Start asynchronous write. */ | |
883 | if (WriteFile(port->hdl, &port->pending_byte, 1, NULL, &port->write_ovl) == 0) { | |
884 | if (GetLastError() == ERROR_IO_PENDING) { | |
64d99621 ML |
885 | if (HasOverlappedIoCompleted(&port->write_ovl)) { |
886 | DEBUG("Asynchronous write completed immediately"); | |
887 | port->writing = 0; | |
888 | written++; | |
889 | continue; | |
890 | } else { | |
891 | DEBUG("Asynchronous write running"); | |
892 | port->writing = 1; | |
9caa2e86 | 893 | RETURN_INT(++written); |
64d99621 | 894 | } |
a3cb91f5 | 895 | } else { |
e3dcf906 ML |
896 | /* Actual failure of some kind. */ |
897 | RETURN_FAIL("WriteFile() failed"); | |
a3cb91f5 | 898 | } |
e3dcf906 | 899 | } else { |
9af8cff3 | 900 | DEBUG("Single byte written immediately"); |
e3dcf906 | 901 | written++; |
a3cb91f5 ML |
902 | } |
903 | } | |
904 | ||
9af8cff3 | 905 | DEBUG("All bytes written immediately"); |
e3dcf906 | 906 | |
9caa2e86 | 907 | RETURN_INT(written); |
74510d4b ML |
908 | #else |
909 | /* Returns the number of bytes written, or -1 upon failure. */ | |
910 | ssize_t written = write(port->fd, buf, count); | |
f92f1f0c | 911 | |
74510d4b | 912 | if (written < 0) |
c33efc48 | 913 | RETURN_FAIL("write() failed"); |
74510d4b | 914 | else |
9caa2e86 | 915 | RETURN_INT(written); |
74510d4b ML |
916 | #endif |
917 | } | |
918 | ||
94a314a8 ML |
919 | #ifdef _WIN32 |
920 | /* Restart wait operation if buffer was emptied. */ | |
921 | static enum sp_return restart_wait_if_needed(struct sp_port *port, unsigned int bytes_read) | |
922 | { | |
8ebfaf89 ML |
923 | DWORD errors; |
924 | COMSTAT comstat; | |
94a314a8 | 925 | |
21ae5ce1 ML |
926 | if (bytes_read == 0) |
927 | RETURN_OK(); | |
928 | ||
8ebfaf89 ML |
929 | if (ClearCommError(port->hdl, &errors, &comstat) == 0) |
930 | RETURN_FAIL("ClearCommError() failed"); | |
94a314a8 | 931 | |
8ebfaf89 | 932 | if (comstat.cbInQue == 0) |
94a314a8 ML |
933 | TRY(restart_wait(port)); |
934 | ||
935 | RETURN_OK(); | |
936 | } | |
937 | #endif | |
938 | ||
970f279a | 939 | SP_API enum sp_return sp_blocking_read(struct sp_port *port, void *buf, |
1b91c6ea | 940 | size_t count, unsigned int timeout_ms) |
e3dcf906 | 941 | { |
1b91c6ea | 942 | TRACE("%p, %p, %d, %d", port, buf, count, timeout_ms); |
e3dcf906 ML |
943 | |
944 | CHECK_OPEN_PORT(); | |
945 | ||
946 | if (!buf) | |
947 | RETURN_ERROR(SP_ERR_ARG, "Null buffer"); | |
948 | ||
1b91c6ea | 949 | if (timeout_ms) |
7890cef6 | 950 | DEBUG_FMT("Reading %d bytes from port %s, timeout %d ms", |
1b91c6ea | 951 | count, port->name, timeout_ms); |
e3dcf906 | 952 | else |
7890cef6 ML |
953 | DEBUG_FMT("Reading %d bytes from port %s, no timeout", |
954 | count, port->name); | |
e3dcf906 ML |
955 | |
956 | if (count == 0) | |
9caa2e86 | 957 | RETURN_INT(0); |
e3dcf906 ML |
958 | |
959 | #ifdef _WIN32 | |
960 | DWORD bytes_read = 0; | |
961 | ||
962 | /* Set timeout. */ | |
27a58c05 ML |
963 | if (port->timeouts.ReadIntervalTimeout != 0 || |
964 | port->timeouts.ReadTotalTimeoutConstant != timeout_ms) { | |
965 | port->timeouts.ReadIntervalTimeout = 0; | |
966 | port->timeouts.ReadTotalTimeoutConstant = timeout_ms; | |
967 | if (SetCommTimeouts(port->hdl, &port->timeouts) == 0) | |
968 | RETURN_FAIL("SetCommTimeouts() failed"); | |
969 | } | |
e3dcf906 ML |
970 | |
971 | /* Start read. */ | |
bbe566fe | 972 | if (ReadFile(port->hdl, buf, count, NULL, &port->read_ovl)) { |
e3dcf906 | 973 | DEBUG("Read completed immediately"); |
6f1186aa | 974 | bytes_read = count; |
bbe566fe ML |
975 | } else if (GetLastError() == ERROR_IO_PENDING) { |
976 | DEBUG("Waiting for read to complete"); | |
27911925 ML |
977 | if (GetOverlappedResult(port->hdl, &port->read_ovl, &bytes_read, TRUE) == 0) |
978 | RETURN_FAIL("GetOverlappedResult() failed"); | |
bbe566fe ML |
979 | DEBUG_FMT("Read completed, %d/%d bytes read", bytes_read, count); |
980 | } else { | |
981 | RETURN_FAIL("ReadFile() failed"); | |
6f1186aa ML |
982 | } |
983 | ||
94a314a8 | 984 | TRY(restart_wait_if_needed(port, bytes_read)); |
6f1186aa | 985 | |
9caa2e86 | 986 | RETURN_INT(bytes_read); |
6f1186aa | 987 | |
e3dcf906 ML |
988 | #else |
989 | size_t bytes_read = 0; | |
990 | unsigned char *ptr = (unsigned char *) buf; | |
991 | struct timeval start, delta, now, end = {0, 0}; | |
992 | fd_set fds; | |
993 | int result; | |
994 | ||
1b91c6ea | 995 | if (timeout_ms) { |
e3dcf906 ML |
996 | /* Get time at start of operation. */ |
997 | gettimeofday(&start, NULL); | |
998 | /* Define duration of timeout. */ | |
1b91c6ea UH |
999 | delta.tv_sec = timeout_ms / 1000; |
1000 | delta.tv_usec = (timeout_ms % 1000) * 1000; | |
e3dcf906 ML |
1001 | /* Calculate time at which we should give up. */ |
1002 | timeradd(&start, &delta, &end); | |
1003 | } | |
1004 | ||
1005 | /* Loop until we have the requested number of bytes. */ | |
dc422c04 | 1006 | while (bytes_read < count) { |
e3dcf906 ML |
1007 | /* Wait until data is available. */ |
1008 | FD_ZERO(&fds); | |
1009 | FD_SET(port->fd, &fds); | |
1b91c6ea | 1010 | if (timeout_ms) { |
e3dcf906 ML |
1011 | gettimeofday(&now, NULL); |
1012 | if (timercmp(&now, &end, >)) | |
1013 | /* Timeout has expired. */ | |
9caa2e86 | 1014 | RETURN_INT(bytes_read); |
e3dcf906 ML |
1015 | timersub(&end, &now, &delta); |
1016 | } | |
1b91c6ea | 1017 | result = select(port->fd + 1, &fds, NULL, NULL, timeout_ms ? &delta : NULL); |
63a17c64 ML |
1018 | if (result < 0) { |
1019 | if (errno == EINTR) { | |
1020 | DEBUG("select() call was interrupted, repeating"); | |
1021 | continue; | |
1022 | } else { | |
1023 | RETURN_FAIL("select() failed"); | |
1024 | } | |
1025 | } else if (result == 0) { | |
dc422c04 | 1026 | DEBUG("Read timed out"); |
9caa2e86 | 1027 | RETURN_INT(bytes_read); |
e3dcf906 ML |
1028 | } |
1029 | ||
1030 | /* Do read. */ | |
1031 | result = read(port->fd, ptr, count - bytes_read); | |
1032 | ||
1033 | if (result < 0) { | |
1034 | if (errno == EAGAIN) | |
1035 | /* This shouldn't happen because we did a select() first, but handle anyway. */ | |
1036 | continue; | |
1037 | else | |
1038 | /* This is an actual failure. */ | |
1039 | RETURN_FAIL("read() failed"); | |
1040 | } | |
1041 | ||
1042 | bytes_read += result; | |
1043 | ptr += result; | |
1044 | } | |
1045 | ||
9caa2e86 | 1046 | RETURN_INT(bytes_read); |
e3dcf906 ML |
1047 | #endif |
1048 | } | |
1049 | ||
970f279a AJ |
1050 | SP_API enum sp_return sp_nonblocking_read(struct sp_port *port, void *buf, |
1051 | size_t count) | |
74510d4b | 1052 | { |
c33efc48 ML |
1053 | TRACE("%p, %p, %d", port, buf, count); |
1054 | ||
dec10e31 | 1055 | CHECK_OPEN_PORT(); |
74510d4b ML |
1056 | |
1057 | if (!buf) | |
c33efc48 | 1058 | RETURN_ERROR(SP_ERR_ARG, "Null buffer"); |
74510d4b | 1059 | |
7890cef6 | 1060 | DEBUG_FMT("Reading up to %d bytes from port %s", count, port->name); |
ea667be7 | 1061 | |
74510d4b | 1062 | #ifdef _WIN32 |
e3dcf906 | 1063 | DWORD bytes_read; |
f92f1f0c | 1064 | |
e3dcf906 | 1065 | /* Set timeout. */ |
27a58c05 ML |
1066 | if (port->timeouts.ReadIntervalTimeout != MAXDWORD || |
1067 | port->timeouts.ReadTotalTimeoutConstant != 0) { | |
1068 | port->timeouts.ReadIntervalTimeout = MAXDWORD; | |
1069 | port->timeouts.ReadTotalTimeoutConstant = 0; | |
1070 | if (SetCommTimeouts(port->hdl, &port->timeouts) == 0) | |
1071 | RETURN_FAIL("SetCommTimeouts() failed"); | |
1072 | } | |
e3dcf906 ML |
1073 | |
1074 | /* Do read. */ | |
1075 | if (ReadFile(port->hdl, buf, count, NULL, &port->read_ovl) == 0) | |
c33efc48 | 1076 | RETURN_FAIL("ReadFile() failed"); |
e3dcf906 ML |
1077 | |
1078 | /* Get number of bytes read. */ | |
1622ef60 ML |
1079 | if (GetOverlappedResult(port->hdl, &port->read_ovl, &bytes_read, TRUE) == 0) |
1080 | RETURN_FAIL("GetOverlappedResult() failed"); | |
e3dcf906 | 1081 | |
94a314a8 | 1082 | TRY(restart_wait_if_needed(port, bytes_read)); |
6f1186aa | 1083 | |
9caa2e86 | 1084 | RETURN_INT(bytes_read); |
74510d4b ML |
1085 | #else |
1086 | ssize_t bytes_read; | |
f92f1f0c | 1087 | |
74510d4b | 1088 | /* Returns the number of bytes read, or -1 upon failure. */ |
33d5ff47 | 1089 | if ((bytes_read = read(port->fd, buf, count)) < 0) { |
e3dcf906 ML |
1090 | if (errno == EAGAIN) |
1091 | /* No bytes available. */ | |
33d5ff47 ML |
1092 | bytes_read = 0; |
1093 | else | |
1094 | /* This is an actual failure. */ | |
1095 | RETURN_FAIL("read() failed"); | |
1096 | } | |
9caa2e86 | 1097 | RETURN_INT(bytes_read); |
74510d4b ML |
1098 | #endif |
1099 | } | |
1100 | ||
970f279a | 1101 | SP_API enum sp_return sp_input_waiting(struct sp_port *port) |
3353c22f ML |
1102 | { |
1103 | TRACE("%p", port); | |
1104 | ||
1105 | CHECK_OPEN_PORT(); | |
1106 | ||
7890cef6 | 1107 | DEBUG_FMT("Checking input bytes waiting on port %s", port->name); |
3353c22f ML |
1108 | |
1109 | #ifdef _WIN32 | |
1110 | DWORD errors; | |
1111 | COMSTAT comstat; | |
1112 | ||
1113 | if (ClearCommError(port->hdl, &errors, &comstat) == 0) | |
1a2a1544 | 1114 | RETURN_FAIL("ClearCommError() failed"); |
9caa2e86 | 1115 | RETURN_INT(comstat.cbInQue); |
3353c22f ML |
1116 | #else |
1117 | int bytes_waiting; | |
1118 | if (ioctl(port->fd, TIOCINQ, &bytes_waiting) < 0) | |
1119 | RETURN_FAIL("TIOCINQ ioctl failed"); | |
9caa2e86 | 1120 | RETURN_INT(bytes_waiting); |
3353c22f ML |
1121 | #endif |
1122 | } | |
1123 | ||
970f279a | 1124 | SP_API enum sp_return sp_output_waiting(struct sp_port *port) |
3353c22f ML |
1125 | { |
1126 | TRACE("%p", port); | |
1127 | ||
1128 | CHECK_OPEN_PORT(); | |
1129 | ||
7890cef6 | 1130 | DEBUG_FMT("Checking output bytes waiting on port %s", port->name); |
3353c22f ML |
1131 | |
1132 | #ifdef _WIN32 | |
1133 | DWORD errors; | |
1134 | COMSTAT comstat; | |
1135 | ||
1136 | if (ClearCommError(port->hdl, &errors, &comstat) == 0) | |
1a2a1544 | 1137 | RETURN_FAIL("ClearCommError() failed"); |
9caa2e86 | 1138 | RETURN_INT(comstat.cbOutQue); |
3353c22f ML |
1139 | #else |
1140 | int bytes_waiting; | |
1141 | if (ioctl(port->fd, TIOCOUTQ, &bytes_waiting) < 0) | |
1142 | RETURN_FAIL("TIOCOUTQ ioctl failed"); | |
9caa2e86 | 1143 | RETURN_INT(bytes_waiting); |
3353c22f ML |
1144 | #endif |
1145 | } | |
1146 | ||
970f279a | 1147 | SP_API enum sp_return sp_new_event_set(struct sp_event_set **result_ptr) |
6f1186aa ML |
1148 | { |
1149 | struct sp_event_set *result; | |
1150 | ||
1151 | TRACE("%p", result_ptr); | |
1152 | ||
1153 | if (!result_ptr) | |
1154 | RETURN_ERROR(SP_ERR_ARG, "Null result"); | |
1155 | ||
1156 | *result_ptr = NULL; | |
1157 | ||
1158 | if (!(result = malloc(sizeof(struct sp_event_set)))) | |
1159 | RETURN_ERROR(SP_ERR_MEM, "sp_event_set malloc() failed"); | |
1160 | ||
1161 | memset(result, 0, sizeof(struct sp_event_set)); | |
1162 | ||
1163 | *result_ptr = result; | |
1164 | ||
1165 | RETURN_OK(); | |
1166 | } | |
1167 | ||
1168 | static enum sp_return add_handle(struct sp_event_set *event_set, | |
1169 | event_handle handle, enum sp_event mask) | |
1170 | { | |
1171 | void *new_handles; | |
1172 | enum sp_event *new_masks; | |
1173 | ||
1174 | TRACE("%p, %d, %d", event_set, handle, mask); | |
1175 | ||
1176 | if (!(new_handles = realloc(event_set->handles, | |
1177 | sizeof(event_handle) * (event_set->count + 1)))) | |
dc422c04 | 1178 | RETURN_ERROR(SP_ERR_MEM, "Handle array realloc() failed"); |
6f1186aa | 1179 | |
ac323d80 UH |
1180 | event_set->handles = new_handles; |
1181 | ||
6f1186aa | 1182 | if (!(new_masks = realloc(event_set->masks, |
ac323d80 | 1183 | sizeof(enum sp_event) * (event_set->count + 1)))) |
dc422c04 | 1184 | RETURN_ERROR(SP_ERR_MEM, "Mask array realloc() failed"); |
6f1186aa | 1185 | |
6f1186aa ML |
1186 | event_set->masks = new_masks; |
1187 | ||
1188 | ((event_handle *) event_set->handles)[event_set->count] = handle; | |
1189 | event_set->masks[event_set->count] = mask; | |
1190 | ||
1191 | event_set->count++; | |
1192 | ||
1193 | RETURN_OK(); | |
1194 | } | |
1195 | ||
970f279a | 1196 | SP_API enum sp_return sp_add_port_events(struct sp_event_set *event_set, |
6f1186aa ML |
1197 | const struct sp_port *port, enum sp_event mask) |
1198 | { | |
1199 | TRACE("%p, %p, %d", event_set, port, mask); | |
1200 | ||
1201 | if (!event_set) | |
1202 | RETURN_ERROR(SP_ERR_ARG, "Null event set"); | |
1203 | ||
1204 | if (!port) | |
1205 | RETURN_ERROR(SP_ERR_ARG, "Null port"); | |
1206 | ||
1207 | if (mask > (SP_EVENT_RX_READY | SP_EVENT_TX_READY | SP_EVENT_ERROR)) | |
1208 | RETURN_ERROR(SP_ERR_ARG, "Invalid event mask"); | |
1209 | ||
1210 | if (!mask) | |
1211 | RETURN_OK(); | |
1212 | ||
1213 | #ifdef _WIN32 | |
1214 | enum sp_event handle_mask; | |
1215 | if ((handle_mask = mask & SP_EVENT_TX_READY)) | |
1216 | TRY(add_handle(event_set, port->write_ovl.hEvent, handle_mask)); | |
1217 | if ((handle_mask = mask & (SP_EVENT_RX_READY | SP_EVENT_ERROR))) | |
1218 | TRY(add_handle(event_set, port->wait_ovl.hEvent, handle_mask)); | |
1219 | #else | |
1220 | TRY(add_handle(event_set, port->fd, mask)); | |
1221 | #endif | |
1222 | ||
1223 | RETURN_OK(); | |
1224 | } | |
1225 | ||
970f279a | 1226 | SP_API void sp_free_event_set(struct sp_event_set *event_set) |
6f1186aa ML |
1227 | { |
1228 | TRACE("%p", event_set); | |
1229 | ||
1230 | if (!event_set) { | |
1231 | DEBUG("Null event set"); | |
1232 | RETURN(); | |
1233 | } | |
1234 | ||
1235 | DEBUG("Freeing event set"); | |
1236 | ||
1237 | if (event_set->handles) | |
1238 | free(event_set->handles); | |
1239 | if (event_set->masks) | |
1240 | free(event_set->masks); | |
1241 | ||
1242 | free(event_set); | |
1243 | ||
1244 | RETURN(); | |
1245 | } | |
1246 | ||
970f279a | 1247 | SP_API enum sp_return sp_wait(struct sp_event_set *event_set, |
1b91c6ea | 1248 | unsigned int timeout_ms) |
6f1186aa | 1249 | { |
1b91c6ea | 1250 | TRACE("%p, %d", event_set, timeout_ms); |
6f1186aa ML |
1251 | |
1252 | if (!event_set) | |
1253 | RETURN_ERROR(SP_ERR_ARG, "Null event set"); | |
1254 | ||
1255 | #ifdef _WIN32 | |
1256 | if (WaitForMultipleObjects(event_set->count, event_set->handles, FALSE, | |
1b91c6ea | 1257 | timeout_ms ? timeout_ms : INFINITE) == WAIT_FAILED) |
6f1186aa ML |
1258 | RETURN_FAIL("WaitForMultipleObjects() failed"); |
1259 | ||
1260 | RETURN_OK(); | |
1261 | #else | |
1262 | struct timeval start, delta, now, end = {0, 0}; | |
1b91c6ea | 1263 | int result, timeout_remaining_ms; |
6f1186aa ML |
1264 | struct pollfd *pollfds; |
1265 | unsigned int i; | |
1266 | ||
1267 | if (!(pollfds = malloc(sizeof(struct pollfd) * event_set->count))) | |
1268 | RETURN_ERROR(SP_ERR_MEM, "pollfds malloc() failed"); | |
1269 | ||
1270 | for (i = 0; i < event_set->count; i++) { | |
1271 | pollfds[i].fd = ((int *) event_set->handles)[i]; | |
1272 | pollfds[i].events = 0; | |
1273 | pollfds[i].revents = 0; | |
1274 | if (event_set->masks[i] & SP_EVENT_RX_READY) | |
1275 | pollfds[i].events |= POLLIN; | |
1276 | if (event_set->masks[i] & SP_EVENT_TX_READY) | |
1277 | pollfds[i].events |= POLLOUT; | |
1278 | if (event_set->masks[i] & SP_EVENT_ERROR) | |
1279 | pollfds[i].events |= POLLERR; | |
1280 | } | |
1281 | ||
1b91c6ea | 1282 | if (timeout_ms) { |
6f1186aa ML |
1283 | /* Get time at start of operation. */ |
1284 | gettimeofday(&start, NULL); | |
1285 | /* Define duration of timeout. */ | |
1b91c6ea UH |
1286 | delta.tv_sec = timeout_ms / 1000; |
1287 | delta.tv_usec = (timeout_ms % 1000) * 1000; | |
6f1186aa ML |
1288 | /* Calculate time at which we should give up. */ |
1289 | timeradd(&start, &delta, &end); | |
1290 | } | |
1291 | ||
1292 | /* Loop until an event occurs. */ | |
dc422c04 | 1293 | while (1) { |
1b91c6ea | 1294 | if (timeout_ms) { |
6f1186aa ML |
1295 | gettimeofday(&now, NULL); |
1296 | if (timercmp(&now, &end, >)) { | |
dc422c04 | 1297 | DEBUG("Wait timed out"); |
6f1186aa ML |
1298 | break; |
1299 | } | |
1300 | timersub(&end, &now, &delta); | |
1b91c6ea | 1301 | timeout_remaining_ms = delta.tv_sec * 1000 + delta.tv_usec / 1000; |
6f1186aa ML |
1302 | } |
1303 | ||
1b91c6ea | 1304 | result = poll(pollfds, event_set->count, timeout_ms ? timeout_remaining_ms : -1); |
6f1186aa ML |
1305 | |
1306 | if (result < 0) { | |
1307 | if (errno == EINTR) { | |
1308 | DEBUG("poll() call was interrupted, repeating"); | |
1309 | continue; | |
1310 | } else { | |
1311 | free(pollfds); | |
1312 | RETURN_FAIL("poll() failed"); | |
1313 | } | |
1314 | } else if (result == 0) { | |
1315 | DEBUG("poll() timed out"); | |
1316 | break; | |
1317 | } else { | |
1318 | DEBUG("poll() completed"); | |
1319 | break; | |
1320 | } | |
1321 | } | |
1322 | ||
1323 | free(pollfds); | |
1324 | RETURN_OK(); | |
1325 | #endif | |
1326 | } | |
1327 | ||
5cea279a | 1328 | #ifdef USE_TERMIOS_SPEED |
7a6d2196 ML |
1329 | static enum sp_return get_baudrate(int fd, int *baudrate) |
1330 | { | |
1331 | void *data; | |
1332 | ||
c33efc48 ML |
1333 | TRACE("%d, %p", fd, baudrate); |
1334 | ||
ea667be7 ML |
1335 | DEBUG("Getting baud rate"); |
1336 | ||
7a6d2196 | 1337 | if (!(data = malloc(get_termios_size()))) |
c33efc48 | 1338 | RETURN_ERROR(SP_ERR_MEM, "termios malloc failed"); |
7a6d2196 | 1339 | |
8d43110a ML |
1340 | if (ioctl(fd, get_termios_get_ioctl(), data) < 0) { |
1341 | free(data); | |
dc422c04 | 1342 | RETURN_FAIL("Getting termios failed"); |
8d43110a | 1343 | } |
7a6d2196 ML |
1344 | |
1345 | *baudrate = get_termios_speed(data); | |
1346 | ||
8d43110a ML |
1347 | free(data); |
1348 | ||
c33efc48 | 1349 | RETURN_OK(); |
7a6d2196 ML |
1350 | } |
1351 | ||
1352 | static enum sp_return set_baudrate(int fd, int baudrate) | |
1353 | { | |
1354 | void *data; | |
1355 | ||
c33efc48 ML |
1356 | TRACE("%d, %d", fd, baudrate); |
1357 | ||
ea667be7 ML |
1358 | DEBUG("Getting baud rate"); |
1359 | ||
7a6d2196 | 1360 | if (!(data = malloc(get_termios_size()))) |
c33efc48 | 1361 | RETURN_ERROR(SP_ERR_MEM, "termios malloc failed"); |
7a6d2196 | 1362 | |
8d43110a ML |
1363 | if (ioctl(fd, get_termios_get_ioctl(), data) < 0) { |
1364 | free(data); | |
dc422c04 | 1365 | RETURN_FAIL("Getting termios failed"); |
8d43110a | 1366 | } |
7a6d2196 | 1367 | |
ea667be7 ML |
1368 | DEBUG("Setting baud rate"); |
1369 | ||
7a6d2196 ML |
1370 | set_termios_speed(data, baudrate); |
1371 | ||
8d43110a ML |
1372 | if (ioctl(fd, get_termios_set_ioctl(), data) < 0) { |
1373 | free(data); | |
dc422c04 | 1374 | RETURN_FAIL("Setting termios failed"); |
8d43110a ML |
1375 | } |
1376 | ||
1377 | free(data); | |
7a6d2196 | 1378 | |
c33efc48 | 1379 | RETURN_OK(); |
7a6d2196 | 1380 | } |
5cea279a | 1381 | #endif /* USE_TERMIOS_SPEED */ |
40978c2b ML |
1382 | |
1383 | #ifdef USE_TERMIOX | |
bd791fe1 | 1384 | static enum sp_return get_flow(int fd, struct port_data *data) |
40978c2b | 1385 | { |
bd791fe1 | 1386 | void *termx; |
40978c2b | 1387 | |
bd791fe1 | 1388 | TRACE("%d, %p", fd, data); |
c33efc48 | 1389 | |
ea667be7 ML |
1390 | DEBUG("Getting advanced flow control"); |
1391 | ||
bd791fe1 | 1392 | if (!(termx = malloc(get_termiox_size()))) |
c33efc48 | 1393 | RETURN_ERROR(SP_ERR_MEM, "termiox malloc failed"); |
40978c2b | 1394 | |
bd791fe1 ML |
1395 | if (ioctl(fd, TCGETX, termx) < 0) { |
1396 | free(termx); | |
dc422c04 | 1397 | RETURN_FAIL("Getting termiox failed"); |
8d43110a | 1398 | } |
40978c2b | 1399 | |
bd791fe1 ML |
1400 | get_termiox_flow(termx, &data->rts_flow, &data->cts_flow, |
1401 | &data->dtr_flow, &data->dsr_flow); | |
40978c2b | 1402 | |
bd791fe1 | 1403 | free(termx); |
8d43110a | 1404 | |
c33efc48 | 1405 | RETURN_OK(); |
40978c2b ML |
1406 | } |
1407 | ||
bd791fe1 | 1408 | static enum sp_return set_flow(int fd, struct port_data *data) |
40978c2b | 1409 | { |
bd791fe1 | 1410 | void *termx; |
40978c2b | 1411 | |
bd791fe1 | 1412 | TRACE("%d, %p", fd, data); |
c33efc48 | 1413 | |
ea667be7 ML |
1414 | DEBUG("Getting advanced flow control"); |
1415 | ||
bd791fe1 | 1416 | if (!(termx = malloc(get_termiox_size()))) |
c33efc48 | 1417 | RETURN_ERROR(SP_ERR_MEM, "termiox malloc failed"); |
40978c2b | 1418 | |
bd791fe1 ML |
1419 | if (ioctl(fd, TCGETX, termx) < 0) { |
1420 | free(termx); | |
dc422c04 | 1421 | RETURN_FAIL("Getting termiox failed"); |
8d43110a | 1422 | } |
40978c2b | 1423 | |
ea667be7 ML |
1424 | DEBUG("Setting advanced flow control"); |
1425 | ||
bd791fe1 ML |
1426 | set_termiox_flow(termx, data->rts_flow, data->cts_flow, |
1427 | data->dtr_flow, data->dsr_flow); | |
40978c2b | 1428 | |
bd791fe1 ML |
1429 | if (ioctl(fd, TCSETX, termx) < 0) { |
1430 | free(termx); | |
dc422c04 | 1431 | RETURN_FAIL("Setting termiox failed"); |
8d43110a ML |
1432 | } |
1433 | ||
bd791fe1 | 1434 | free(termx); |
40978c2b | 1435 | |
c33efc48 | 1436 | RETURN_OK(); |
40978c2b ML |
1437 | } |
1438 | #endif /* USE_TERMIOX */ | |
7a6d2196 | 1439 | |
eb6ed20f ML |
1440 | static enum sp_return get_config(struct sp_port *port, struct port_data *data, |
1441 | struct sp_port_config *config) | |
8094e4a0 | 1442 | { |
da2748bf | 1443 | unsigned int i; |
cbf628c7 | 1444 | |
c33efc48 ML |
1445 | TRACE("%p, %p, %p", port, data, config); |
1446 | ||
7890cef6 | 1447 | DEBUG_FMT("Getting configuration for port %s", port->name); |
ea667be7 | 1448 | |
8094e4a0 | 1449 | #ifdef _WIN32 |
e33ab9aa | 1450 | if (!GetCommState(port->hdl, &data->dcb)) |
c33efc48 | 1451 | RETURN_FAIL("GetCommState() failed"); |
8094e4a0 | 1452 | |
067417af | 1453 | for (i = 0; i < NUM_STD_BAUDRATES; i++) { |
e33ab9aa | 1454 | if (data->dcb.BaudRate == std_baudrates[i].index) { |
067417af ML |
1455 | config->baudrate = std_baudrates[i].value; |
1456 | break; | |
1457 | } | |
1458 | } | |
1459 | ||
1460 | if (i == NUM_STD_BAUDRATES) | |
1461 | /* BaudRate field can be either an index or a custom baud rate. */ | |
e33ab9aa | 1462 | config->baudrate = data->dcb.BaudRate; |
067417af | 1463 | |
e33ab9aa | 1464 | config->bits = data->dcb.ByteSize; |
067417af | 1465 | |
e33ab9aa ML |
1466 | if (data->dcb.fParity) |
1467 | switch (data->dcb.Parity) { | |
067417af ML |
1468 | case NOPARITY: |
1469 | config->parity = SP_PARITY_NONE; | |
1470 | break; | |
e432ce60 ML |
1471 | case ODDPARITY: |
1472 | config->parity = SP_PARITY_ODD; | |
1473 | break; | |
067417af ML |
1474 | case EVENPARITY: |
1475 | config->parity = SP_PARITY_EVEN; | |
1476 | break; | |
e432ce60 ML |
1477 | case MARKPARITY: |
1478 | config->parity = SP_PARITY_MARK; | |
1479 | break; | |
1480 | case SPACEPARITY: | |
1481 | config->parity = SP_PARITY_SPACE; | |
067417af ML |
1482 | break; |
1483 | default: | |
1484 | config->parity = -1; | |
1485 | } | |
1486 | else | |
1487 | config->parity = SP_PARITY_NONE; | |
1488 | ||
e33ab9aa | 1489 | switch (data->dcb.StopBits) { |
067417af ML |
1490 | case ONESTOPBIT: |
1491 | config->stopbits = 1; | |
1492 | break; | |
1493 | case TWOSTOPBITS: | |
1494 | config->stopbits = 2; | |
1495 | break; | |
1496 | default: | |
1497 | config->stopbits = -1; | |
1498 | } | |
1499 | ||
e33ab9aa | 1500 | switch (data->dcb.fRtsControl) { |
eac329d2 UH |
1501 | case RTS_CONTROL_DISABLE: |
1502 | config->rts = SP_RTS_OFF; | |
1503 | break; | |
1504 | case RTS_CONTROL_ENABLE: | |
1505 | config->rts = SP_RTS_ON; | |
1506 | break; | |
1507 | case RTS_CONTROL_HANDSHAKE: | |
1508 | config->rts = SP_RTS_FLOW_CONTROL; | |
1509 | break; | |
1510 | default: | |
1511 | config->rts = -1; | |
067417af ML |
1512 | } |
1513 | ||
e33ab9aa | 1514 | config->cts = data->dcb.fOutxCtsFlow ? SP_CTS_FLOW_CONTROL : SP_CTS_IGNORE; |
067417af | 1515 | |
e33ab9aa | 1516 | switch (data->dcb.fDtrControl) { |
eac329d2 UH |
1517 | case DTR_CONTROL_DISABLE: |
1518 | config->dtr = SP_DTR_OFF; | |
1519 | break; | |
1520 | case DTR_CONTROL_ENABLE: | |
1521 | config->dtr = SP_DTR_ON; | |
1522 | break; | |
1523 | case DTR_CONTROL_HANDSHAKE: | |
1524 | config->dtr = SP_DTR_FLOW_CONTROL; | |
1525 | break; | |
1526 | default: | |
1527 | config->dtr = -1; | |
067417af ML |
1528 | } |
1529 | ||
e33ab9aa ML |
1530 | config->dsr = data->dcb.fOutxDsrFlow ? SP_DSR_FLOW_CONTROL : SP_DSR_IGNORE; |
1531 | ||
c6754b45 ML |
1532 | if (data->dcb.fInX) { |
1533 | if (data->dcb.fOutX) | |
1534 | config->xon_xoff = SP_XONXOFF_INOUT; | |
1535 | else | |
1536 | config->xon_xoff = SP_XONXOFF_IN; | |
1537 | } else { | |
1538 | if (data->dcb.fOutX) | |
1539 | config->xon_xoff = SP_XONXOFF_OUT; | |
1540 | else | |
1541 | config->xon_xoff = SP_XONXOFF_DISABLED; | |
1542 | } | |
1543 | ||
e33ab9aa ML |
1544 | #else // !_WIN32 |
1545 | ||
1546 | if (tcgetattr(port->fd, &data->term) < 0) | |
c33efc48 | 1547 | RETURN_FAIL("tcgetattr() failed"); |
e33ab9aa ML |
1548 | |
1549 | if (ioctl(port->fd, TIOCMGET, &data->controlbits) < 0) | |
c33efc48 | 1550 | RETURN_FAIL("TIOCMGET ioctl failed"); |
40978c2b ML |
1551 | |
1552 | #ifdef USE_TERMIOX | |
bd791fe1 | 1553 | int ret = get_flow(port->fd, data); |
68ec29db ML |
1554 | |
1555 | if (ret == SP_ERR_FAIL && errno == EINVAL) | |
1556 | data->termiox_supported = 0; | |
1557 | else if (ret < 0) | |
c33efc48 | 1558 | RETURN_CODEVAL(ret); |
68ec29db ML |
1559 | else |
1560 | data->termiox_supported = 1; | |
1561 | #else | |
1562 | data->termiox_supported = 0; | |
40978c2b ML |
1563 | #endif |
1564 | ||
067417af | 1565 | for (i = 0; i < NUM_STD_BAUDRATES; i++) { |
e33ab9aa | 1566 | if (cfgetispeed(&data->term) == std_baudrates[i].index) { |
067417af ML |
1567 | config->baudrate = std_baudrates[i].value; |
1568 | break; | |
1569 | } | |
1570 | } | |
1571 | ||
31b3a8f5 MH |
1572 | if (i == NUM_STD_BAUDRATES) { |
1573 | #ifdef __APPLE__ | |
1574 | config->baudrate = (int)data->term.c_ispeed; | |
5cea279a | 1575 | #elif defined(USE_TERMIOS_SPEED) |
7a6d2196 | 1576 | TRY(get_baudrate(port->fd, &config->baudrate)); |
31b3a8f5 | 1577 | #else |
067417af | 1578 | config->baudrate = -1; |
31b3a8f5 MH |
1579 | #endif |
1580 | } | |
067417af | 1581 | |
e33ab9aa | 1582 | switch (data->term.c_cflag & CSIZE) { |
067417af ML |
1583 | case CS8: |
1584 | config->bits = 8; | |
1585 | break; | |
1586 | case CS7: | |
1587 | config->bits = 7; | |
1588 | break; | |
1589 | case CS6: | |
1590 | config->bits = 6; | |
1591 | break; | |
1592 | case CS5: | |
1593 | config->bits = 5; | |
1594 | break; | |
1595 | default: | |
1596 | config->bits = -1; | |
1597 | } | |
1598 | ||
e33ab9aa | 1599 | if (!(data->term.c_cflag & PARENB) && (data->term.c_iflag & IGNPAR)) |
067417af | 1600 | config->parity = SP_PARITY_NONE; |
e33ab9aa | 1601 | else if (!(data->term.c_cflag & PARENB) || (data->term.c_iflag & IGNPAR)) |
067417af | 1602 | config->parity = -1; |
c3e05092 | 1603 | #ifdef CMSPAR |
e432ce60 ML |
1604 | else if (data->term.c_cflag & CMSPAR) |
1605 | config->parity = (data->term.c_cflag & PARODD) ? SP_PARITY_MARK : SP_PARITY_SPACE; | |
c3e05092 | 1606 | #endif |
067417af | 1607 | else |
e33ab9aa | 1608 | config->parity = (data->term.c_cflag & PARODD) ? SP_PARITY_ODD : SP_PARITY_EVEN; |
067417af | 1609 | |
e33ab9aa | 1610 | config->stopbits = (data->term.c_cflag & CSTOPB) ? 2 : 1; |
067417af | 1611 | |
e33ab9aa | 1612 | if (data->term.c_cflag & CRTSCTS) { |
067417af ML |
1613 | config->rts = SP_RTS_FLOW_CONTROL; |
1614 | config->cts = SP_CTS_FLOW_CONTROL; | |
1615 | } else { | |
bd791fe1 | 1616 | if (data->termiox_supported && data->rts_flow) |
40978c2b ML |
1617 | config->rts = SP_RTS_FLOW_CONTROL; |
1618 | else | |
1619 | config->rts = (data->controlbits & TIOCM_RTS) ? SP_RTS_ON : SP_RTS_OFF; | |
1620 | ||
bd791fe1 | 1621 | config->cts = (data->termiox_supported && data->cts_flow) ? |
68ec29db | 1622 | SP_CTS_FLOW_CONTROL : SP_CTS_IGNORE; |
067417af ML |
1623 | } |
1624 | ||
bd791fe1 | 1625 | if (data->termiox_supported && data->dtr_flow) |
40978c2b ML |
1626 | config->dtr = SP_DTR_FLOW_CONTROL; |
1627 | else | |
1628 | config->dtr = (data->controlbits & TIOCM_DTR) ? SP_DTR_ON : SP_DTR_OFF; | |
1629 | ||
bd791fe1 | 1630 | config->dsr = (data->termiox_supported && data->dsr_flow) ? |
68ec29db | 1631 | SP_DSR_FLOW_CONTROL : SP_DSR_IGNORE; |
705bdc69 | 1632 | |
e29b93a5 ML |
1633 | if (data->term.c_iflag & IXOFF) { |
1634 | if (data->term.c_iflag & IXON) | |
1635 | config->xon_xoff = SP_XONXOFF_INOUT; | |
1636 | else | |
1637 | config->xon_xoff = SP_XONXOFF_IN; | |
1638 | } else { | |
1639 | if (data->term.c_iflag & IXON) | |
1640 | config->xon_xoff = SP_XONXOFF_OUT; | |
1641 | else | |
1642 | config->xon_xoff = SP_XONXOFF_DISABLED; | |
1643 | } | |
067417af ML |
1644 | #endif |
1645 | ||
c33efc48 | 1646 | RETURN_OK(); |
067417af ML |
1647 | } |
1648 | ||
7a6d2196 | 1649 | static enum sp_return set_config(struct sp_port *port, struct port_data *data, |
eb6ed20f | 1650 | const struct sp_port_config *config) |
18fc2dd1 | 1651 | { |
e33ab9aa | 1652 | unsigned int i; |
31b3a8f5 MH |
1653 | #ifdef __APPLE__ |
1654 | BAUD_TYPE baud_nonstd; | |
1655 | ||
1656 | baud_nonstd = B0; | |
1657 | #endif | |
5cea279a | 1658 | #ifdef USE_TERMIOS_SPEED |
7a6d2196 ML |
1659 | int baud_nonstd = 0; |
1660 | #endif | |
18fc2dd1 | 1661 | |
c33efc48 ML |
1662 | TRACE("%p, %p, %p", port, data, config); |
1663 | ||
7890cef6 | 1664 | DEBUG_FMT("Setting configuration for port %s", port->name); |
ea667be7 | 1665 | |
e33ab9aa | 1666 | #ifdef _WIN32 |
eac329d2 | 1667 | if (config->baudrate >= 0) { |
e33ab9aa ML |
1668 | for (i = 0; i < NUM_STD_BAUDRATES; i++) { |
1669 | if (config->baudrate == std_baudrates[i].value) { | |
1670 | data->dcb.BaudRate = std_baudrates[i].index; | |
1671 | break; | |
1672 | } | |
1673 | } | |
18fc2dd1 | 1674 | |
e33ab9aa ML |
1675 | if (i == NUM_STD_BAUDRATES) |
1676 | data->dcb.BaudRate = config->baudrate; | |
1677 | } | |
18fc2dd1 | 1678 | |
e33ab9aa ML |
1679 | if (config->bits >= 0) |
1680 | data->dcb.ByteSize = config->bits; | |
1681 | ||
1682 | if (config->parity >= 0) { | |
1683 | switch (config->parity) { | |
e33ab9aa ML |
1684 | case SP_PARITY_NONE: |
1685 | data->dcb.Parity = NOPARITY; | |
1686 | break; | |
e432ce60 ML |
1687 | case SP_PARITY_ODD: |
1688 | data->dcb.Parity = ODDPARITY; | |
1689 | break; | |
e33ab9aa ML |
1690 | case SP_PARITY_EVEN: |
1691 | data->dcb.Parity = EVENPARITY; | |
1692 | break; | |
e432ce60 ML |
1693 | case SP_PARITY_MARK: |
1694 | data->dcb.Parity = MARKPARITY; | |
1695 | break; | |
1696 | case SP_PARITY_SPACE: | |
1697 | data->dcb.Parity = SPACEPARITY; | |
e33ab9aa ML |
1698 | break; |
1699 | default: | |
c33efc48 | 1700 | RETURN_ERROR(SP_ERR_ARG, "Invalid parity setting"); |
e33ab9aa | 1701 | } |
18fc2dd1 ML |
1702 | } |
1703 | ||
e33ab9aa ML |
1704 | if (config->stopbits >= 0) { |
1705 | switch (config->stopbits) { | |
1706 | /* Note: There's also ONE5STOPBITS == 1.5 (unneeded so far). */ | |
1707 | case 1: | |
1708 | data->dcb.StopBits = ONESTOPBIT; | |
1709 | break; | |
1710 | case 2: | |
1711 | data->dcb.StopBits = TWOSTOPBITS; | |
1712 | break; | |
1713 | default: | |
c33efc48 | 1714 | RETURN_ERROR(SP_ERR_ARG, "Invalid stop bit setting"); |
e33ab9aa ML |
1715 | } |
1716 | } | |
1717 | ||
1718 | if (config->rts >= 0) { | |
1719 | switch (config->rts) { | |
1720 | case SP_RTS_OFF: | |
1721 | data->dcb.fRtsControl = RTS_CONTROL_DISABLE; | |
1722 | break; | |
1723 | case SP_RTS_ON: | |
1724 | data->dcb.fRtsControl = RTS_CONTROL_ENABLE; | |
1725 | break; | |
1726 | case SP_RTS_FLOW_CONTROL: | |
1727 | data->dcb.fRtsControl = RTS_CONTROL_HANDSHAKE; | |
1728 | break; | |
1729 | default: | |
c33efc48 | 1730 | RETURN_ERROR(SP_ERR_ARG, "Invalid RTS setting"); |
e33ab9aa ML |
1731 | } |
1732 | } | |
1733 | ||
1734 | if (config->cts >= 0) { | |
1735 | switch (config->cts) { | |
1736 | case SP_CTS_IGNORE: | |
1737 | data->dcb.fOutxCtsFlow = FALSE; | |
1738 | break; | |
1739 | case SP_CTS_FLOW_CONTROL: | |
1740 | data->dcb.fOutxCtsFlow = TRUE; | |
1741 | break; | |
1742 | default: | |
c33efc48 | 1743 | RETURN_ERROR(SP_ERR_ARG, "Invalid CTS setting"); |
e33ab9aa ML |
1744 | } |
1745 | } | |
1746 | ||
1747 | if (config->dtr >= 0) { | |
1748 | switch (config->dtr) { | |
1749 | case SP_DTR_OFF: | |
1750 | data->dcb.fDtrControl = DTR_CONTROL_DISABLE; | |
1751 | break; | |
1752 | case SP_DTR_ON: | |
1753 | data->dcb.fDtrControl = DTR_CONTROL_ENABLE; | |
1754 | break; | |
1755 | case SP_DTR_FLOW_CONTROL: | |
1756 | data->dcb.fDtrControl = DTR_CONTROL_HANDSHAKE; | |
1757 | break; | |
1758 | default: | |
c33efc48 | 1759 | RETURN_ERROR(SP_ERR_ARG, "Invalid DTR setting"); |
e33ab9aa ML |
1760 | } |
1761 | } | |
1762 | ||
1763 | if (config->dsr >= 0) { | |
1764 | switch (config->dsr) { | |
1765 | case SP_DSR_IGNORE: | |
1766 | data->dcb.fOutxDsrFlow = FALSE; | |
1767 | break; | |
1768 | case SP_DSR_FLOW_CONTROL: | |
1769 | data->dcb.fOutxDsrFlow = TRUE; | |
1770 | break; | |
1771 | default: | |
c33efc48 | 1772 | RETURN_ERROR(SP_ERR_ARG, "Invalid DSR setting"); |
e33ab9aa | 1773 | } |
18fc2dd1 ML |
1774 | } |
1775 | ||
e33ab9aa ML |
1776 | if (config->xon_xoff >= 0) { |
1777 | switch (config->xon_xoff) { | |
1778 | case SP_XONXOFF_DISABLED: | |
1779 | data->dcb.fInX = FALSE; | |
1780 | data->dcb.fOutX = FALSE; | |
1781 | break; | |
1782 | case SP_XONXOFF_IN: | |
1783 | data->dcb.fInX = TRUE; | |
1784 | data->dcb.fOutX = FALSE; | |
1785 | break; | |
1786 | case SP_XONXOFF_OUT: | |
1787 | data->dcb.fInX = FALSE; | |
1788 | data->dcb.fOutX = TRUE; | |
1789 | break; | |
1790 | case SP_XONXOFF_INOUT: | |
1791 | data->dcb.fInX = TRUE; | |
1792 | data->dcb.fOutX = TRUE; | |
1793 | break; | |
1794 | default: | |
c33efc48 | 1795 | RETURN_ERROR(SP_ERR_ARG, "Invalid XON/XOFF setting"); |
e33ab9aa ML |
1796 | } |
1797 | } | |
1798 | ||
1799 | if (!SetCommState(port->hdl, &data->dcb)) | |
c33efc48 | 1800 | RETURN_FAIL("SetCommState() failed"); |
e33ab9aa | 1801 | |
31b3a8f5 | 1802 | #else /* !_WIN32 */ |
e33ab9aa | 1803 | |
7a6d2196 ML |
1804 | int controlbits; |
1805 | ||
eac329d2 | 1806 | if (config->baudrate >= 0) { |
e33ab9aa ML |
1807 | for (i = 0; i < NUM_STD_BAUDRATES; i++) { |
1808 | if (config->baudrate == std_baudrates[i].value) { | |
1809 | if (cfsetospeed(&data->term, std_baudrates[i].index) < 0) | |
c33efc48 | 1810 | RETURN_FAIL("cfsetospeed() failed"); |
e33ab9aa ML |
1811 | |
1812 | if (cfsetispeed(&data->term, std_baudrates[i].index) < 0) | |
c33efc48 | 1813 | RETURN_FAIL("cfsetispeed() failed"); |
e33ab9aa ML |
1814 | break; |
1815 | } | |
1816 | } | |
1817 | ||
31b3a8f5 MH |
1818 | /* Non-standard baud rate */ |
1819 | if (i == NUM_STD_BAUDRATES) { | |
1820 | #ifdef __APPLE__ | |
24abdb68 | 1821 | /* Set "dummy" baud rate. */ |
31b3a8f5 | 1822 | if (cfsetspeed(&data->term, B9600) < 0) |
c33efc48 | 1823 | RETURN_FAIL("cfsetspeed() failed"); |
31b3a8f5 | 1824 | baud_nonstd = config->baudrate; |
5cea279a | 1825 | #elif defined(USE_TERMIOS_SPEED) |
7a6d2196 | 1826 | baud_nonstd = 1; |
31b3a8f5 | 1827 | #else |
c33efc48 | 1828 | RETURN_ERROR(SP_ERR_SUPP, "Non-standard baudrate not supported"); |
31b3a8f5 MH |
1829 | #endif |
1830 | } | |
e33ab9aa ML |
1831 | } |
1832 | ||
1833 | if (config->bits >= 0) { | |
1834 | data->term.c_cflag &= ~CSIZE; | |
1835 | switch (config->bits) { | |
1836 | case 8: | |
1837 | data->term.c_cflag |= CS8; | |
1838 | break; | |
1839 | case 7: | |
1840 | data->term.c_cflag |= CS7; | |
1841 | break; | |
1842 | case 6: | |
1843 | data->term.c_cflag |= CS6; | |
1844 | break; | |
23922313 UH |
1845 | case 5: |
1846 | data->term.c_cflag |= CS5; | |
1847 | break; | |
e33ab9aa | 1848 | default: |
c33efc48 | 1849 | RETURN_ERROR(SP_ERR_ARG, "Invalid data bits setting"); |
e33ab9aa ML |
1850 | } |
1851 | } | |
1852 | ||
1853 | if (config->parity >= 0) { | |
1854 | data->term.c_iflag &= ~IGNPAR; | |
c3e05092 UH |
1855 | data->term.c_cflag &= ~(PARENB | PARODD); |
1856 | #ifdef CMSPAR | |
1857 | data->term.c_cflag &= ~CMSPAR; | |
1858 | #endif | |
e33ab9aa ML |
1859 | switch (config->parity) { |
1860 | case SP_PARITY_NONE: | |
1861 | data->term.c_iflag |= IGNPAR; | |
1862 | break; | |
1863 | case SP_PARITY_EVEN: | |
1864 | data->term.c_cflag |= PARENB; | |
1865 | break; | |
1866 | case SP_PARITY_ODD: | |
1867 | data->term.c_cflag |= PARENB | PARODD; | |
1868 | break; | |
afb518f0 | 1869 | #ifdef CMSPAR |
e432ce60 | 1870 | case SP_PARITY_MARK: |
c3e05092 | 1871 | data->term.c_cflag |= PARENB | PARODD; |
c3e05092 | 1872 | data->term.c_cflag |= CMSPAR; |
e432ce60 ML |
1873 | break; |
1874 | case SP_PARITY_SPACE: | |
c3e05092 | 1875 | data->term.c_cflag |= PARENB; |
c3e05092 | 1876 | data->term.c_cflag |= CMSPAR; |
e432ce60 | 1877 | break; |
afb518f0 ML |
1878 | #else |
1879 | case SP_PARITY_MARK: | |
1880 | case SP_PARITY_SPACE: | |
1881 | RETURN_ERROR(SP_ERR_SUPP, "Mark/space parity not supported"); | |
1882 | #endif | |
e33ab9aa | 1883 | default: |
c33efc48 | 1884 | RETURN_ERROR(SP_ERR_ARG, "Invalid parity setting"); |
e33ab9aa ML |
1885 | } |
1886 | } | |
1887 | ||
1888 | if (config->stopbits >= 0) { | |
1889 | data->term.c_cflag &= ~CSTOPB; | |
1890 | switch (config->stopbits) { | |
1891 | case 1: | |
1892 | data->term.c_cflag &= ~CSTOPB; | |
1893 | break; | |
1894 | case 2: | |
1895 | data->term.c_cflag |= CSTOPB; | |
1896 | break; | |
1897 | default: | |
c33efc48 | 1898 | RETURN_ERROR(SP_ERR_ARG, "Invalid stop bits setting"); |
e33ab9aa ML |
1899 | } |
1900 | } | |
1901 | ||
eac329d2 | 1902 | if (config->rts >= 0 || config->cts >= 0) { |
68ec29db | 1903 | if (data->termiox_supported) { |
bd791fe1 | 1904 | data->rts_flow = data->cts_flow = 0; |
68ec29db ML |
1905 | switch (config->rts) { |
1906 | case SP_RTS_OFF: | |
1907 | case SP_RTS_ON: | |
1908 | controlbits = TIOCM_RTS; | |
1909 | if (ioctl(port->fd, config->rts == SP_RTS_ON ? TIOCMBIS : TIOCMBIC, &controlbits) < 0) | |
c33efc48 | 1910 | RETURN_FAIL("Setting RTS signal level failed"); |
68ec29db ML |
1911 | break; |
1912 | case SP_RTS_FLOW_CONTROL: | |
bd791fe1 | 1913 | data->rts_flow = 1; |
68ec29db ML |
1914 | break; |
1915 | default: | |
1916 | break; | |
e33ab9aa | 1917 | } |
68ec29db | 1918 | if (config->cts == SP_CTS_FLOW_CONTROL) |
bd791fe1 | 1919 | data->cts_flow = 1; |
e33ab9aa | 1920 | |
bd791fe1 | 1921 | if (data->rts_flow && data->cts_flow) |
e33ab9aa | 1922 | data->term.c_iflag |= CRTSCTS; |
68ec29db ML |
1923 | else |
1924 | data->term.c_iflag &= ~CRTSCTS; | |
1925 | } else { | |
1926 | /* Asymmetric use of RTS/CTS not supported. */ | |
1927 | if (data->term.c_iflag & CRTSCTS) { | |
1928 | /* Flow control can only be disabled for both RTS & CTS together. */ | |
1929 | if (config->rts >= 0 && config->rts != SP_RTS_FLOW_CONTROL) { | |
1930 | if (config->cts != SP_CTS_IGNORE) | |
c33efc48 | 1931 | RETURN_ERROR(SP_ERR_SUPP, "RTS & CTS flow control must be disabled together"); |
68ec29db ML |
1932 | } |
1933 | if (config->cts >= 0 && config->cts != SP_CTS_FLOW_CONTROL) { | |
1934 | if (config->rts <= 0 || config->rts == SP_RTS_FLOW_CONTROL) | |
c33efc48 | 1935 | RETURN_ERROR(SP_ERR_SUPP, "RTS & CTS flow control must be disabled together"); |
68ec29db | 1936 | } |
e33ab9aa | 1937 | } else { |
68ec29db ML |
1938 | /* Flow control can only be enabled for both RTS & CTS together. */ |
1939 | if (((config->rts == SP_RTS_FLOW_CONTROL) && (config->cts != SP_CTS_FLOW_CONTROL)) || | |
1940 | ((config->cts == SP_CTS_FLOW_CONTROL) && (config->rts != SP_RTS_FLOW_CONTROL))) | |
c33efc48 | 1941 | RETURN_ERROR(SP_ERR_SUPP, "RTS & CTS flow control must be enabled together"); |
68ec29db ML |
1942 | } |
1943 | ||
1944 | if (config->rts >= 0) { | |
1945 | if (config->rts == SP_RTS_FLOW_CONTROL) { | |
1946 | data->term.c_iflag |= CRTSCTS; | |
1947 | } else { | |
1948 | controlbits = TIOCM_RTS; | |
1949 | if (ioctl(port->fd, config->rts == SP_RTS_ON ? TIOCMBIS : TIOCMBIC, | |
1950 | &controlbits) < 0) | |
c33efc48 | 1951 | RETURN_FAIL("Setting RTS signal level failed"); |
68ec29db | 1952 | } |
e33ab9aa ML |
1953 | } |
1954 | } | |
1955 | } | |
1956 | ||
eac329d2 | 1957 | if (config->dtr >= 0 || config->dsr >= 0) { |
68ec29db | 1958 | if (data->termiox_supported) { |
bd791fe1 | 1959 | data->dtr_flow = data->dsr_flow = 0; |
68ec29db ML |
1960 | switch (config->dtr) { |
1961 | case SP_DTR_OFF: | |
1962 | case SP_DTR_ON: | |
1963 | controlbits = TIOCM_DTR; | |
1964 | if (ioctl(port->fd, config->dtr == SP_DTR_ON ? TIOCMBIS : TIOCMBIC, &controlbits) < 0) | |
c33efc48 | 1965 | RETURN_FAIL("Setting DTR signal level failed"); |
68ec29db ML |
1966 | break; |
1967 | case SP_DTR_FLOW_CONTROL: | |
bd791fe1 | 1968 | data->dtr_flow = 1; |
68ec29db ML |
1969 | break; |
1970 | default: | |
1971 | break; | |
1972 | } | |
1973 | if (config->dsr == SP_DSR_FLOW_CONTROL) | |
bd791fe1 | 1974 | data->dsr_flow = 1; |
68ec29db ML |
1975 | } else { |
1976 | /* DTR/DSR flow control not supported. */ | |
1977 | if (config->dtr == SP_DTR_FLOW_CONTROL || config->dsr == SP_DSR_FLOW_CONTROL) | |
c33efc48 | 1978 | RETURN_ERROR(SP_ERR_SUPP, "DTR/DSR flow control not supported"); |
e33ab9aa | 1979 | |
68ec29db ML |
1980 | if (config->dtr >= 0) { |
1981 | controlbits = TIOCM_DTR; | |
1982 | if (ioctl(port->fd, config->dtr == SP_DTR_ON ? TIOCMBIS : TIOCMBIC, | |
1983 | &controlbits) < 0) | |
c33efc48 | 1984 | RETURN_FAIL("Setting DTR signal level failed"); |
68ec29db | 1985 | } |
e33ab9aa ML |
1986 | } |
1987 | } | |
1988 | ||
1989 | if (config->xon_xoff >= 0) { | |
1990 | data->term.c_iflag &= ~(IXON | IXOFF | IXANY); | |
1991 | switch (config->xon_xoff) { | |
1992 | case SP_XONXOFF_DISABLED: | |
1993 | break; | |
1994 | case SP_XONXOFF_IN: | |
1995 | data->term.c_iflag |= IXOFF; | |
1996 | break; | |
1997 | case SP_XONXOFF_OUT: | |
1998 | data->term.c_iflag |= IXON | IXANY; | |
1999 | break; | |
2000 | case SP_XONXOFF_INOUT: | |
2001 | data->term.c_iflag |= IXON | IXOFF | IXANY; | |
2002 | break; | |
2003 | default: | |
c33efc48 | 2004 | RETURN_ERROR(SP_ERR_ARG, "Invalid XON/XOFF setting"); |
e33ab9aa ML |
2005 | } |
2006 | } | |
2007 | ||
3f5c06d0 | 2008 | if (tcsetattr(port->fd, TCSANOW, &data->term) < 0) |
c33efc48 | 2009 | RETURN_FAIL("tcsetattr() failed"); |
31b3a8f5 MH |
2010 | |
2011 | #ifdef __APPLE__ | |
2012 | if (baud_nonstd != B0) { | |
2013 | if (ioctl(port->fd, IOSSIOSPEED, &baud_nonstd) == -1) | |
c33efc48 | 2014 | RETURN_FAIL("IOSSIOSPEED ioctl failed"); |
dc422c04 UH |
2015 | /* |
2016 | * Set baud rates in data->term to correct, but incompatible | |
2017 | * with tcsetattr() value, same as delivered by tcgetattr(). | |
2018 | */ | |
31b3a8f5 | 2019 | if (cfsetspeed(&data->term, baud_nonstd) < 0) |
c33efc48 | 2020 | RETURN_FAIL("cfsetspeed() failed"); |
31b3a8f5 | 2021 | } |
7a6d2196 | 2022 | #elif defined(__linux__) |
5cea279a | 2023 | #ifdef USE_TERMIOS_SPEED |
7a6d2196 ML |
2024 | if (baud_nonstd) |
2025 | TRY(set_baudrate(port->fd, config->baudrate)); | |
5cea279a | 2026 | #endif |
40978c2b | 2027 | #ifdef USE_TERMIOX |
68ec29db | 2028 | if (data->termiox_supported) |
bd791fe1 | 2029 | TRY(set_flow(port->fd, data)); |
40978c2b | 2030 | #endif |
7a6d2196 | 2031 | #endif |
31b3a8f5 MH |
2032 | |
2033 | #endif /* !_WIN32 */ | |
e33ab9aa | 2034 | |
c33efc48 | 2035 | RETURN_OK(); |
e33ab9aa ML |
2036 | } |
2037 | ||
970f279a | 2038 | SP_API enum sp_return sp_new_config(struct sp_port_config **config_ptr) |
9b1502ef | 2039 | { |
59131d60 | 2040 | struct sp_port_config *config; |
9b1502ef | 2041 | |
00d8c56d UH |
2042 | TRACE("%p", config_ptr); |
2043 | ||
9b1502ef ML |
2044 | if (!config_ptr) |
2045 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); | |
2046 | ||
59131d60 ML |
2047 | *config_ptr = NULL; |
2048 | ||
2049 | if (!(config = malloc(sizeof(struct sp_port_config)))) | |
dc422c04 | 2050 | RETURN_ERROR(SP_ERR_MEM, "Config malloc failed"); |
9b1502ef | 2051 | |
59131d60 ML |
2052 | config->baudrate = -1; |
2053 | config->bits = -1; | |
2054 | config->parity = -1; | |
2055 | config->stopbits = -1; | |
2056 | config->rts = -1; | |
2057 | config->cts = -1; | |
2058 | config->dtr = -1; | |
2059 | config->dsr = -1; | |
2060 | ||
2061 | *config_ptr = config; | |
2062 | ||
9b1502ef ML |
2063 | RETURN_OK(); |
2064 | } | |
2065 | ||
970f279a | 2066 | SP_API void sp_free_config(struct sp_port_config *config) |
9b1502ef ML |
2067 | { |
2068 | TRACE("%p", config); | |
2069 | ||
2070 | if (!config) | |
2071 | DEBUG("Null config"); | |
2072 | else | |
2073 | free(config); | |
2074 | ||
2075 | RETURN(); | |
2076 | } | |
2077 | ||
970f279a AJ |
2078 | SP_API enum sp_return sp_get_config(struct sp_port *port, |
2079 | struct sp_port_config *config) | |
70cd37de ML |
2080 | { |
2081 | struct port_data data; | |
2082 | ||
2083 | TRACE("%p, %p", port, config); | |
2084 | ||
2085 | CHECK_OPEN_PORT(); | |
2086 | ||
2087 | if (!config) | |
9b1502ef | 2088 | RETURN_ERROR(SP_ERR_ARG, "Null config"); |
70cd37de ML |
2089 | |
2090 | TRY(get_config(port, &data, config)); | |
2091 | ||
2092 | RETURN_OK(); | |
2093 | } | |
2094 | ||
970f279a AJ |
2095 | SP_API enum sp_return sp_set_config(struct sp_port *port, |
2096 | const struct sp_port_config *config) | |
e33ab9aa | 2097 | { |
8f189c4c | 2098 | struct port_data data; |
e33ab9aa ML |
2099 | struct sp_port_config prev_config; |
2100 | ||
c33efc48 ML |
2101 | TRACE("%p, %p", port, config); |
2102 | ||
dec10e31 | 2103 | CHECK_OPEN_PORT(); |
823690ae ML |
2104 | |
2105 | if (!config) | |
c33efc48 | 2106 | RETURN_ERROR(SP_ERR_ARG, "Null config"); |
823690ae | 2107 | |
e33ab9aa ML |
2108 | TRY(get_config(port, &data, &prev_config)); |
2109 | TRY(set_config(port, &data, config)); | |
74510d4b | 2110 | |
c33efc48 | 2111 | RETURN_OK(); |
74510d4b ML |
2112 | } |
2113 | ||
9b1502ef | 2114 | #define CREATE_ACCESSORS(x, type) \ |
970f279a | 2115 | SP_API enum sp_return sp_set_##x(struct sp_port *port, type x) { \ |
8f189c4c | 2116 | struct port_data data; \ |
e33ab9aa | 2117 | struct sp_port_config config; \ |
c33efc48 | 2118 | TRACE("%p, %d", port, x); \ |
dec10e31 | 2119 | CHECK_OPEN_PORT(); \ |
e33ab9aa ML |
2120 | TRY(get_config(port, &data, &config)); \ |
2121 | config.x = x; \ | |
2122 | TRY(set_config(port, &data, &config)); \ | |
c33efc48 | 2123 | RETURN_OK(); \ |
9b1502ef | 2124 | } \ |
970f279a AJ |
2125 | SP_API enum sp_return sp_get_config_##x(const struct sp_port_config *config, \ |
2126 | type *x) { \ | |
00d8c56d | 2127 | TRACE("%p, %p", config, x); \ |
6aad5bdd UH |
2128 | if (!x) \ |
2129 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); \ | |
9b1502ef ML |
2130 | if (!config) \ |
2131 | RETURN_ERROR(SP_ERR_ARG, "Null config"); \ | |
2132 | *x = config->x; \ | |
2133 | RETURN_OK(); \ | |
2134 | } \ | |
970f279a AJ |
2135 | SP_API enum sp_return sp_set_config_##x(struct sp_port_config *config, \ |
2136 | type x) { \ | |
9b1502ef ML |
2137 | TRACE("%p, %d", config, x); \ |
2138 | if (!config) \ | |
2139 | RETURN_ERROR(SP_ERR_ARG, "Null config"); \ | |
2140 | config->x = x; \ | |
2141 | RETURN_OK(); \ | |
9069c2fb ML |
2142 | } |
2143 | ||
9b1502ef ML |
2144 | CREATE_ACCESSORS(baudrate, int) |
2145 | CREATE_ACCESSORS(bits, int) | |
2146 | CREATE_ACCESSORS(parity, enum sp_parity) | |
2147 | CREATE_ACCESSORS(stopbits, int) | |
2148 | CREATE_ACCESSORS(rts, enum sp_rts) | |
2149 | CREATE_ACCESSORS(cts, enum sp_cts) | |
2150 | CREATE_ACCESSORS(dtr, enum sp_dtr) | |
2151 | CREATE_ACCESSORS(dsr, enum sp_dsr) | |
2152 | CREATE_ACCESSORS(xon_xoff, enum sp_xonxoff) | |
2153 | ||
970f279a AJ |
2154 | SP_API enum sp_return sp_set_config_flowcontrol(struct sp_port_config *config, |
2155 | enum sp_flowcontrol flowcontrol) | |
e33ab9aa | 2156 | { |
9b1502ef ML |
2157 | if (!config) |
2158 | RETURN_ERROR(SP_ERR_ARG, "Null configuration"); | |
dec10e31 ML |
2159 | |
2160 | if (flowcontrol > SP_FLOWCONTROL_DTRDSR) | |
2161 | RETURN_ERROR(SP_ERR_ARG, "Invalid flow control setting"); | |
823690ae | 2162 | |
e33ab9aa | 2163 | if (flowcontrol == SP_FLOWCONTROL_XONXOFF) |
9b1502ef | 2164 | config->xon_xoff = SP_XONXOFF_INOUT; |
e33ab9aa | 2165 | else |
9b1502ef | 2166 | config->xon_xoff = SP_XONXOFF_DISABLED; |
e33ab9aa ML |
2167 | |
2168 | if (flowcontrol == SP_FLOWCONTROL_RTSCTS) { | |
9b1502ef ML |
2169 | config->rts = SP_RTS_FLOW_CONTROL; |
2170 | config->cts = SP_CTS_FLOW_CONTROL; | |
e33ab9aa | 2171 | } else { |
9b1502ef ML |
2172 | if (config->rts == SP_RTS_FLOW_CONTROL) |
2173 | config->rts = SP_RTS_ON; | |
2174 | config->cts = SP_CTS_IGNORE; | |
e33ab9aa ML |
2175 | } |
2176 | ||
2177 | if (flowcontrol == SP_FLOWCONTROL_DTRDSR) { | |
9b1502ef ML |
2178 | config->dtr = SP_DTR_FLOW_CONTROL; |
2179 | config->dsr = SP_DSR_FLOW_CONTROL; | |
e33ab9aa | 2180 | } else { |
9b1502ef ML |
2181 | if (config->dtr == SP_DTR_FLOW_CONTROL) |
2182 | config->dtr = SP_DTR_ON; | |
2183 | config->dsr = SP_DSR_IGNORE; | |
e33ab9aa ML |
2184 | } |
2185 | ||
9b1502ef ML |
2186 | RETURN_OK(); |
2187 | } | |
2188 | ||
970f279a AJ |
2189 | SP_API enum sp_return sp_set_flowcontrol(struct sp_port *port, |
2190 | enum sp_flowcontrol flowcontrol) | |
9b1502ef ML |
2191 | { |
2192 | struct port_data data; | |
2193 | struct sp_port_config config; | |
2194 | ||
2195 | TRACE("%p, %d", port, flowcontrol); | |
2196 | ||
2197 | CHECK_OPEN_PORT(); | |
2198 | ||
2199 | TRY(get_config(port, &data, &config)); | |
2200 | ||
2201 | TRY(sp_set_config_flowcontrol(&config, flowcontrol)); | |
2202 | ||
e33ab9aa ML |
2203 | TRY(set_config(port, &data, &config)); |
2204 | ||
c33efc48 | 2205 | RETURN_OK(); |
e33ab9aa ML |
2206 | } |
2207 | ||
970f279a AJ |
2208 | SP_API enum sp_return sp_get_signals(struct sp_port *port, |
2209 | enum sp_signal *signals) | |
8cf7c697 | 2210 | { |
c33efc48 ML |
2211 | TRACE("%p, %p", port, signals); |
2212 | ||
dec10e31 | 2213 | CHECK_OPEN_PORT(); |
8cf7c697 ML |
2214 | |
2215 | if (!signals) | |
c33efc48 | 2216 | RETURN_ERROR(SP_ERR_ARG, "Null result pointer"); |
8cf7c697 | 2217 | |
7890cef6 | 2218 | DEBUG_FMT("Getting control signals for port %s", port->name); |
ea667be7 | 2219 | |
8cf7c697 ML |
2220 | *signals = 0; |
2221 | #ifdef _WIN32 | |
2222 | DWORD bits; | |
2223 | if (GetCommModemStatus(port->hdl, &bits) == 0) | |
c33efc48 | 2224 | RETURN_FAIL("GetCommModemStatus() failed"); |
8cf7c697 ML |
2225 | if (bits & MS_CTS_ON) |
2226 | *signals |= SP_SIG_CTS; | |
2227 | if (bits & MS_DSR_ON) | |
2228 | *signals |= SP_SIG_DSR; | |
8cf7c697 | 2229 | if (bits & MS_RLSD_ON) |
a6cda1e8 ML |
2230 | *signals |= SP_SIG_DCD; |
2231 | if (bits & MS_RING_ON) | |
8cf7c697 ML |
2232 | *signals |= SP_SIG_RI; |
2233 | #else | |
2234 | int bits; | |
2235 | if (ioctl(port->fd, TIOCMGET, &bits) < 0) | |
c33efc48 | 2236 | RETURN_FAIL("TIOCMGET ioctl failed"); |
8cf7c697 ML |
2237 | if (bits & TIOCM_CTS) |
2238 | *signals |= SP_SIG_CTS; | |
2239 | if (bits & TIOCM_DSR) | |
2240 | *signals |= SP_SIG_DSR; | |
2241 | if (bits & TIOCM_CAR) | |
2242 | *signals |= SP_SIG_DCD; | |
2243 | if (bits & TIOCM_RNG) | |
2244 | *signals |= SP_SIG_RI; | |
2245 | #endif | |
c33efc48 | 2246 | RETURN_OK(); |
8cf7c697 ML |
2247 | } |
2248 | ||
970f279a | 2249 | SP_API enum sp_return sp_start_break(struct sp_port *port) |
90cc3ee6 | 2250 | { |
c33efc48 ML |
2251 | TRACE("%p", port); |
2252 | ||
dec10e31 | 2253 | CHECK_OPEN_PORT(); |
90cc3ee6 ML |
2254 | #ifdef _WIN32 |
2255 | if (SetCommBreak(port->hdl) == 0) | |
c33efc48 | 2256 | RETURN_FAIL("SetCommBreak() failed"); |
90cc3ee6 ML |
2257 | #else |
2258 | if (ioctl(port->fd, TIOCSBRK, 1) < 0) | |
c33efc48 | 2259 | RETURN_FAIL("TIOCSBRK ioctl failed"); |
90cc3ee6 ML |
2260 | #endif |
2261 | ||
c33efc48 | 2262 | RETURN_OK(); |
90cc3ee6 ML |
2263 | } |
2264 | ||
970f279a | 2265 | SP_API enum sp_return sp_end_break(struct sp_port *port) |
90cc3ee6 | 2266 | { |
c33efc48 ML |
2267 | TRACE("%p", port); |
2268 | ||
dec10e31 | 2269 | CHECK_OPEN_PORT(); |
90cc3ee6 ML |
2270 | #ifdef _WIN32 |
2271 | if (ClearCommBreak(port->hdl) == 0) | |
c33efc48 | 2272 | RETURN_FAIL("ClearCommBreak() failed"); |
90cc3ee6 ML |
2273 | #else |
2274 | if (ioctl(port->fd, TIOCCBRK, 1) < 0) | |
c33efc48 | 2275 | RETURN_FAIL("TIOCCBRK ioctl failed"); |
90cc3ee6 ML |
2276 | #endif |
2277 | ||
c33efc48 | 2278 | RETURN_OK(); |
90cc3ee6 ML |
2279 | } |
2280 | ||
970f279a | 2281 | SP_API int sp_last_error_code(void) |
74510d4b | 2282 | { |
7890cef6 | 2283 | TRACE_VOID(); |
74510d4b | 2284 | #ifdef _WIN32 |
9caa2e86 | 2285 | RETURN_INT(GetLastError()); |
74510d4b | 2286 | #else |
9caa2e86 | 2287 | RETURN_INT(errno); |
74510d4b ML |
2288 | #endif |
2289 | } | |
2290 | ||
970f279a | 2291 | SP_API char *sp_last_error_message(void) |
74510d4b | 2292 | { |
7890cef6 | 2293 | TRACE_VOID(); |
c33efc48 | 2294 | |
74510d4b | 2295 | #ifdef _WIN32 |
9a0c4bbd | 2296 | TCHAR *message; |
74510d4b ML |
2297 | DWORD error = GetLastError(); |
2298 | ||
9a0c4bbd | 2299 | DWORD length = FormatMessage( |
74510d4b ML |
2300 | FORMAT_MESSAGE_ALLOCATE_BUFFER | |
2301 | FORMAT_MESSAGE_FROM_SYSTEM | | |
2302 | FORMAT_MESSAGE_IGNORE_INSERTS, | |
2303 | NULL, | |
2304 | error, | |
2305 | MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), | |
2306 | (LPTSTR) &message, | |
2307 | 0, NULL ); | |
2308 | ||
9a0c4bbd ML |
2309 | if (length >= 2 && message[length - 2] == '\r') |
2310 | message[length - 2] = '\0'; | |
2311 | ||
9caa2e86 | 2312 | RETURN_STRING(message); |
74510d4b | 2313 | #else |
9caa2e86 | 2314 | RETURN_STRING(strerror(errno)); |
74510d4b ML |
2315 | #endif |
2316 | } | |
2317 | ||
970f279a | 2318 | SP_API void sp_free_error_message(char *message) |
74510d4b | 2319 | { |
c33efc48 ML |
2320 | TRACE("%s", message); |
2321 | ||
74510d4b ML |
2322 | #ifdef _WIN32 |
2323 | LocalFree(message); | |
64eec30d ML |
2324 | #else |
2325 | (void)message; | |
74510d4b | 2326 | #endif |
c33efc48 ML |
2327 | |
2328 | RETURN(); | |
74510d4b | 2329 | } |
863b35e6 | 2330 | |
970f279a | 2331 | SP_API void sp_set_debug_handler(void (*handler)(const char *format, ...)) |
863b35e6 | 2332 | { |
c33efc48 ML |
2333 | TRACE("%p", handler); |
2334 | ||
863b35e6 | 2335 | sp_debug_handler = handler; |
c33efc48 ML |
2336 | |
2337 | RETURN(); | |
863b35e6 ML |
2338 | } |
2339 | ||
970f279a | 2340 | SP_API void sp_default_debug_handler(const char *format, ...) |
863b35e6 ML |
2341 | { |
2342 | va_list args; | |
2343 | va_start(args, format); | |
2344 | if (getenv("LIBSERIALPORT_DEBUG")) { | |
dd7742fb | 2345 | fputs("sp: ", stderr); |
863b35e6 ML |
2346 | vfprintf(stderr, format, args); |
2347 | } | |
2348 | va_end(args); | |
2349 | } | |
524b0e14 | 2350 | |
970f279a | 2351 | SP_API int sp_get_major_package_version(void) |
524b0e14 UH |
2352 | { |
2353 | return SP_PACKAGE_VERSION_MAJOR; | |
2354 | } | |
2355 | ||
970f279a | 2356 | SP_API int sp_get_minor_package_version(void) |
524b0e14 UH |
2357 | { |
2358 | return SP_PACKAGE_VERSION_MINOR; | |
2359 | } | |
2360 | ||
970f279a | 2361 | SP_API int sp_get_micro_package_version(void) |
524b0e14 UH |
2362 | { |
2363 | return SP_PACKAGE_VERSION_MICRO; | |
2364 | } | |
2365 | ||
970f279a | 2366 | SP_API const char *sp_get_package_version_string(void) |
524b0e14 UH |
2367 | { |
2368 | return SP_PACKAGE_VERSION_STRING; | |
2369 | } | |
2370 | ||
970f279a | 2371 | SP_API int sp_get_current_lib_version(void) |
524b0e14 UH |
2372 | { |
2373 | return SP_LIB_VERSION_CURRENT; | |
2374 | } | |
2375 | ||
970f279a | 2376 | SP_API int sp_get_revision_lib_version(void) |
524b0e14 UH |
2377 | { |
2378 | return SP_LIB_VERSION_REVISION; | |
2379 | } | |
2380 | ||
970f279a | 2381 | SP_API int sp_get_age_lib_version(void) |
524b0e14 UH |
2382 | { |
2383 | return SP_LIB_VERSION_AGE; | |
2384 | } | |
2385 | ||
970f279a | 2386 | SP_API const char *sp_get_lib_version_string(void) |
524b0e14 UH |
2387 | { |
2388 | return SP_LIB_VERSION_STRING; | |
2389 | } | |
2390 | ||
2391 | /** @} */ |