Skip to content

An easy to use library to talk to a UART device under linux

License

Notifications You must be signed in to change notification settings

overrider/easyUART

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

easyUART

An easy to use library to talk to a UART device under linux

Introduction

This library was designed to connect with a UART device under /dev/ttyUSB0 and exchange data. In theory, all you have to do is download it, configure your UART device in app.h , and run make.

The program uses Linux signals to receive data so you are free to do whatever you like inside your main while loop. It is non-blocking.

Incoming data is read until \r is received, upon which the whole string gets added to an incoming buffer. From there, the main while loop will pick one Item in this buffer process and remove.

The same goes for outgoing. To send a command to the UART you call add_to_outgoing("Command"). This will add the command to an outgoing buffer. The main while loop will now, on each iteration, pick one outgong item and send it to the UART.

The code will send #PNG to the UART device every 10 seconds, and expects the UART device to send back #POK as a reply. If there is no reply received, the app will notice there is a communication issue. Of course you may take this part of the code out or adapt it to your personal needs.

Configuration

Adapt app.h to set your device and baudrate. If you don't have a UART device such as an Arduino to test with, you can emulate one using socat: socat -d -d pty,raw,echo=0 pty,raw,echo=0

Compilation

  1. cd easyUart
  2. make

Running ./make will result in uart_app. I developed and tested this under Debian Linux (Jessie) but i guess it will work fine for any common Distro.

About

An easy to use library to talk to a UART device under linux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published