Skip to content

Commit

Permalink
Updating the README, CHANGELOG, and version to v2.4.0.
Browse files Browse the repository at this point in the history
  • Loading branch information
ssilverman committed Nov 13, 2018
1 parent 96a36ee commit 25dba96
Show file tree
Hide file tree
Showing 4 changed files with 41 additions and 10 deletions.
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,28 @@

This document details the changes between each release.

## [2.4.0]

### Added
* A basic _main_ program so that it's easy to compile the project.
* Support for Teensy 3.6's LPUART0 (Serial6).
* Support for Teensy LC.
* The ability to change the transmit refresh rate, via
`Sender::setRefreshRate`.

### Changed
* Reading from a packet via `Receiver::readPacket` no longer disables
all interrupts. Only the serial interrupts are disabled.
* The `TeensyDMX` constructor and destructor are now `protected`.
* BREAK/Mark-After-Break timing changed from 108us/12us to 180us/20us. This
more closely matches the "typical" DMX BREAK timing specified in the
DMX specification (ANSI E1.11).
* Some function and README documentation updates.
* Moved the `kMaxDMXPacketTime` constant into `Receiver`.

### Fixed
* Added some missing disable-interrupt cases to `Sender::end()`.

## [2.3.2]

### Changed
Expand Down
25 changes: 17 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,23 @@
# TeensyDMX

This is a library for receiving and transmitting DMX on Teensy 3.
This is a library for receiving and transmitting DMX on Teensy 3 and Teensy LC.
It follows the
[ANSI E1.11 DMX512-A specification](http://tsp.esta.org/tsp/documents/docs/ANSI-ESTA_E1-11_2008R2018.pdf).

There is no support yet for processing RDM.
There is no specific support yet for processing RDM or responding to other
alternate start codes.

## Features

Some notable features of this library:

1. Teensy's default serial buffer isn't used; the data goes directly to/from
the DMX buffers from/to the ISR's.
the DMX buffers from/to the UART ISR's.
2. Simple API: After setup, there's only one read call (`readPacket`) and two
forms of one write call (`set` for single and multiple channels).
3. The library properly handles DMX packets containing less than 513 slots.
4. The transmitter refresh rate can be changed to something less than
"maximum rate".

## How to use

Expand Down Expand Up @@ -103,17 +108,17 @@ Use `qindesign::teensydmx::Receiver` to receive and

From a UART perspective, there are two parts to a DMX frame:

1. Break, 83333 (1000000/12) baud, 8N1
2. 513 slots, 250000 baud, 8N2
1. Break, 50000 baud, 8N1
2. Up to 513 slots, 250000 baud, 8N2

The total frame time is:

10 bits * 12 us + 513 slots * 11 bits * 4us = 22692us, or a rate of about
44Hz.
10 bits * 20 us + 513 slots * 11 bits * 4us = 22772us, or a rate of about
43.91Hz.

## Code style

Code style for this project follows the
Code style for this project mostly follows the
[Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html).

## References
Expand All @@ -127,3 +132,7 @@ Inspirations for this library:
and
Paul Stoffregen's [DmxSimple](https://github.com/PaulStoffregen/DmxSimple).
2. Claude Heintz's [LXTeensy3DMX_Library](https://github.com/claudeheintz/LXTeensy3DMX_Library).
---
Copyright (c) 2017-2018 Shawn Silverman
2 changes: 1 addition & 1 deletion library.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
"type": "git",
"url": "https://github.com/ssilverman/TeensyDMX"
},
"version": "2.3.2",
"version": "2.4.0",
"license": "BSD-3-Clause",
"homepage": "https://github.com/ssilverman/TeensyDMX",
"frameworks": "arduino",
Expand Down
2 changes: 1 addition & 1 deletion library.properties
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
name=TeensyDMX
version=2.3.2
version=2.4.0
author=Shawn Silverman <[email protected]>
maintainer=Shawn Silverman <[email protected]>
sentence=A DMX library for the Teensy.
Expand Down

0 comments on commit 25dba96

Please sign in to comment.