Since | Origin / Contributor | Maintainer | Source |
---|---|---|---|
2014-12-22 | Zeroday | Zeroday | uart.c |
The UART (Universal asynchronous receiver/transmitter) module allows configuration of and communication over the UART serial port.
The default setup for the uart is controlled by build-time settings. The default rate is 115,200 bps. In addition, auto-baudrate detection is enabled for the first two minutes
after platform boot. This will cause a switch to the correct baud rate once a few characters are received. Auto-baudrate detection is disabled when uart.setup
is called.
Change UART pin assignment.
uart.alt(on)
on
nil
Sets the callback function to handle UART events.
Currently only the «data» event is supported.
uart.on(method, [number/end_char], [function], [run_input])
method
«data», data has been received on the UARTnumber/end_char
function
callback function, event «data» has a callback like this: function(data) end
run_input
0 or 1. If 0, input from UART will not go into Lua interpreter, can accept binary data. If 1, input from UART will go into Lua interpreter, and run.To unregister the callback, provide only the «data» parameter.
nil
-- when 4 chars is received.
uart.on("data", 4,
function(data)
print("receive from uart:", data)
if data=="quit" then
uart.on("data") -- unregister callback function
end
end, 0)
-- when '\r' is received.
uart.on("data", "\r",
function(data)
print("receive from uart:", data)
if data=="quit\r" then
uart.on("data") -- unregister callback function
end
end, 0)
(Re-)configures the communication parameters of the UART.
uart.setup(id, baud, databits, parity, stopbits, echo)
id
always zero, only one uart supportedbaud
one of 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230400, 256000, 460800, 921600, 1843200, 3686400databits
one of 5, 6, 7, 8parity
uart.PARITY_NONE
, uart.PARITY_ODD
, or uart.PARITY_EVEN
stopbits
uart.STOPBITS_1
, uart.STOPBITS_1_5
, or uart.STOPBITS_2
echo
if 0, disable echo, otherwise enable echoconfigured baud rate (number)
-- configure for 9600, 8N1, with echo
uart.setup(0, 9600, 8, uart.PARITY_NONE, uart.STOPBITS_1, 1)
Returns the current configuration parameters of the UART.
uart.getconfig(id)
id
always zero, only one uart supportedFour values as follows:
baud
one of 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230400, 256000, 460800, 921600, 1843200, 3686400databits
one of 5, 6, 7, 8parity
uart.PARITY_NONE
, uart.PARITY_ODD
, or uart.PARITY_EVEN
stopbits
uart.STOPBITS_1
, uart.STOPBITS_1_5
, or uart.STOPBITS_2
print (uart.getconfig(0))
-- prints 9600 8 0 1 for 9600, 8N1
Write string or byte to the UART.
uart.write(id, data1 [, data2, ...])
id
always 0, only one UART supporteddata1
… string or byte to send via UARTnil
uart.write(0, "Hello, world\n")