Skip to content
Reactive serial communication library for Akka and Scala.
Scala C Makefile CMake Shell C++
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci
Documentation
core
dev/arduino-terminal
native
project
samples
stream
sync
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
build.sbt

README.md

Scaladex Build Status Download

akka-serial

Serial communication library for Scala, designed to be reactive, lightweight and easily integrable with Akka applications. See the website for a guide.

Highlights

  • Reactive: only does work when required (no constant polling of ports or blocking IO)
  • Integrates seamlessly with Akka
  • Portable to POSIX systems
  • Watchable ports: react to connection of new device
  • Compatible with Reactive Streams

Native side

Since hardware is involved in serial communication, a Scala-only solution is not possible. Nevertheless, the native code is kept simple and minimalistic with the burden of dealing with threads left to Scala. The code aims to be POSIX compliant and therefore easily portable.

Directory Structure

akka-serial/
├── Documentation         Sources for user documentation as published on the website.
├── core                  Main Scala source files.
├── dev                   Firmware samples for serial devices, to make testing easier.
├── native                C sources used to implement serial communication.
│   └── lib_native        Compiled native libraries that are published in the fat jar.
├── project               Build configuration.
├── samples               Runnable example projects.
├── stream                Stream API, used to connect with Akka streams.
└── sync                  Synchronous, non-Akka-dependent code.

Website source code is in the git branch 'gh-pages'.

Build

Detailed documentation on building akka-serial is available on the website (or, equivalently, in developer.md).

Since akka-serial integrates into the Akka-IO framework, a good resource on its general design is the framework's documentation.

This project is also an experiment on working with JNI and automating build infrastructure.

Copying

akka-serial is released under the terms of the 3-clause BSD license. See LICENSE for details.

Notes

This project used to be called "flow". It was renamed to "akka-serial".

You can’t perform that action at this time.