https://github.com/tiagocoutinho/gserial

gevent friendly serial line
https://github.com/tiagocoutinho/gserial

gevent python ser2net serial tcp-bridge

Last synced: about 2 months ago
JSON representation

gevent friendly serial line

• Host: GitHub
• URL: https://github.com/tiagocoutinho/gserial
• Owner: tiagocoutinho
• Created: 2019-10-01T19:01:45.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-23T16:08:51.000Z (almost 5 years ago)
• Last Synced: 2024-10-09T10:04:49.279Z (2 months ago)
• Topics: gevent, python, ser2net, serial, tcp-bridge
• Language: Python
• Size: 91.8 KB
• Stars: 3
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# gevent-serial

A python 3 [gevent](https://gevent.org) friendly access to the serial port.

Deeply inspired by [pyserial](https://github.com/pyserial/pyserial). It tries to mimic

its interface but it doesn't aim to garantee full API compatibility.

For now only Linux (and possibly any BSD or posix complient system) is supported.

Support for local serial port, RFC2217, and RS485 (untested).

Includes an optional serial to TCP bridge (experimental).

## Installation

From within your favourite python environment:

```console

$ pip install gevent-serial

```

### Serial to TCP bridge

Optional serial to TCP bridge using RFC2217 or Raw TCP protocols.

It requires you to install the optional server package with:

```console

$ pip install gevent-serial[ser2tcp]

```

The ser2tcp server needs a configuration file written in YAML.

It consists of a list of entries. Each entry describes:

* url: the serial port address (ex: /dev/ttyS0),

* listener: the TCP port listener (ex: :8000)

* mode: socket mode (rfc2217 or raw) (default: rfc2217)

* ... any other property accepted by the Serial object constructor

  (ex: baudrate, parity)

Here is an example:

```yaml

- url: /dev/ttyS0

  baudrate: 9600

  listener: :2217   # listen on all network interfaces, TCP port 2217

  mode: rfc2217

- url: /dev/ttyS1

  baudrate: 115200

  mode: raw

  listener: :2218

- url: loop://

  listener: :2219

  baudrate: 115200

  mode: raw

- url: loop://

  listener: :2220

  baudrate: 9600

  mode: rfc2217

```

To start the ser2tcp server simply type:

```console

$ ser2tcp -c 

```

(type `ser2tcp --help` to see additional options)