Skip to content

Commit cde064b

Browse files
committed
Updated README.md and added CHANGELOG.md
1 parent ed9e42b commit cde064b

File tree

2 files changed

+37
-4
lines changed

2 files changed

+37
-4
lines changed

CHANGELOG.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Changelog
2+
3+
## v2.0.0
4+
Released 17 September 2015
5+
6+
Highlights:
7+
* Added: Python 3.4 support.
8+
* Improved: More strict handling of bytes.
9+
* Improved: Formatted code according to PEP8.
10+
* Changed: ResetFrame is now a Frame, with correct flags set.
11+
* Changed: DamagedFrame is now a property on a Frame.
12+
13+
The full list of commits can be found [here](https://github.com/basilfx/python-tinylink/compare/v1.1.0...v2.0.0).
14+
15+
## v1.1.0
16+
Released 01 December 2014
17+
18+
The full list of commits can be found [here](https://github.com/basilfx/python-tinylink/compare/v1.0.0...v1.1.0).
19+
20+
## v1.0.0
21+
Released 07 October 2014
22+
23+
The full list of commits can be found [here](https://github.com/basilfx/python-tinylink/compare/76afcbd301ca3ec4c58e232a10a7547a1e4ce982...v1.0.0).

README.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
# python-tinylink
22
Frame-based streaming protocol for embedded applications.
33

4+
[![Build Status](https://travis-ci.org/basilfx/python-tinylink.svg?branch=master)](https://travis-ci.org/basilfx/python-tinylink)
5+
46
## Introduction
57
This is a general purpose Python module to provide a bi-directional frame-based streaming protocol for low-speed embedded applications, such as serial connected devices. It allowes the receiver to 'jump into' a stream of data frames. Every frame starts with a preamble, so the receiver can synchronize. Any mismatch in checksum will the receiver.
68

7-
A payload is optional. The reserved `RESET` flag can be used to indicate that the link should reset, for instance when the receiver just started and the sender should restart.
9+
A payload is optional.
810

911
The format of a frame is as follows:
1012

@@ -20,20 +22,28 @@ X = Body payload (max. 65536 bytes)
2022
Y = CRC32 checksum over header + body
2123
```
2224

25+
The flags field can have arbitrary values, but the following flags are reserved.
26+
27+
* `0x01 = RESET`
28+
* `0x02 = ERROR`
29+
* `0x04 = PRIORITY`
30+
2331
Error correction is not implemented and the bytes are not aligned. The endianness is customizable.
2432

25-
## Statechart diagram
33+
## State chart diagram
2634
Below is a simplified statechart diagram of the receiver.
2735
![Alt text](docs/statechart.png)
2836

2937
## Installation
3038
The latest development version can be installed via `pip install git+https://github.com/basilfx/python-tinylink`.
3139

3240
## Tests
33-
Tests can be executed with `nose`. Check the `tests/` folder for more information.
41+
Tests can be executed with `nosetests`. Check the `tests/` folder for more information.
3442

3543
## CLI
3644
A simple serial CLI is included. When installed, run `tinylink /dev/tty.PORT_HERE` to start it. You can use it to send raw bytes via the link and display what comes back.
3745

46+
PySerial is required to run this CLI.
47+
3848
## License
39-
See the `LICENSE` file (MIT license).
49+
See the `LICENSE` file (MIT license).

0 commit comments

Comments
 (0)