Gurux serial media is used to commmunication with serial port connections.
Project description
See An Gurux for an overview.
Join the Gurux Community or follow @Gurux for project updates.
With gurux.serial component you can send data easily syncronously or asyncronously using serial port connection.
Open Source GXNet media component, made by Gurux Ltd, is a part of GXMedias set of media components, which programming interfaces help you implement communication by chosen connection type. Gurux media components also support the following connection types: serial port.
For more info check out Gurux.
We are updating documentation on Gurux web page.
If you have problems you can ask your questions in Gurux Forum.
You can get source codes from http://www.github.com/gurux or intall package:
pip install gurux-common pip install gurux-serial
Simple example
Before use you must set following settings:
- PortName
- BaudRate
- DataBits
- Parity
- StopBits
It is also good to add listener to listen following events.
- onError
- onReceived
- onMediaStateChange
- onTrace
- onPropertyChanged
This example sends data to the serial port and waits reply. Change serial port before use.
import time from gurux_common import ReceiveParameters from gurux_common import IGXMediaListener from gurux_common.enums.TraceLevel import TraceLevel from gurux_serial import GXSerial #pylint: disable=no-self-argument class sampleclient(IGXMediaListener): def __init__(self): #List available serial ports. print("Available ports:") print(str(GXSerial.getPortNames())) #Define End Of Packet char. eop = '\r' #TODO: Update correct port and serial port settings. media = GXSerial("SERIAL PORT TO USE") #Start to listen events from the media. media.addListener(self) #Show all traces. media.trace = TraceLevel.VERBOSE #Set EOP for the media. media.eop = eop try: #Open the connection. media.open() r = ReceiveParameters() r.eop = eop #Minimium amount of bytes to receive. r.count = 5 #Wait reply for 2 seconds. r.waitTime = 2000 ############################ #Send data synchronously. with media.getSynchronous(): media.send("Hello world!") #Send EOP media.send('\r') ret = media.receive(r) if ret: print(str(r.reply.decode("ascii"))) else: raise Exception("Failed to receive reply from the server.") ############################ #Send async data. media.send("Notify from the meter!\r") #Wait 1 second to receive reply from the server. time.sleep(1) except Exception as ex: print(ex) media.close() media.removeListener(self) def onError(self, sender, ex): """ Represents the method that will handle the error event of a Gurux component. sender : The source of the event. ex : An Exception object that contains the event data. """ print("Error has occured. " + str(ex)) def onReceived(self, sender, e): """Media component sends received data through this method. sender : The source of the event. e : Event arguments. """ print("New data is received. " + str(e)) def onMediaStateChange(self, sender, e): """Media component sends notification, when its state changes. sender : The source of the event. e : Event arguments. """ print("Media state changed. " + str(e)) def onTrace(self, sender, e): """Called when the Media is sending or receiving data. sender : The source of the event. e : Event arguments. """ print("trace:" + str(e)) def onPropertyChanged(self, sender, e): """ Event is raised when a property is changed on a component. sender : The source of the event. e : Event arguments. """ print("Property {!r} has hanged.".format(str(e))) if __name__ == '__main__': sampleclient()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size gurux_serial-1.0.15-py3-none-any.whl (29.5 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size gurux_serial-1.0.15.tar.gz (17.4 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for gurux_serial-1.0.15-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 90af688e57bb6100bc3eea0a76850a0b98d9ab2bb72e95412a7380c037a13603 |
|
MD5 | 79b0e5e6608040b80e915d91fc6cd0a4 |
|
BLAKE2-256 | 747fd7777cf5579184691a778de991708b2ecd4877eaf6da9853c4f5c3fd7ab6 |