Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
serial-framing-protocol-python
Manage
Activity
Members
Labels
Plan
Issues
0
Issue boards
Milestones
Wiki
Code
Merge requests
0
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package Registry
Container Registry
Operate
Environments
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
This is an archived project. Repository and other project resources are read-only.
Show more breadcrumbs
CdF
CdF 2020-2021
modules
libraries
communication
serial-framing-protocol-python
Commits
57c4a260
Commit
57c4a260
authored
4 years ago
by
Charles JAVERLIAT
Browse files
Options
Downloads
Patches
Plain Diff
Update README.md
parent
09dd6989
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+43
-0
43 additions, 0 deletions
README.md
with
43 additions
and
0 deletions
README.md
0 → 100644
+
43
−
0
View file @
57c4a260
# Serial framing protocol
This library provides a way to frame data safely (including a corruption check).
## How-to-use
### Framing data
```
python
# The data to be framed
data
=
bytearray
([
0x12
,
0x34
,
0x56
])
# Frame and store the result in framed_data
framed_data
=
bytearray
()
frame_data
(
data
,
framed_data
)
# Print the hexadecimal representation of the result
# This will return b'7e0003123456bf127f'
print
(
binascii
.
hexlify
(
framed_data
))
```
The actual byte sent are
`0x7e 0x0 0x3 0x12 0x34 0x56 0xbf 0x12 0x7f`
.
In those bytes:
-
`0x7e`
is the start of frame flag (1 byte)
-
`0x0 0x3`
is the data size (2 bytes)
-
`0x12 0x34`
is the data we are sending (n bytes)
-
`0xbf 0x12`
is the cyclic redundancy check (2 bytes), it helps checking for any corruption of the data
-
`0x7f`
is the end of frame flag (1 byte)
### Unframing data
```
python
# The frame to unframe the data from
framed_data
=
bytearray
([
0x7e
,
0x0
,
0x3
,
0x12
,
0x34
,
0x56
,
0xbf
,
0x12
,
0x7f
])
# Unframe and store the result in unframed_data
unframed_data
=
bytearray
()
unframe_data
(
framed_data
,
unframed_data
)
# Print the hexadecimal representation of the result
# This will return b'123456'
print
(
binascii
.
hexlify
(
unframed_data
))
```
This diff is collapsed.
Click to expand it.
Preview
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment