Skip to main content

Arduino simpleRPC API client library and CLI.

Project description

https://img.shields.io/github/last-commit/jfjlaros/arduino-simple-rpc.svg https://travis-ci.org/jfjlaros/arduino-simple-rpc.svg?branch=master https://readthedocs.org/projects/simplerpc/badge/?version=latest https://img.shields.io/github/release-date/jfjlaros/arduino-simple-rpc.svg https://img.shields.io/github/release/jfjlaros/arduino-simple-rpc.svg https://img.shields.io/pypi/v/arduino-simple-rpc.svg https://img.shields.io/github/languages/code-size/jfjlaros/arduino-simple-rpc.svg https://img.shields.io/github/languages/count/jfjlaros/arduino-simple-rpc.svg https://img.shields.io/github/languages/top/jfjlaros/arduino-simple-rpc.svg https://img.shields.io/github/license/jfjlaros/arduino-simple-rpc.svg

This library provides a simple way to interface to Arduino functions exported with the simpleRPC protocol. The exported method definitions are communicated to the host, which is then able to generate an API interface using this library.

Features:

  • User friendly API library.
  • Command line interface (CLI) for method discovery and testing.
  • Function and parameter names are defined on the Arduino.
  • API documentation is defined on the Arduino.
  • Support for disconnecting and reconnecting.

Please see ReadTheDocs for the latest documentation.

Quick start

Export any function e.g., digitalRead() and digitalWrite() on the Arduino, these functions will show up as member functions of the Interface class instance.

First, we make an Interface class instance and tell it to connect to the serial device /dev/ttyACM0.

>>> from simple_rpc import Interface
>>>
>>> interface = Interface('/dev/ttyACM0')

We can use the built-in help() function to see the API documentation of any exported method.

>>> help(interface.digital_read)
Help on method digital_read:

digital_read(pin) method of simple_rpc.simple_rpc.Interface instance
    Read digital pin.

    :arg int pin: Pin number.

    :returns int: Pin value.

All exposed methods can be called like any other class method.

>>> interface.digital_read(8)         # Read from pin 8.
0
>>> interface.digital_write(13, True) # Turn LED on.

Further reading

For more information about the host library and other interfaces, please see the Usage and Library sections.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for arduino-simple-rpc, version 2.0.1
Filename, size File type Python version Upload date Hashes
Filename, size arduino-simple-rpc-2.0.1.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page