Skip to main content

Concurrency agnostic serialio API

Project description

serialio

Pypi version

A python concurrency agnostic serial line library.

Helpful when handling with instrumentation which work over serial line and implement simple REQ-REP communication protocols (example: SCPI).

So far, only serial line over RFC2217 protocol and raw socket are available. It should be compatible with:

  • ser2net bridge with telnet(RFC2217) and raw configurations
  • gserial[ser2tcp] bridge (RFC2217)

Base implementation written in asyncio with support for different concurrency models:

  • asyncio
  • classic blocking API (TODO)
  • future based API (TODO)

Here is a summary of what is forseen and what is implemented

Concurrency Local RFC2217 Raw TCP
asyncio Y Y Y
classic sync N N N
conc. futures N N N

Installation

From within your favourite python environment:

pip install serialio

Usage

asyncio

import asyncio
from serialio.aio.tcp import Serial

async def main():
    sl = Serial("raw.ser2net.com", 5000)
    await sl.open()
    # Assuming a SCPI complient on the other end we can ask for:
    reply = await sl.write_readline(b"*IDN?\n")
    print(reply)
    await sl.close()

asyncio.run(main())

classic (TODO)

from serialio.aio.tcp import Serial

sl = Serial("raw.ser2net.com", 5000)
reply = sl.write_readline(b"*IDN?\n")
print(reply)

concurrent.futures (TODO)

from serialio.sio.tcp import Serial

sl = Serial("raw.ser2net.com", 5000, resolve_futures=False)
reply = sl.write_readline(b"*IDN?\n").result()
print(reply)

API differences with serial

  • coroutine based API
  • open() coroutine must be called explicitly before using the serial line
  • setting of parameters done through functions instead of properties (ie: await ser_line.set_XXX(value) instead of ser_line.XXX = value (ex: `await ser_line.set_baudrate()))
  • custom eol character (serial is fixed to b"\r")
  • included REQ/REP atomic functions (write_read() family)

Features

The main goal of a serialio Serial object is to facilitate communication with instruments connected to a serial line.

The most frequent cases include instruments which expect a REQ/REP semantics with ASCII protocols like SCPI. In these cases most commands translate in small packets being exchanged between the host and the instrument.

REQ-REP semantics

Many instruments out there have a Request-Reply protocol. A serialio Serial provides helpfull write_read family of methods which simplify communication with these instruments.

Custom EOL

In line based protocols, sometimes people decide \n is not a good EOL character. A serialio can be customized with a different EOL character. Example:

sl = Serial("raw.ser2net.com", 5000, eol=b"\r")

The EOL character can be overwritten in any of the readline methods. Example:

await sl.write_readline(b"*IDN?\n", eol=b"\r")

Streams

TODO: Write this chapter

Project details


Download files

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

Source Distribution

serialio-1.1.0.tar.gz (19.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page