Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update documentation #84

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

PaulBouchier
Copy link

Fix issue #83
Adds documentation of SerialTransfer data members which are not valid when a callback function runs, and explains limitations on the non-blocking feature.

These changes were tested on Arduino Uno with and without the __attribute__, and using
SoftwareSerial for the rx_datum and rx_data tests, and Serial for the tx_data/datum tests,
to ensure they didn't change behavior. They were tested on ESP32 Feather to check that the
test failed without the __attribute__ and passed with it. HardwareSeral(1) was used instead
of Serial1. Then the esp32-specific (and for Uno, the SoftwareSerial-specific) changes were
backed out, leaving only the __attribute__ change.

These changes address issue PowerBroker2#51 in pySerialTransfer, by fixing TestStruct in SerialTransfer.
Another pull request will make the corresponding changes to examples in pySerialTransfer.
@PaulBouchier
Copy link
Author

The second push to this branch fixes the attribute((packed)) issue described in pySerialTransfer issue 51 in this repo.

@PaulBouchier
Copy link
Author

Ping. Respectfully, do you have an interest in getting this code documented with doxygen?

@PaulBouchier
Copy link
Author

Ping. Respectfully, this pull request fixes the examples so they work on esp32 by adding the attribute((packed)), and updates the Readme with details about callbacks. I did considerable testing on both Arduino Uno and ESP32 with pySerial on linux to ensure I didn't break anything. Is it suitable for merging? Or is there overhead that makes you want to accumulate more changes before you merge and release?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant