2 * Generic uart / rs232/ serial port library
4 * Copyright (c) 2013, Roel Verdult
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions are met:
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * 3. Neither the name of the copyright holders nor the
15 * names of its contributors may be used to endorse or promote products
16 * derived from this software without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
19 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
22 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
24 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
25 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 // Test if we are dealing with unix operating systems
40 typedef struct termios term_info
;
42 int fd
; // Serial port file descriptor
43 term_info tiOld
; // Terminal info before using the port
44 term_info tiNew
; // Terminal info during the transaction
47 // Set time-out on 30 miliseconds
48 const struct timeval timeout
= {
49 .tv_sec
= 0, // 0 second
50 .tv_usec
= 30000 // 30000 micro seconds
53 // Work-around to claim uart interface using the c_iflag (software input processing) from the termios struct
54 #define CCLAIMED 0x00008000
58 serial_port
uart_open(const char* pcPortName
)
60 serial_port_unix
* sp
= malloc(sizeof(serial_port_unix
));
61 strcpy(pcPort
,pcPortName
);
63 if (sp
== 0) return INVALID_SERIAL_PORT
;
65 sp
->fd
= open(pcPortName
, O_RDWR
| O_NOCTTY
| O_NDELAY
| O_NONBLOCK
);
69 return INVALID_SERIAL_PORT
;
72 if(tcgetattr(sp
->fd
,&sp
->tiOld
) == -1)
75 return INVALID_SERIAL_PORT
;
78 // Make sure the port is not claimed already
79 if (sp
->tiOld
.c_iflag
& CCLAIMED
)
82 return CLAIMED_SERIAL_PORT
;
85 // Copy the old terminal info struct
86 sp
->tiNew
= sp
->tiOld
;
88 sp
->tiNew
.c_cflag
= CS8
| CLOCAL
| CREAD
;
89 sp
->tiNew
.c_iflag
= CCLAIMED
| IGNPAR
;
90 sp
->tiNew
.c_oflag
= 0;
91 sp
->tiNew
.c_lflag
= 0;
93 // Set serial port equivalent to raw mode
94 // sp->tiNew.c_iflag &= ~(CCLAIMED | IGNBRK | BRKINT | IGNPAR | ISTRIP | INLCR | IGNCR | ICRNL | IXON);
95 // sp->tiNew.c_oflag &= ~OPOST;
96 // sp->tiNew.c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN);
97 // sp->tiNew.c_cflag &= ~(CSIZE | PARENB | CS8 | CLOCAL | CREAD);
99 sp
->tiNew
.c_cc
[VMIN
] = 0; // block until n bytes are received
100 sp
->tiNew
.c_cc
[VTIME
] = 0; // block until a timer expires (n * 100 mSec.)
102 if(tcsetattr(sp
->fd
,TCSANOW
,&sp
->tiNew
) == -1)
105 return INVALID_SERIAL_PORT
;
108 tcflush(sp
->fd
, TCIOFLUSH
);
112 bool uart_set_speed(serial_port sp
, const uint32_t uiPortSpeed
) {
113 // Set port speed (Input and Output)
114 const serial_port_unix
* spu
= (serial_port_unix
*)sp
;
115 cfsetispeed((struct termios
*)&spu
->tiNew
, uiPortSpeed
);
116 cfsetospeed((struct termios
*)&spu
->tiNew
, uiPortSpeed
);
117 return (tcsetattr(spu
->fd
, TCSADRAIN
, &spu
->tiNew
) != -1);
120 uint32_t uart_get_speed(const serial_port sp
) {
121 uint32_t uiPortSpeed
= 0;
122 const serial_port_unix
* spu
= (serial_port_unix
*)sp
;
123 uiPortSpeed
= cfgetispeed(&spu
->tiNew
);
127 void uart_close(const serial_port sp
) {
128 tcflush(((serial_port_unix
*)sp
)->fd
,TCIOFLUSH
);
129 tcsetattr(((serial_port_unix
*)sp
)->fd
,TCSANOW
,&((serial_port_unix
*)sp
)->tiOld
);
130 close(((serial_port_unix
*)sp
)->fd
);
134 bool uart_cts(const serial_port sp
) {
136 if (ioctl(((serial_port_unix
*)sp
)->fd
,TIOCMGET
,&status
) < 0) return false;
137 return (status
& TIOCM_CTS
);
140 bool uart_receive(const serial_port sp
, byte_t
* pbtRx
, size_t* pszRxLen
) {
146 // Reset the output count
150 // Reset file descriptor
152 FD_SET(((serial_port_unix
*)sp
)->fd
,&rfds
);
154 res
= select(((serial_port_unix
*)sp
)->fd
+1, &rfds
, NULL
, NULL
, &tv
);
163 if (*pszRxLen
== 0) {
164 // Error, we received no data
167 // We received some data, but nothing more is available
172 // Retrieve the count of the incoming bytes
173 res
= ioctl(((serial_port_unix
*)sp
)->fd
, FIONREAD
, &byteCount
);
174 if (res
< 0) return false;
176 // There is something available, read the data
177 res
= read(((serial_port_unix
*)sp
)->fd
,pbtRx
+(*pszRxLen
),byteCount
);
179 // Stop if the OS has some troubles reading the data
180 if (res
<= 0) return false;
189 bool uart_send(const serial_port sp
, const byte_t
* pbtTx
, const size_t szTxLen
) {
195 while (szPos
< szTxLen
)
197 // Reset file descriptor
199 FD_SET(((serial_port_unix
*)sp
)->fd
,&rfds
);
201 res
= select(((serial_port_unix
*)sp
)->fd
+1, NULL
, &rfds
, NULL
, &tv
);
213 // Send away the bytes
214 res
= write(((serial_port_unix
*)sp
)->fd
,pbtTx
+szPos
,szTxLen
-szPos
);
216 // Stop if the OS has some troubles sending the data
217 if (res
<= 0) return false;
225 // The windows serial port implementation
228 HANDLE hPort
; // Serial port handle
229 DCB dcb
; // Device control settings
230 COMMTIMEOUTS ct
; // Serial port time-out configuration
231 } serial_port_windows
;
233 void upcase(char *p
) {
235 if(*p
>= 97 && *p
<= 122) {
242 serial_port
uart_open(const char* pcPortName
) {
243 char acPortName
[255];
244 serial_port_windows
* sp
= malloc(sizeof(serial_port_windows
));
246 // Copy the input "com?" to "\\.\COM?" format
247 sprintf(acPortName
,"\\\\.\\%s",pcPortName
);
250 // Try to open the serial port
251 sp
->hPort
= CreateFileA(acPortName
,GENERIC_READ
|GENERIC_WRITE
,0,NULL
,OPEN_EXISTING
,0,NULL
);
252 if (sp
->hPort
== INVALID_HANDLE_VALUE
)
255 return INVALID_SERIAL_PORT
;
258 // Prepare the device control
259 memset(&sp
->dcb
, 0, sizeof(DCB
));
260 sp
->dcb
.DCBlength
= sizeof(DCB
);
261 if(!BuildCommDCBA("baud=9600 data=8 parity=N stop=1",&sp
->dcb
))
264 return INVALID_SERIAL_PORT
;
267 // Update the active serial port
268 if(!SetCommState(sp
->hPort
,&sp
->dcb
))
271 return INVALID_SERIAL_PORT
;
274 sp
->ct
.ReadIntervalTimeout
= 0;
275 sp
->ct
.ReadTotalTimeoutMultiplier
= 0;
276 sp
->ct
.ReadTotalTimeoutConstant
= 30;
277 sp
->ct
.WriteTotalTimeoutMultiplier
= 0;
278 sp
->ct
.WriteTotalTimeoutConstant
= 30;
280 if(!SetCommTimeouts(sp
->hPort
,&sp
->ct
))
283 return INVALID_SERIAL_PORT
;
286 PurgeComm(sp
->hPort
, PURGE_RXABORT
| PURGE_RXCLEAR
);
291 void uart_close(const serial_port sp
) {
292 CloseHandle(((serial_port_windows
*)sp
)->hPort
);
296 bool uart_set_speed(serial_port sp
, const uint32_t uiPortSpeed
) {
297 serial_port_windows
* spw
;
298 spw
= (serial_port_windows
*)sp
;
299 spw
->dcb
.BaudRate
= uiPortSpeed
;
300 return SetCommState(spw
->hPort
, &spw
->dcb
);
303 uint32_t uart_get_speed(const serial_port sp
) {
304 const serial_port_windows
* spw
= (serial_port_windows
*)sp
;
305 if (!GetCommState(spw
->hPort
, (serial_port
)&spw
->dcb
)) {
306 return spw
->dcb
.BaudRate
;
311 bool uart_receive(const serial_port sp
, byte_t
* pbtRx
, size_t* pszRxLen
) {
312 ReadFile(((serial_port_windows
*)sp
)->hPort
,pbtRx
,*pszRxLen
,(LPDWORD
)pszRxLen
,NULL
);
313 return (*pszRxLen
!= 0);
316 bool uart_send(const serial_port sp
, const byte_t
* pbtTx
, const size_t szTxLen
) {
318 return WriteFile(((serial_port_windows
*)sp
)->hPort
,pbtTx
,szTxLen
,&dwTxLen
,NULL
);
319 return (dwTxLen
!= 0);