2 Serial driver that layers on top of a Serial Port Library instance.
4 Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
5 Copyright (c) 2013-2014, ARM Ltd. All rights reserved.<BR>
6 Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
8 This program and the accompanying materials
9 are licensed and made available under the terms and conditions of the BSD License
10 which accompanies this distribution. The full text of the license may be found at
11 http://opensource.org/licenses/bsd-license.php
13 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
14 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 #include <Library/UefiBootServicesTableLib.h>
19 #include <Library/SerialPortLib.h>
20 #include <Library/DebugLib.h>
21 #include <Library/PcdLib.h>
23 #include <Protocol/SerialIo.h>
24 #include <Protocol/DevicePath.h>
27 VENDOR_DEVICE_PATH Guid
;
28 UART_DEVICE_PATH Uart
;
29 EFI_DEVICE_PATH_PROTOCOL End
;
33 Reset the serial device.
35 @param This Protocol instance pointer.
37 @retval EFI_SUCCESS The device was reset.
38 @retval EFI_DEVICE_ERROR The serial device could not be reset.
44 IN EFI_SERIAL_IO_PROTOCOL
*This
48 Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
49 data bits, and stop bits on a serial device.
51 @param This Protocol instance pointer.
52 @param BaudRate The requested baud rate. A BaudRate value of 0 will use the the
53 device's default interface speed.
54 @param ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
55 serial interface. A ReceiveFifoDepth value of 0 will use
56 the device's default FIFO depth.
57 @param Timeout The requested time out for a single character in microseconds.
58 This timeout applies to both the transmit and receive side of the
59 interface. A Timeout value of 0 will use the device's default time
61 @param Parity The type of parity to use on this serial device. A Parity value of
62 DefaultParity will use the device's default parity value.
63 @param DataBits The number of data bits to use on the serial device. A DataBits
64 value of 0 will use the device's default data bit setting.
65 @param StopBits The number of stop bits to use on this serial device. A StopBits
66 value of DefaultStopBits will use the device's default number of
69 @retval EFI_SUCCESS The device was reset.
70 @retval EFI_DEVICE_ERROR The serial device could not be reset.
76 IN EFI_SERIAL_IO_PROTOCOL
*This
,
78 IN UINT32 ReceiveFifoDepth
,
80 IN EFI_PARITY_TYPE Parity
,
82 IN EFI_STOP_BITS_TYPE StopBits
86 Set the control bits on a serial device
88 @param This Protocol instance pointer.
89 @param Control Set the bits of Control that are settable.
91 @retval EFI_SUCCESS The new control bits were set on the serial device.
92 @retval EFI_UNSUPPORTED The serial device does not support this operation.
93 @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
99 IN EFI_SERIAL_IO_PROTOCOL
*This
,
104 Retrieves the status of the control bits on a serial device
106 @param This Protocol instance pointer.
107 @param Control A pointer to return the current Control signals from the serial device.
109 @retval EFI_SUCCESS The control bits were read from the serial device.
110 @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
116 IN EFI_SERIAL_IO_PROTOCOL
*This
,
121 Writes data to a serial device.
123 @param This Protocol instance pointer.
124 @param BufferSize On input, the size of the Buffer. On output, the amount of
125 data actually written.
126 @param Buffer The buffer of data to write
128 @retval EFI_SUCCESS The data was written.
129 @retval EFI_DEVICE_ERROR The device reported an error.
130 @retval EFI_TIMEOUT The data write was stopped due to a timeout.
136 IN EFI_SERIAL_IO_PROTOCOL
*This
,
137 IN OUT UINTN
*BufferSize
,
142 Reads data from a serial device.
144 @param This Protocol instance pointer.
145 @param BufferSize On input, the size of the Buffer. On output, the amount of
146 data returned in Buffer.
147 @param Buffer The buffer to return the data into.
149 @retval EFI_SUCCESS The data was read.
150 @retval EFI_DEVICE_ERROR The device reported an error.
151 @retval EFI_TIMEOUT The data write was stopped due to a timeout.
157 IN EFI_SERIAL_IO_PROTOCOL
*This
,
158 IN OUT UINTN
*BufferSize
,
162 EFI_HANDLE mSerialHandle
= NULL
;
164 SERIAL_DEVICE_PATH mSerialDevicePath
= {
166 { HARDWARE_DEVICE_PATH
, HW_VENDOR_DP
, { sizeof (VENDOR_DEVICE_PATH
), 0} },
167 EFI_CALLER_ID_GUID
// Use the driver's GUID
170 { MESSAGING_DEVICE_PATH
, MSG_UART_DP
, { sizeof (UART_DEVICE_PATH
), 0} },
177 { END_DEVICE_PATH_TYPE
, END_ENTIRE_DEVICE_PATH_SUBTYPE
, { sizeof (EFI_DEVICE_PATH_PROTOCOL
), 0 } }
181 // Template used to initialize the Serial IO protocols.
183 EFI_SERIAL_IO_MODE mSerialIoMode
= {
187 1, // ReceiveFifoDepth
193 EFI_SERIAL_IO_PROTOCOL mSerialIoTemplate
= {
194 SERIAL_IO_INTERFACE_REVISION
,
205 Reset the serial device.
207 @param This Protocol instance pointer.
209 @retval EFI_SUCCESS The device was reset.
210 @retval EFI_DEVICE_ERROR The serial device could not be reset.
216 IN EFI_SERIAL_IO_PROTOCOL
*This
222 Status
= SerialPortInitialize ();
223 if (EFI_ERROR (Status
)) {
228 // Set the Serial I/O mode and update the device path
231 Tpl
= gBS
->RaiseTPL (TPL_NOTIFY
);
234 // Set the Serial I/O mode
236 This
->Mode
->ReceiveFifoDepth
= 1;
237 This
->Mode
->Timeout
= 0;
238 This
->Mode
->BaudRate
= PcdGet64 (PcdUartDefaultBaudRate
);
239 This
->Mode
->DataBits
= (UINT32
) PcdGet8 (PcdUartDefaultDataBits
);
240 This
->Mode
->Parity
= (UINT32
) PcdGet8 (PcdUartDefaultParity
);
241 This
->Mode
->StopBits
= (UINT32
) PcdGet8 (PcdUartDefaultStopBits
);
244 // Check if the device path has actually changed
246 if (mSerialDevicePath
.Uart
.BaudRate
== This
->Mode
->BaudRate
&&
247 mSerialDevicePath
.Uart
.DataBits
== (UINT8
) This
->Mode
->DataBits
&&
248 mSerialDevicePath
.Uart
.Parity
== (UINT8
) This
->Mode
->Parity
&&
249 mSerialDevicePath
.Uart
.StopBits
== (UINT8
) This
->Mode
->StopBits
251 gBS
->RestoreTPL (Tpl
);
256 // Update the device path
258 mSerialDevicePath
.Uart
.BaudRate
= This
->Mode
->BaudRate
;
259 mSerialDevicePath
.Uart
.DataBits
= (UINT8
) This
->Mode
->DataBits
;
260 mSerialDevicePath
.Uart
.Parity
= (UINT8
) This
->Mode
->Parity
;
261 mSerialDevicePath
.Uart
.StopBits
= (UINT8
) This
->Mode
->StopBits
;
263 Status
= gBS
->ReinstallProtocolInterface (
265 &gEfiDevicePathProtocolGuid
,
270 gBS
->RestoreTPL (Tpl
);
276 Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
277 data bits, and stop bits on a serial device.
279 @param This Protocol instance pointer.
280 @param BaudRate The requested baud rate. A BaudRate value of 0 will use the the
281 device's default interface speed.
282 @param ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
283 serial interface. A ReceiveFifoDepth value of 0 will use
284 the device's default FIFO depth.
285 @param Timeout The requested time out for a single character in microseconds.
286 This timeout applies to both the transmit and receive side of the
287 interface. A Timeout value of 0 will use the device's default time
289 @param Parity The type of parity to use on this serial device. A Parity value of
290 DefaultParity will use the device's default parity value.
291 @param DataBits The number of data bits to use on the serial device. A DataBits
292 value of 0 will use the device's default data bit setting.
293 @param StopBits The number of stop bits to use on this serial device. A StopBits
294 value of DefaultStopBits will use the device's default number of
297 @retval EFI_SUCCESS The device was reset.
298 @retval EFI_DEVICE_ERROR The serial device could not be reset.
303 SerialSetAttributes (
304 IN EFI_SERIAL_IO_PROTOCOL
*This
,
306 IN UINT32 ReceiveFifoDepth
,
308 IN EFI_PARITY_TYPE Parity
,
310 IN EFI_STOP_BITS_TYPE StopBits
316 Status
= SerialPortSetAttributes (&BaudRate
, &ReceiveFifoDepth
, &Timeout
, &Parity
, &DataBits
, &StopBits
);
317 if (EFI_ERROR (Status
)) {
322 // Set the Serial I/O mode and update the device path
325 Tpl
= gBS
->RaiseTPL (TPL_NOTIFY
);
328 // Set the Serial I/O mode
330 This
->Mode
->ReceiveFifoDepth
= ReceiveFifoDepth
;
331 This
->Mode
->Timeout
= Timeout
;
332 This
->Mode
->BaudRate
= BaudRate
;
333 This
->Mode
->DataBits
= (UINT32
) DataBits
;
334 This
->Mode
->Parity
= (UINT32
) Parity
;
335 This
->Mode
->StopBits
= (UINT32
) StopBits
;
338 // Check if the device path has actually changed
340 if (mSerialDevicePath
.Uart
.BaudRate
== BaudRate
&&
341 mSerialDevicePath
.Uart
.DataBits
== DataBits
&&
342 mSerialDevicePath
.Uart
.Parity
== (UINT8
) Parity
&&
343 mSerialDevicePath
.Uart
.StopBits
== (UINT8
) StopBits
345 gBS
->RestoreTPL (Tpl
);
350 // Update the device path
352 mSerialDevicePath
.Uart
.BaudRate
= BaudRate
;
353 mSerialDevicePath
.Uart
.DataBits
= DataBits
;
354 mSerialDevicePath
.Uart
.Parity
= (UINT8
) Parity
;
355 mSerialDevicePath
.Uart
.StopBits
= (UINT8
) StopBits
;
357 Status
= gBS
->ReinstallProtocolInterface (
359 &gEfiDevicePathProtocolGuid
,
364 gBS
->RestoreTPL (Tpl
);
370 Set the control bits on a serial device
372 @param This Protocol instance pointer.
373 @param Control Set the bits of Control that are settable.
375 @retval EFI_SUCCESS The new control bits were set on the serial device.
376 @retval EFI_UNSUPPORTED The serial device does not support this operation.
377 @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
383 IN EFI_SERIAL_IO_PROTOCOL
*This
,
387 return SerialPortSetControl (Control
);
391 Retrieves the status of the control bits on a serial device
393 @param This Protocol instance pointer.
394 @param Control A pointer to return the current Control signals from the serial device.
396 @retval EFI_SUCCESS The control bits were read from the serial device.
397 @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
403 IN EFI_SERIAL_IO_PROTOCOL
*This
,
407 return SerialPortGetControl (Control
);
411 Writes data to a serial device.
413 @param This Protocol instance pointer.
414 @param BufferSize On input, the size of the Buffer. On output, the amount of
415 data actually written.
416 @param Buffer The buffer of data to write
418 @retval EFI_SUCCESS The data was written.
419 @retval EFI_DEVICE_ERROR The device reported an error.
420 @retval EFI_TIMEOUT The data write was stopped due to a timeout.
426 IN EFI_SERIAL_IO_PROTOCOL
*This
,
427 IN OUT UINTN
*BufferSize
,
433 Count
= SerialPortWrite (Buffer
, *BufferSize
);
435 if (Count
!= *BufferSize
) {
444 Reads data from a serial device.
446 @param This Protocol instance pointer.
447 @param BufferSize On input, the size of the Buffer. On output, the amount of
448 data returned in Buffer.
449 @param Buffer The buffer to return the data into.
451 @retval EFI_SUCCESS The data was read.
452 @retval EFI_DEVICE_ERROR The device reported an error.
453 @retval EFI_TIMEOUT The data write was stopped due to a timeout.
459 IN EFI_SERIAL_IO_PROTOCOL
*This
,
460 IN OUT UINTN
*BufferSize
,
468 if (SerialPortPoll ()) {
469 Count
= SerialPortRead (Buffer
, *BufferSize
);
472 if (Count
!= *BufferSize
) {
481 Initialization for the Serial Io Protocol.
483 @param[in] ImageHandle The firmware allocated handle for the EFI image.
484 @param[in] SystemTable A pointer to the EFI System Table.
486 @retval EFI_SUCCESS The entry point is executed successfully.
487 @retval other Some error occurs when executing this entry point.
492 SerialDxeInitialize (
493 IN EFI_HANDLE ImageHandle
,
494 IN EFI_SYSTEM_TABLE
*SystemTable
499 Status
= SerialPortInitialize ();
500 if (EFI_ERROR (Status
)) {
504 mSerialIoMode
.BaudRate
= PcdGet64 (PcdUartDefaultBaudRate
);
505 mSerialIoMode
.DataBits
= (UINT32
) PcdGet8 (PcdUartDefaultDataBits
);
506 mSerialIoMode
.Parity
= (UINT32
) PcdGet8 (PcdUartDefaultParity
);
507 mSerialIoMode
.StopBits
= (UINT32
) PcdGet8 (PcdUartDefaultStopBits
);
508 mSerialDevicePath
.Uart
.BaudRate
= PcdGet64 (PcdUartDefaultBaudRate
);
509 mSerialDevicePath
.Uart
.DataBits
= PcdGet8 (PcdUartDefaultDataBits
);
510 mSerialDevicePath
.Uart
.Parity
= PcdGet8 (PcdUartDefaultParity
);
511 mSerialDevicePath
.Uart
.StopBits
= PcdGet8 (PcdUartDefaultStopBits
);
514 // Make a new handle with Serial IO protocol and its device path on it.
516 Status
= gBS
->InstallMultipleProtocolInterfaces (
518 &gEfiSerialIoProtocolGuid
, &mSerialIoTemplate
,
519 &gEfiDevicePathProtocolGuid
, &mSerialDevicePath
,
522 ASSERT_EFI_ERROR (Status
);