Skip to content
This repository

IPC for Real-Time Robot Control

branch: master

New release

latest commit 09abfd823a
Neil T. Dantam ndantam authored April 07, 2014
Octocat-spinner-32 cpp Const buffer for ach::Channel::put() October 01, 2013
Octocat-spinner-32 debian New release April 07, 2014
Octocat-spinner-32 doc New release April 07, 2014
Octocat-spinner-32 etc achpipe feature: added flags to open remote tcp connection December 27, 2009
Octocat-spinner-32 include Clarify meaning of ACH_OVERFLOW in documentation March 07, 2014
Octocat-spinner-32 java Update javadocs October 02, 2013
Octocat-spinner-32 lisp Add Lisp function that reads to foreign heap February 14, 2014
Octocat-spinner-32 m4 Autotools updates November 01, 2011
Octocat-spinner-32 python Fix URLs in python README.txt April 28, 2013
Octocat-spinner-32 spin authors, copying, headers, for make-common, amino, ach, somatic September 21, 2011
Octocat-spinner-32 src Send only non-zero periods in achd client April 07, 2014
Octocat-spinner-32 .gitignore Debian package C++ and Java wrappers October 31, 2013
Octocat-spinner-32 .gitmodules Remove old Makefile March 10, 2012
Octocat-spinner-32 AUTHORS Update authors list October 01, 2013
Octocat-spinner-32 CMakeLists.txt New release April 07, 2014
Octocat-spinner-32 COPYING Add Python packaging via distutils February 10, 2013
Octocat-spinner-32 ChangeLog Autotools build October 21, 2011
Octocat-spinner-32 Doxyfile Update documentation February 10, 2013
Octocat-spinner-32 INSTALL Refactor C++ wrapper October 01, 2013
Octocat-spinner-32 Makefile.am New release April 07, 2014
Octocat-spinner-32 NEWS New release April 07, 2014
Octocat-spinner-32 README Refactor C++ wrapper October 01, 2013
Octocat-spinner-32 README.md Markdown README and doxygen link August 26, 2012
Octocat-spinner-32 ach.pc.in Add pkg-config file May 26, 2013
Octocat-spinner-32 achlog.py Create C version of achlog based on achd protocol May 26, 2013
Octocat-spinner-32 achpipe Disable unused configure tests November 16, 2012
Octocat-spinner-32 achtooltest Port achtooltest to Solaris 9 /bin/sh October 22, 2011
Octocat-spinner-32 configure.ac New release April 07, 2014
Octocat-spinner-32 doxygen.am Autotooled Doxygen March 12, 2012
Octocat-spinner-32 manifest.xml Remove bogus ROS deps October 03, 2011
Octocat-spinner-32 pycompile ach feature: python subscription support January 07, 2010
Octocat-spinner-32 test-achcop Add achcop test script May 15, 2013
README.md

OVERVIEW

Ach is an Inter-Process Communication (IPC) mechanism and library. It is especially suited for communication in real-time systems that sample data from physical processes. Ach eliminates the Head-of-Line Blocking problem for applications that always require access to the newest message. Ach is efficient, robust, and formally verified. It has been tested and demonstrated on a variety of physical robotic systems. Source code for Ach is available under an Open Source BSD-style license.

INSTALLATION

./configure && make && make install

See the INSTALL file for details.

Alternatively, if you are using Debian or Ubuntu, you can use the golems.org APT repo.

  1. Add the following to /etc/apt/sources:

    deb http://code.golems.org/debian squeeze golems.org

    (substitute the codename for your distribution in place of squeeze, e.g. wheezy, precise)

  2. sudo apt-get update && sudo apt-get install libach-dev ach-utils

  3. sudo dpkg-reconfigure ach-utils

DOCUMENTATION

LANGUAGE BINDINGS

Language bindings are included for Common Lisp, Python, and Java.

  • Common Lisp bindings use CFFI and can be loaded with ASDF.

  • Python bindings are a C extension module and a Python module 'ach'. This can be installed either via make install or via Python's distutils/pip.

  • C++ bindings wrap the C API. See ./include/Ach.hpp

  • Java bindings via the Java Native Interface (JNI). See ./doc/javadoc or http://golems.github.io/ach/javadoc/

See the INSTALL file for details.

FORMAL MODEL

Ach has been formally verified using the SPIN model checker. This formal model is included in the source distribution under the ./spin/ directory.

Something went wrong with that request. Please try again.