/P2-OctoSerial-subsystem

A Parallax Propeller V2 Object Set for maintaining eight simultaneous serial ports

Primary LanguagePythonMIT LicenseMIT

P2-OctoSerial-subsystem

A Parallax Propeller v2 Object for maintaining 2-8 simultaneous serial ports using one COG

Project Maintenance

License

8 Serial Ports using a single COG

A single COG services from 1 to 8 Tx/Rx pairs of pins. The pins are configured as smart-pins which means that the driver feeds bytes to transmit pins when needed and get bytes from receive pins when bytes are available. This backend driver is written in pasm2. The interface routines are written in spin2.

A method is supplied that interprets newlines (0x0A) as line ends. (This allows the driver to work with LF or CRLF terminated lines.). This method when called frequently enough unloads the back-end circular buffers into string buffers, one for each active port. When a string has completely arrive it returns the complete strings.

Table of Contents

On this Page:

Additional pages:

Driver Features

... coming soon ...

Current status

Latest Changes:

2022-11-23 Draft release v1.0.0
- Services 1 to eight ports
- Tested initial configuration: 115,200 bps, N81
- Validated with serial decoding logic analyzer
- Tested Raspberry Pi <-> P2
- Tested P2 <-> P2

Known Issues

We have more plans in the works:

  • Characterize: Find and document at this repo the highest speeds the driver can do against various devices without data loss
  • Add more discrete port control if users find a need (e.g., 2-stop bits, etc.)

How to Contribute

This is a project supporting our P2 Development Community. Please feel free to contribute to this project. You can contribute in the following ways:

  • File Feature Requests or Issues (describing things you are seeing while using our code) at the Project Issue Tracking Page
  • Fork this repo and then add your code to it. Finally, create a Pull Request to contribute your code back to this repository for inclusion with the projects code. See CONTRIBUTING

If you like my work and/or this has helped you in some way then feel free to help me out for a couple of ☕'s or 🍕 slices!

coffee    -OR-    PatreonPatreon.com/IronSheep


Disclaimer and Legal

Parallax, Propeller Spin, and the Parallax and Propeller Hat logos are trademarks of Parallax Inc., dba Parallax Semiconductor

This project is a community project not for commercial use.

This project is in no way affiliated with, authorized, maintained, sponsored or endorsed by Parallax Inc., dba Parallax Semiconductor or any of its affiliates or subsidiaries.


License

Copyright © 2022 Iron Sheep Productions, LLC. All rights reserved.

Licensed under the MIT License.

Follow these links for more information:

Copyright | License