29.08.2019

Openwrt Serial Port Programming

89
Port
Blog‎ > ‎

OpenWRT and Python on Routerboard RB133

posted Sep 27, 2011, 8:50 AM by Fabio Di Bernardini [ updated Dec 7, 2012, 12:14 AM]
Some time ago I needed to log from a serial port and read a Modbus/TCP analog converter. Then, all these data had to be sent to a web app.
I had a few Mikrotik Routerboard RB133 available but it's factory system, RouterOS, is very cool for networking and wireless but lacks a programming language capable to make complex things.
So I had to build, configure and mount on it OpenWRT.
I used a netbook with Ubuntu (10.04 LTS), a USB to RS232 adapter and, of course, a Mikrotik RB133 board with firmware ver. RouterBOOT-2.7.

Network configuration

The first bootstrap should be done through network so we need a DHCP and a TFTP server
I suppose you are using a wireless connection so the ethernet cable is available.
Patch this to the ethernet between power leds and serial port on RB133.

DHCP server

On Ubuntu open the connections editor and create a new wired connection. I named it 'Share WIFI'.
In IPv4 settings tab select method 'Shared to other computers' and save all.

TFTP server

Install and activate the TFTP server:
sudo apt-get install tftpd
sudo update-inetd --enable tftpd
Download the netboot image (only required during installation):
sudo mkdir /srv/tftp
cd /srv/tftp
sudo wget 'http://www.altraqua.com/blog/openwrt_rb133/vmlinux'
Power on the RB133 and activate the connection 'Share WIFI'!
Check if all is up and running:
sudo netstat -plantu

search for these lines:
tcp 0 0 10.42.43.1:53 0.0.0.0:* LISTEN 2523/dnsmasq
udp 0 0 0.0.0.0:69 0.0.0.0:* 1383/inetd

Configure boot loader


set /dev/ttyUSB0 (or other dev name) at 115200 8N1, no hardware or software flowcontrol.
Cycle power of RB133, press Canc key and you will see this screen:
RouterBOOT booter 2.7
RouterBoard 133
CPU frequency: 175 MHz
Memory size: 32 MB
Press <delete> key within 2 seconds to enter setup.
RouterBOOT-2.7
What do you want to configure?
d - boot delay
k - boot key
s - serial console
o - boot device
u - cpu mode
r - reset configuration
e - format nand
g - upgrade firmware
i - board info
p - boot protocol
t - do memory testing
x - exit setup
your choice:

Choose:
  1. 'boot protocol' then 'dhcp protocol'
  2. 'format nand'
  3. 'boot device' then 'boot from NAND, if fail then Ethernet'
  4. activate the connection 'Share WIFI'
  5. 'exit setup'

First netboot


BusyBox v1.8.2 (2008-05-30 09:59:52 EEST) built-in shell (ash)

.-----.-----.-----. .----. _
_______ __ _____ __ __ ________ __ ____
KAMIKAZE (bleeding edge, r11293) -------------------
* 10 oz Triple sec mixture into 10 shot glasses.
---------------------------------------------------
Now RB133 are running a reduced version of OpenWRT, only useful for the subsequent installation steps.Get IP address:



root@OpenWrt:/# passwd
Changing password for root
New password:
Retype password:
Password for root changed by root
root@OpenWrt:/#

Mount destination file systems:

mkdir /mnt/kernel
mkdir /mnt/rootfs
mount /dev/mtdblock2 /mnt/kernel
mount /dev/mtdblock3 /mnt/rootfs/

Now open a new console on you PC.
transfer kernel on flash:
wget -q 'http://www.altraqua.com/blog/openwrt_rb133/openwrt-adm5120-router_le-rb1xx-kernel' -O - ssh root@10.42.43.10 'cat > /mnt/kernel/kernel'
root@10.42.43.10's password:

transfer root filesystem on flash:
wget -q 'http://www.altraqua.com/blog/openwrt_rb133/openwrt-adm5120-router_le-rootfs.tar.gz' -O - ssh root@10.42.43.10 'tar -xz -C /mnt/rootfs'
root@10.42.43.10's password:
Wait about 1 minute.
On minicom console:

Enjoy!


BusyBox v1.15.3 (2011-09-15 15:04:40 CEST) built-in shell (ash)

.-----.-----.-----. .----. _
_______ __ _____ __ __ ________ __ ____
Backfire (10.03.1-RC6, r28299) --------------------
* 1/3 shot Bailey's on the bottom, then Bailey's,
---------------------------------------------------
openwrt-adm5120-router_le-rb1xx-kernel
openwrt-adm5120-router_le-rootfs.tar.gz
vmlinux

Ethernet to UART software bridge. (just google it). The program also opens the serial port. So all data received over TCP are send to serial port, and all data received over serial port are send over TCP. TtyATH0 - default openwrt serial port; 9600bps - serial baud rate; 8N1 - 8 bits, no parity, 1 stop bit.

Active1 month ago

Is there a way to connect to a serial terminal just as you would do with SSH? There must be a simpler way than tools such as Minicom, like this

I know I can cat the output from /dev/ttyS0 but only one way communication is possible that way, from the port to the console. And echo out to the port is just the same but the other way around, to the port.

How can I realize two way communication with a serial port the simplest possible way on Unix/Linux?

ihatetoregister
ihatetoregisterihatetoregister
1,4253 gold badges15 silver badges15 bronze badges

15 Answers

I find screen the most useful program for serial communication since I use it for other things anyway. It's usually just screen /dev/ttyS0 <speed>, although the default settings may be different for your device. It also allows you to pipe anything into the session by entering command mode and doing exec !! <run some program that generates output>.

Shawn J. GoffShawn J. Goff
31.3k19 gold badges114 silver badges134 bronze badges

Background

The main reason why you need any program like minicom to communicate over a serial port is that the port needs to be set up prior to initiating a connection. If it weren't set up appropriately, the cat and echo commands would not do for you what you might have expected. Notice that once you run a program like minicom, the port is left with the settings that minicom used. You can query the communication settings using the stty program like this:

If you have done it right; after booting the computer and before running any other program like minicom, the communication settings will be at their default settings. These are probably different than what you will need to make your connection. In this situation, sending the commands cat or echo to the port will either produce garbage or not work at all.

Run stty again after using minicom, and you'll notice the settings are set to what the program was using.

Minimal serial communication

Basically, two things are needed to have two-way communication through a serial port: 1) configuring the serial port, and 2) opening the pseudo-tty read-write.

The most basic program that I know that does this is picocom. You can also use a tool like setserial to set up the port and then interact with it directly from the shell.

rozcietrzewiaczrozcietrzewiacz
30.6k4 gold badges79 silver badges95 bronze badges

I found a way using a shell script here that put cat as a background process and a while loop that read the user input and echo it out to the port. I modified it to be more general and it fitted my purpose perfectly.

heemayl
38.2k3 gold badges83 silver badges111 bronze badges
ihatetoregisterihatetoregister
1,4253 gold badges15 silver badges15 bronze badges

If UUCP is installed on the system, you may use the command cu, e.g.

ktfktf

Try http://tio.github.io

'tio' is a simple TTY terminal application which features a straightforward commandline interface to easily connect to TTY devices for basic input/output.

Typical use is without options. For example:

Which corresponds to the commonly used options:

It comes with full shell auto completion support for all options.

Thomas
4,5137 gold badges15 silver badges31 bronze badges
MartinMartin

This script is based on another answer, but sends everything over the serial port (except Ctrl+Q), not just single commands followed by Enter. This enables you to use Ctrl+C or Ctrl+Z on the remote host, and to use interactive 'GUI' programs like aptitude or alsamixer. It can be quit by pressing Ctrl+Q.

Community
FritzFritz

BTW, the putty package (which does run on Linux) does include serial support.

mdpcmdpc
5,2312 gold badges19 silver badges38 bronze badges

Putty works well on Linux and offers some convenience, especially for serial communications. It has one drawback I haven't been able to directly solve: no copy-paste from the Putty window itself. The windows version has a lovely auto-copy to clipboard on highlight, right-click to paste behaviour (and there are excellent plugins for both chrome and firefox to enable the same behavior), but on Linux, no copy love AFAIK.

If the lack of copy is a problem (it is for me) then turn on logging in putty and open a standard terminal window and # tail -f putty.log and bidirectional text is available for standard copypasta action.

gesselgessel

Another issue that can occur is that your user account may need to set to the 'dialout' group to access the serial port.

GAD3R
30.4k19 gold badges63 silver badges123 bronze badges
dfowler7437dfowler7437

It depends on what you want to do. Do you want to run a shell or applicaiton interactively from the terminal, connect out to another computer over the serial line, automate communication with a device over a serial port?

If you want bidirectional communication then I presume you want something interactive with a human on the terminal. You can configure the system to allow logins from a terminal over a serial port by seting up a getty(1) session on the serial port - getty is the tool for setting up a terminal and allowing logins onto it. Put an entry in your inittab(5) file to run it on the appropriate serial port on a respawn basis.

If you want to connect to a device and initiate automated two way conversations then you could see if expect will get you what you want. Use stty(1) to configure the port to the right parity, baud rate and other relevant settings.

If you want to communicate interactively with another computer over the serial port then you will need terminal emulation software. This does quite a lot - it sets up the port, interprets ANSI or other terminal command sequences (ANSI was far from being the only standard supported by serial terminals). Many terminal emulators also support file transfer protocols such as kermit or zmodem.

The ins and outs of serial communications and terminal I/O are fairly complex; you can read more than you ever wanted to know on the subject in the serial howto.

ConcernedOfTunbridgeWellsConcernedOfTunbridgeWells

As mentioned before you can try picocom. The latest release (2.0) can also be used (safely) to set-up a 'terminal server' since it no longer permits shell command injection. See:

Nick PatavalisNick Patavalis

You might want to take a look at

Pro: doesn't have obvious security problems like minicom or picocom (if you don't have a problem giving the users shell access, no problem, but you most likely do have one if you want to set up a terminal server..)

PeterPeter

You need to be sure to have the correct read write permits on the device, you could see it with:

I rely on the script you found and made some modifications.

For the development systems I've used by now, they used to need:

  • None parity and
  • One stop bit

Those values are the default ones in the script.

So in order to connect, you can use it as simple as follows:

Example:

Script:

P.S.: You need to know which kind of line feed is using your receiver system since this will determine how you'll need to send the commands in my case I needed a Windows like LF, means that I need to send

ASCII values for:

  • LF : 0Ah, line feed 'n'
  • CR : 0Dh, carrige return 'r'
  • BS : 08h, back space '<-'
Rafael KarosuoRafael Karosuo

As it is not mentioned here already, I'd also mention socat - more info in https://stackoverflow.com/questions/2899180/how-can-i-use-com-and-usb-ports-within-cygwin :

Chapter Forty-Five. Chapter Forty-Six. Chapter Forty-Seven. Other Books by Veronica Roth. About the Publisher. When I found out that I was Divergent when I found out that Erudite would attack Abnegation those revelations changed everything. The truth has a way of. Divergent series pdf.

or

Serial Port Programming

(though, I've had the problem of stopping it once it starts running, under MSYS2 on Windows)

sdbbssdbbs

Another easy option is to access the machine over ssh with the -X flag and run a program such as putty or gtkterm.

So:

It should launch the graphical interface on your client PC and from there you can access the serial port as if you would be in the host.

Disclaimer: Only tried this with ubuntu machines. I'm guessing that it won't work with machines without graphic interfaces.

Serial Port Programming Windows

From the ssh manual:

-X

Enables X11 forwarding. This can also be specified on a per-host basis in a configuration file. X11 forwarding should be enabled with caution. Users with the ability to bypass file permissions on the remote host (for the user's X authorization database) can access the local X11 display through the forwarded connection. An attacker may then be able to perform activities such as keystroke monitoring. For this reason, X11 forwarding is subjected to X11 SECURITY extension restrictions by default. Please refer to the ssh -Y option and the ForwardX11Trusted directive in ssh_config(5) for more information.

Openwrt Serial Port Programming

-Y

Enables trusted X11 forwarding. Trusted X11 forwardings are not subjected to the X11 SECURITY extension controls.

So use -Y if security is an issue.

GrifoGrifo

Not the answer you're looking for? Browse other questions tagged command-lineterminalttyserial-portserial-console or ask your own question.