Skip to content

A Python module for simultaneous communication with multiple serial ports, based on pyserial module

License

Notifications You must be signed in to change notification settings

SunitRaut/pyMultiSerial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pyMultiSerial

GitHub release license DOI

A Python module for continuous communication with multiple serial ports, based on pyserial module. PyMultiSerial has an Event-driven architecture with events like Connection, Disconnection, incoming data from port, etc.

Features:

  • Monitor multiple serial ports simultaneously.
  • Detect connections to ports automatically and start monitoring them.
  • Raises a trigger whenever data is received from the port. You can attach a callback function to process this data on demand.
  • Detect disconnections from the port automatically.
  • You can add your processing logic to the above events using callback functions

If you Like my Work, Buy me a Coffee!

If this library makes your life easier and has helped bring your project to reality, I would appreciate a small token of gratitude. Click on the below icon to contribute.

Buy Me A Coffee

How to Install:

pip3 install pyMultiSerial

Dependencies:

Dependencies are automatically installed during the installation of pyMultiSerial.

  • PySerial
  • Threading

How to use

pyMultiSerial is very easy to use! Below are the important statements & functions of the library. Do check the Examples folder for simple examples to get started with.

Step 1: Initialize

Import Module

import pyMultiSerial as p

Create Object

ms = p.MultiSerial()

Set Properties of Object:

ms.baudrate = 9600    
ms.timeout = 2

Step 2: Define Callback Functions

Callback functions are the functions defined by you in your program which are triggered by pyMultiSerial module whenever an event occurs.

The pyMultiSerial module provides 5 callback events for which you can define functions:

  1. New Serial Port Connection Found - Allows you to write a function which triggers when a new serial port connection is found. With this feature, you can perform many operations like authenticating, performing handshake or simply creating a list of newly connected devices.
  2. Data Received on a Serial Port - Allows you to write a function which triggers when any data is received on the serial port. With this feature, you can process incoming data from serial ports.
  3. Device disconnected from Serial Port - Allows you to write a function which triggers when any device is disconnected. With this feature, you can keep track of serial ports that have been disconnected.
  4. On Keyboard Interrupt (Ctrl+C) by user - Allows you to write a function which triggers when you force stop the python script with keyborard interrupt or through your Python IDE. This feature allows you to perform any clean up activities necessary before exiting your application.
  5. Continuous Loop Execution - Allows you to write a function which triggers continuously. With this feature, you can perform repitive / periodic tasks. Don't forget to add appropriate delay in this callback since this event occurs continuously. The user gets to decide what frequency / delay is needed.

Note: All the above callbacks are optional. You need to only program those callbacks which you need.

How to define and register callback function:

def your_func_name(standard_arguments):
    Your Statements
    End of function
#register callback function
ms.callback_name = your_func_name

Here, your_func_name can be any name as decided by you. Arguments passed to this function should be in accordance to the standard_arguments as defined in below table. These arguments will be passed from pyMultiSerial module to your function. callback_name is the property name of the callback event to which you need to assign your function as shown in above snippet.

Event callback_name standard_arguments for callback function
New Serial Port Connection Found port_connection_found_callback Port Number, Serial Port Object
Data Received on a Serial Port port_read_callback Port Number, Serial Port Object, Data
Device disconnected from Serial Port port_disconnection_callback Port Number
On Keyboard Interrupt (Ctrl+C) by user interrupt_callback -
Continuous Loop Execution loop_callback -

In the above table, there are mainly three types of arguments:

  1. Port Number - The Port Number of the port on which the event has occured.
  2. Serial Port Object - pySerial Object of the Port on which event has occured. This object can be used to read, write to the port from your callback function.
  3. Data - Data received from Serial Port in String format.

Note: You must include above paramenters in your function definition. However, it is optional to use those parameters.

Step 3: Start Monitoring

Start Monitoring with below statement:

ms.Start()

Caution: Since this module monitors all serial ports simultaneously, ms.Start() is a blocking function. Unless you don't stop monitoring using Stop() method, the execution will be stuck at this line. Start() method should ideally be called at the end of your code. To perform other opertions, you should use the provided callback functions. Caution: Callback functions should be defined before ms.Start() statement. The Callback functions should be registered with the object before monitoring is started, else your callback functions won't be called.

If you need to stop monitoring for any reason, use below statement:

ms.Stop()

Here is an instructable with simple Arduino-Raspberry Pi example

Hope this module helps you to build your Projects. In case of any issues do open an Issue on Github.

About

A Python module for simultaneous communication with multiple serial ports, based on pyserial module

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages