PJON Versions Save

PJON v9.0 is orders of magnitude more reliable and secure than older versions because of some key changes made in its network protocol stack. Its compatibility has been vastly expanded now covering TCP or UDP standard networking on Windows and Linux real time operative systems.

New specifications:

• PJON protocol specification v2.0
• PJON Acknowledge v1.0
• PJON Dynamic addressing v1.0
• PJDL v2.0 - PJDLR v2.0 - PJDLS v1.0 - TSDL v1.0

Changelog:

• Frame separation feature has been added to each data link or strategy to higher reliability and avoid a set of vulnerabilities. Frame separation is obtained, in some cases, like in TSDL or PJDLS using byte-stuffing, in others like PJDL or PJDLR using a unique low level binary symbol
• An additional CRC8 has been added after the length to avoid the length corruption vulnerability, that is affecting CAN and many other alternatives, providing with higher reliability at the cost of 1 byte of overhead
• CRC8 0x8c polynomial used in 1-Wire and PJON older versions has been changed with 0x97, this polynomial has the largest possible length (119 bit) at which HD=4 can be achieved with 8-bit CRC, offering higher reliability on longer strings
• CRC32 is automatically applied if packet length exceeds 15 bytes, packets requesting CRC8 longer than 15 bytes are considered unacceptable to by default higher reliability and avoid a set of vulnerabilities
• More accurate header consistency check
• WINX86 support and examples to EthernetTCP, LocalUDP and GlobalUDP enabling PJON to run over the internet on windows computers by @fredilarsen
• LINUX support and examples to EthernetTCP, LocalUDP and GlobalUDP enabling PJON to run over the internet on linux computers by @fredilarsen
• ESP8266 support and examples to GlobalUDP by @fredilarsen
• send_from_id added id parameter to support async ack packet routing
• OverSampling, AnalogSampling and SoftwareBitBang communication mode names switched to numeric constants, see related specifications
• ThroughSerial HC-12 wireless module compatibility and related examples added
• ThroughSerial RS485 related examples added
• SoftwareBitBang RecursiveAcknowledge example added using the recursive acknowledgment pattern
• SoftwareBitBang PacketSeparationTest example added able to test frame separation accuracy

Bugfix:

• Fix uninitialized response by @girgitt (https://github.com/gioblu/PJON/commit/b0d2711c2a6fe42c9ab1e47bd1fe6a3244639211)
• receive length check bugfix (https://github.com/gioblu/PJON/commit/e1b97e2a0c8456b54f042e9953a1ea4fcf7ebf1a)
• PJONMaster RID condition bugfix (https://github.com/gioblu/PJON/commit/0f1d26504fbdd0fb6fc5e01fe17a33664206124d)
• receive acknowledge condition bugfix (https://github.com/gioblu/PJON/commit/92dcdcdae7fe976e0d8302b014160299a2e121e2)
• Avoid async ack response if router (https://github.com/gioblu/PJON/commit/18a5857c9240ee97dd43491abb9aec9161be83d1)

This version is not backward compatible, all devices must be updated!

It is recommended to use VPN and/or other security measures when allowing devices to communicate across the internet.

Changelog:

• With AnalogSampling is now possible to communicate wirelessly or through single channel optic fiber cables up to 12658Bd or 1.52kB/s using a single LED for both transmission and reception phases, enabling users to create a wireless bus using only one analog pin and a cheap light emitting diode for each device. The range if used wirelessly is around 5 meters in ideal conditions, much more if used with optic fiber cables
• Examples are now structured as following: architecture/mode/data-link/example or ARDUINO/local/SoftwareBitBang/Blink
• devices directory has been added to propose a space where users can share their PJON compatible builds and propose basic implementation examples
• Early version of the LEDAR proximity sensor device added to devices directory
• Added dispatched method to avoid async ack response duplications in buffer (https://github.com/gioblu/PJON/commit/58c46724bb6e1453dc7d6ca772695efd347256e4)
• Reduced CPU load for WINX86 interface using ThroughSerial thanks to @Girgitt (https://github.com/gioblu/PJON/commit/bfe935c68413c1a1ef4d5f986f03895fb45b5c1c)
• RS485 pin handling for separate RX/TX enable thanks to @ekarlso
• Added a "timing hack" only for RPI to force flush method to wait for transmission and so enable the nominal use of RS485 transceivers; wiringPi flush method seems broken, not waiting for transmission end, thanks for testing to @ekarlso (https://github.com/gioblu/PJON/commit/30b94d8820e3a3bab0a5b639f4dd374d9b3312a9)

Bugfix:

• Removed useless buffer and condition from PJON begin method sparing some bytes of memory
• Fix delay call in begin of AnalogSampling, OverSampling and SoftwareBitBang, using interface
• RPI example bugfix, added missing timeout configuration (https://github.com/gioblu/PJON/commit/e8ab099cec1ea130b79cc71715f25b2ee1613455)

Changelog:

• PJON now supports Windows laptops / desktop computers (for now working only with the ThroughSerial strategy) thanks to the WINX86 interface, proposed and developed by @Girgitt
• WINX86 examples directory added
• Raspberry Pi examples directory added
• Documentation, specification and README enhancement

Bugfix:

• Send packet using its original header and not the actual header configuration (https://github.com/gioblu/PJON/commit/d072ceda7c25969fa13878ff4c019fcb3339ab5a)

PJON protocol specification v1.1 PJDL data-link specification v1.1 PJDLR data-link specification v1.1

Changelog:

• Interfaces abstraction added to support cross-compilation and ease portability
• Raspberry Pi now compatibile with ThroughSerial strategy see wiki example
• receive_byte has been changed to receive_string to support both a single byte or a byte stream reception, eliminating the need of internal buffers in strategies and reducing program memory. Proposed and implemented by @fredilarsen
• CRC32 enforced if packet length > 15 bytes (including overhead) to by default higher reliability
• Added unacceptable or conflicting header configuration handling
• In case of PJON_CONNECTION_LOST error data contains the id of the packet see error handling
• Added send_from_id to enable the most basic form of routing or tunneling. Proposed and implemented by @fredilarsen
• Extender example added by @fredilarsen

Bugfix:

• In case of CRC error, NAK is not transmitted to avoid third-party exchange disruption if the data-link used does not support strong consistency
• Attempts counter bugfix repeated async ack packet (https://github.com/gioblu/PJON/commit/4ecc75492a35b6c7982820ee84f5b7886b663d44)
• Avoid resend packet with asynchronous acknowledge if synchronous acknowledge is requested and received, wait until timeout and in case throw error (https://github.com/gioblu/PJON/commit/0bfb8889e84aa8bb07a877aef73e382ce7a2d9fe)
• Fixed a lot of compilation errors on linux to support Raspberry Pi

Changelog:

• SoftwareBitBang Arduino Mega and Leonardo timing optimization in mode SWBB_FAST (https://github.com/gioblu/PJON/commit/0a1c77e8ab28cdab3b32303bbff295d26cfc9d86)
• Now 65534 max packets supported in buffer (https://github.com/gioblu/PJON/commit/65fc82f357ddbc396d387b35660dfe88bd3f4c39)
• Many small changes to ease portability, avoid compilation errors and warnings
• Fix to documentation titles and links to be better viewed through readthedocs thanks to @zcattacz

Bugfix:

• Enable ThroughSerial configuration constants predefinitions (https://github.com/gioblu/PJON/commit/dacdd637efc9171c1abbfc0a3d0c600a7d1ea656)
• Avoid loosing pointer to packet if repeated sending + async ack (https://github.com/gioblu/PJON/commit/ddfd2c180d99ef01d0c9ea057f2d7b24c9dff690)

Changelog:

• State machine optimization, about -200 bytes program memory (https://github.com/gioblu/PJON/commit/954152ec4c65113402e7e54dc5ee5dea9cf88732)
• Back-off is now a property of strategies to more efficiently handle retransmissions
• AnalogSampling strategy added able to communicate wirelessly with LEDs, lasers and photodiodes.
• Memory footprint optimization excluding unused strategies by @4ib3r (https://github.com/gioblu/PJON/commit/b5e6f34ebb39971926dabdf64def99571e05250c)
• OverSampling now supports long range half-duplex communication (https://github.com/gioblu/PJON/issues/91)
• ATtiny85 external 16MHz compatible with SoftwareBitBang (https://github.com/gioblu/PJON/commit/c3a77c85fa3b06405ef4c4f46dd2a4513dc25374)
• ATmega1280/2560 and ATmega16/32U4 now compatible with OverSampling (https://github.com/gioblu/PJON/commit/9507cfc1f05bb5b45c2704445cad7d416baa7542)
• PJON_ prefix added to constants and types to avoid naming collision with third-party codebases
• digitalWriteFast renamed in PJON_IO to avoid collision with older or different versions
• Documentation updated and expanded

Bugfix:

• Avoid ATtiny EthernetTCP/LocalUDP inclusion error
• ESP8266 min/max bugfix by @fredilarsen
• NodeMCU compilation error (https://github.com/gioblu/PJON/commit/61e7ffddcfd2da1ec42ab0dc9bc37459a3c99c69)
• send_repeatedly async_ack no error bugfix (https://github.com/gioblu/PJON/commit/f573f996d5a158fbdee241d3f0d9de6a4f3c5090)
• ATmega8 pin handling bugfix (https://github.com/gioblu/PJON/commit/ee2a21cb7d766e00109b13e96e92b26232b9b2c9)
• keyword file bugfix by @pantonvich (https://github.com/gioblu/PJON/commit/fad8c2325a4bcaed02544b907dfe0ce08faa77ae)

This release brings stable the new asynchronous acknowledgment feature, also used in combination with the synchronous acknowledgment (recursive acknowledgment pattern). A lot of work has been done testing, bug fixing and extending documentation. The next phase of development is the abstraction of what is still related to timing in the protocol layer, move it to the strategy or data link layer.

Changelog:

• SoftwareBitBang, thanks to optimizations made in older versions, is able now to run OVERDRIVE mode on ATmega328 at 4.87kB/s (mandatory update for all devices transmitting in this mode with older versions because timing is changed)
• ThroughSerial optimized default configuration and can_start method, thanks for the support and extended tests over RS485 to franketto (italian arduino forum user).
• General documentation extended including also methods returning values
• Recursive acknowledgment pattern specification enhanced with graphs (https://github.com/gioblu/PJON/commit/fb0b16193929a5ede350431bc02759d3d2daaa7e)
• OverSampling, SoftwareBitBang and ThroughSerial documentation and codebase comments extended

Bugfix:

• Asynchronous backoff bugfix (https://github.com/gioblu/PJON/commit/d08a1ecf4266355de1bdc38aae671600fcfa8ffa)
• Added missing mode configuration in SIMPLEX mode examples (https://github.com/gioblu/PJON/issues/104) thanks to @pacproduct
• Avoid PJONMaster reset if not receiver or error defined (https://github.com/gioblu/PJON/issues/106) thanks to @elusive-code

PJON protocol specification released v1.0 PJON acknowledge specification released v0.1 PJON is a trademark.

PJON has been developed at a fast pace, with 15 releases in a little more than a year, but version 6 contains many of the features PJON will have when complete, what will be added in the next releases is the asynchronous acknowledgment and for sure some bug fixes. With this release it is described more clearly how the PJON network protocol stack is organized.

Changelog:

• Added optional 2 bytes length supporting up to 65535 bytes
• Added optional CRC32
• Added optional 2 bytes header
• Updated documentation stored in documentation directory
• SoftwareBitBang updated to handle latency and CRC computation time
• SoftwareBitBang specification update

Bugfix:

• Fix to EthernetTCP and LocalUDP inclusion and typecasting for portability
• ThroughSerial complete Stream abstraction and correct inclusion
• OverSampling can_start bugfix

If using OverSampling or SoftwareBitBang it is suggested to use pull down resistors on data pins to obtain the best performance.

PJON acknowledge specification fixed v0.1 PJON recursive acknowledgment pattern implemented

Changelog:

• Asynchronous acknowledge implementation (https://github.com/gioblu/PJON/commit/459cb810fc855a6f6977798042a838667ab29f54) and example
• Backoff change to transmit less times and with a more distributed pattern (attemps ^ 4) (https://github.com/gioblu/PJON/commit/305d6c11b2e88b3bf98bf9584d204270440d9827)
• Full extended header definition and support (https://github.com/gioblu/PJON/commit/29d9ac7cc3654fc833c997df4e6bdb5c8875edb8)
• Optional ordered sending (https://github.com/gioblu/PJON/commit/459cb810fc855a6f6977798042a838667ab29f54)
• Configurable random seed pin with its setter (https://github.com/gioblu/PJON/commit/27ac42744f860b857388f7e2c2cc0f2195a74b46)
• Device id is used as a part of the random seed if present (https://github.com/gioblu/PJON/commit/8697169d86de37ce7f2a1284dc8f55527f8778f4)

Bugfix:

• Keep busy jittering wave bugfix (https://github.com/gioblu/PJON/commit/964a27ab9a74e1aa18a506b9e8bdbf63e443b26d)
• Fixed EthernetLink ESP8266 compilation error (https://github.com/gioblu/PJON/commit/c107c46619eca9ba2c38088c52cd7a97cdaf6530) by @fredilarsen
• Transmission bit transition slope bugfix (https://github.com/gioblu/PJON/commit/120b2c72f1435519e7712adfd2c3f1eecc38557c), it reduces the need of pull down resistor and it generally higher transmission accuracy. Update suggested.

PJON dynamic addressing specification released v0.1

Changelog:

• Master-slave and multi-master dynamic addressing features added in PJONMaster and PJONSlave classes to preserve PJON class low memory footprint.
• EthernetTCP strategy added. Multiple devices with Ethernet ports can use PJON to communicate with each other on a LAN, WAN or across the Internet. Proposed and developed by @fredilarsen
• LocalUDP strategy added. Multiple devices with Ethernet ports can use PJON to communicate with each other on a local subnet, wired or over WiFi or both. Proposed and developed by @fredilarsen

Bugfix:

• Removed useless SoftwareSerial inclusion in ThroughSerial, thanks to @fastricker

(EthernetTCP and LocalUDP have to be included before PJON.h or pull master for automatic inclusion)