UNPKG

22.1 kBMarkdownView Raw
1<a name="6.0.3"></a>
2## [6.0.3](https://github.com/EmergingTechnologyAdvisors/node-serialport/compare/v6.0.0...v6.0.3) (2017-10-22)
3
4### Bug Fixes
5
6* **windows:** Fix async handle leak ([#1367](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1367)) ([c1d9d88](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/c1d9d88)), closes [#1363](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1363)
7* **windows:** Fix read & write bugs for windows ([#1364](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1364)) ([0e4b1f9](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/0e4b1f9))
8
9
10
11<a name="6.0.0"></a>
12# [6.0.0](https://github.com/EmergingTechnologyAdvisors/node-serialport/compare/5.0.0...v6.0.0) (2017-10-09)
13
14
15### Features
16
17* **open:** Throw on incorrect baudrate option ([#1347](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1347)) ([a3b8d35](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/a3b8d35))
18* **parsers:** Add cctalk parsers ([#1342](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1342)) ([bcb492f](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/bcb492f))
19* **test:** tone down codecov comments ([#1289](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1289)) ([749ffac](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/749ffac))
20* **windows:** Add ERROR_INVALID_PARAMETER to supported bindings errors ([#1354](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1354)) ([4ff9c67](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/4ff9c67))
21
22
23### Bug Fixes
24
25* **docs:** Add a note about windows support ([76b7191](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/76b7191)), closes [#1299](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1299)
26* **docs:** add missing parsers to properties list ([3faadac](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/3faadac))
27* **docs:** correct default highWaterMark to 65536 bytes ([e83ec4e](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/e83ec4e))
28* **docs:** Fixed typo in upgrade guide ([#1321](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1321)) ([bf251a9](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/bf251a9))
29* **linux:** The productID should be a number not a description string ([#1279](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1279)) ([bf46f68](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/bf46f68))
30* **package:** update debug to version 3.0.0 ([#1292](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1292)) ([4987750](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/4987750))
31* **tests:** fixup for [#1279](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1279) ([#1285](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1285)) ([56074f6](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/56074f6))
32* **windows:** Add option to disable RTS ([#1277](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1277)) ([5b8d163](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/5b8d163))
33* **windows:** Asynchronous callbacks for reading and writing ([#1328](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1328)) ([69de595](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/69de595)), closes [#1221](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1221)
34* **windows:** Parse more types of pnpIds ([#1288](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1288)) ([0b554d7](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/0b554d7)), closes [#1220](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1220)
35
36
37### Chores
38
39* **binaries:** Lets switch to prebuild! ([#1282](https://github.com/EmergingTechnologyAdvisors/node-serialport/issues/1282)) ([8c36e99](https://github.com/EmergingTechnologyAdvisors/node-serialport/commit/8c36e99))
40
41### BREAKING CHANGES
42
43* **binaries:** We switched to `prebuild` a breaking change because it's substantially changes our install processes. It's also possible the install flags to ensure downloading or building from source has changed slightly. That's not our api per say, but it's enough.
44* **windows:** We previously hard coded to have RTS on for windows at all times it now default to off.
45
46
47Version 5.0.0 🎉
48-------------
49Nearly [a year in the making](https://github.com/EmergingTechnologyAdvisors/node-serialport/compare/4.0.7...5.0.0-beta9) Node SerialPort 5.0.0 is a major rewrite that improves stability, compatibility and performance. The api surface is similar to version 4 there have been a number of changes to ensure consistent error handling and operation of a serial port. Notably we are now a [`Stream`](https://nodejs.org/api/stream.html)! We can also introduce a bindings layer. A small low level api to provide access to underlying hardware. External bindings written in other languages or targeting other platforms can now be used.
50
51Some major cpu performance gains on unix platforms can be found and we're less buggy and better performing on Windows too.
52
53With this release we are now only supporting LTS nodejs platforms and we are dropping NodeJS 0.10, 0.12, 5 and 7 support. We loved directly supporting so many platforms but it was getting in the way making a solid library.
54
55See our [upgrade guide](./UPGRADE_GUIDE.md) for detail on what to change to upgrade your app to use `serialport@5.0.0`. It's not much!
56
57Thank you to the 25 people who committed code and documentation and every person who submitted bug reports and tested changes!
58
59Notable Changes
60- [all] Streams rewrite, node serialport is now a node stream! 🎉
61- [all] Drop NodeJS 0.10, 0.12, 5, and 7 support
62- [all] Add node 8 support (we now only support LTS node versions)
63- [all] Introduce a binding layer to provide a common low level interface to work with different platforms.
64- [unix] New read/write subsystem. Write CPU dropped from 100% to 0-2%. @reconbot (Thanks to @indutny for getting me unstuck many times!)
65- [windows] Rewrite reading so it's pausable thanks to @munyirik
66- [docs] An overhaul how we document the api leveraging JSDOC
67- [docs] An overhaul of the format and language in our docs thanks to @LappleApple
68
69Features
70- [all] `isOpen` is now a property #899
71- [all] `SerialPort.list` now has more consistent output across all platforms.
72- [all] `SerialPort.list` returns a promise if a callback is not provided thanks to @MikeKovarik for bug fixes
73- [all] A promise aware `serialport-repl` script for debugging and testing.
74- [all] add `#get` to retrieve modem status flags thanks to @jgillick!
75- [all] Add a `MockBinding` object for testing serialports in your project. Used internally too!
76- [all] Add electron precompiled binaries thanks to @Mike-Dax
77- [all] Add regex stream parser and tests @jessicaquynh
78- [all] Allow reopening after an open error #910
79- [all] calls to `.drain` now queue behind port open and in progress writes reported by and with lots of testing help from @tuna-f1sh
80- [all] Change parsers to be transform streams #922
81- [all] Change the default `highWaterMark` to 64k to match `fs.ReadStream`
82- [all] Conform to NodeJS error message formats
83- [all] Exposed mocking serialport via `require('serialport/test')`
84- [all] Have drain wait for pending JS write operations before calling system drain thanks to @digitalhack for reporting it
85- [all] port.path is now read only #898
86- [all] Refactor internals to make use of es6 and promises
87- [all] Remove lowercase options #898
88- [all] Remove the c++ write queue
89- [all] Remove unnecessary dependencies and polyfills thanks to @mscdex
90- [all] Remove v8 deprecation warnings thanks to @indutny again
91- [all] Removed the `disconnect` event. The `close` event now fires with a disconnect error object in the event of a disconnection.
92- [all] SerialPort can now be compressed with `uglify-es` thanks to @rwaldron
93- [all] update bindings to version 1.3.0
94- [all] Upgrade debug and node-pre-gyp
95- [all] Upgrade to non deprecated buffer methods
96- [docs] Add more installation notes on sudo, windows 10, electron and node 7
97- [docs] Add socketio example @jessicaquynh
98- [docs] Electron build docs #965 via @chalkers
99- [docs] Mark new features in 5.0.0 with the fact they started in 5.0.0
100- [docs] Update parser docs to be correct #970 via @jacobq
101- [linux] `SerialPort.list` is now faster and less resource intensive thanks to @akaJes!
102- [linux] Add the `ttyAP` subsystem to serialport list thanks to @fly19890211 for reporting it
103- [osx] `SerialPort.list` now returns the `tty` instead of the `cu` thanks to @kishinmanglani
104- [unix] Flush now gives errors and flushes tx and rx #900
105- [unix] Move setting up the baudrate to the end of the `open()` to better support custom baudrates
106- [windows] Refactoring of `.list` for Windows so it's significantly smaller thanks to @Zensey
107
108Fixes
109- [all] Fix baud rate parsing in `serialport-terminal` thanks to @radio-miskovice for reporting it!
110- [all] Fix memory leak during opening a port thanks to @indutny
111- [all] fixed a crash when pausing while reading thanks to @bminer and @baffo32 and others to debug and fix this
112- [all] Upgrade nan to fix compile issues on some platforms thanks to @thom-nic
113- [docs] fixed a typo thanks to @amilajack
114- [docs] Spelling fixes via @Awk34
115- [unix] fix a bug when poller errors would be unhandled thanks to @thiago-sylvain for reporting
116- [windows] Fix file handle leak during opens when errors occur thanks to @enami
117- [windows] Fix flush behavior using PurgeComm fixing #962 via @samisaham
118- [windows] Fix unhandled promise rejection when calling read on Windows
119- [windows] Remove read and write timeouts solving #781 via @giseburt
120
121We also had help testing, debugging, and designing from; @alaq @arve0 @techninja @noopkat @HipsterBrown and more!
122
123Version 4.0.7
124-------------
125- [all] Fix baud rate parsing in `serialport-terminal` thanks to @radio-miskovice for reporting it!
126- [windows] Refactor `SerialPort.list` to be a lot smaller and pickup vendorId, productId and locationId thanks to @zensey for #877!
127
128Version 4.0.6
129-------------
130- [all] Upgrade nan to fix compile issues on some platforms thanks to @thom-nic
131- [all] Upgrade debug and node-pre-gyp
132
133Version 4.0.5
134-------------
135- [windows] Fix file handle leak during opens when errors occur thanks to @enami
136- [all] Fix memory leak during opening a port thanks to @indutny
137
138Version 4.0.4
139-------------
140- Add precompiled binaries for node 7
141
142Version 4.0.3
143-------------
144- Switch to the lie promise library as it's smaller and mimics nodejs's promise closer
145- Fix a bug that prevented reopening a port after an open error
146
147Version 4.0.2
148-------------
149- [unix] Fix a bug when we'd crash when pausing during a read
150
151Version 4.0.1
152-------------
153- [linux] Do not replace the native Promise when it is available thanks to @zewish for the fix
154
155Version 4.0.0
156-------------
157- Requiring `serialport` now returns the SerialPort constructor function instead of a factory object. `SerialPort.SerialPort` is now deprecated.
158- `SerialPort` constructor now throws on argument errors immediately.
159- `.write(writeCallback)` now only calls it's callback once after the entire write operation, it used to be called for each write cycle and return the bytes written. This reduces the number of callbacks by hundreds of thousands over a megabyte at low bandwidth.
160- Disconnections now always attempt to close the port, and you'll always get a `close` event after a `disconnect` event
161- All callbacks are called in the context of the port, `this` now equals the port.
162- Removed `openImmediately` from the constructor's api, the functionality is now named `autoOpen` on the options object.
163- Removed extraneous flow control settings from the `flowControl` option, use the specific options to set these flags now.
164- Removed undocumented callbacks from the options object `disconnectedCallback` and `dataCallback`
165- Renamed `serialportlist` to `serialport-list`
166- Renamed `serialportterm` to `serialport-term`
167- Added a contributors guide
168- Added our first Arduino required integration tests
169- [unix] `.drain` and `.set` now properly report errors
170- [unix] Ports are now locked by default with the new `lock` options matches windows default behavior
171- [windows] `.update()` now supports windows for changing baud rates
172- [windows] Fixed a bug where we weren't properly opening ports (provides better support virtual com ports too) thanks to @RogerHardiman
173- [windows] known issue `lock: false` doesn't work (no change in behavior)
174
175Version 3.1.2
176-------------
177- Documentation around "Illegal Instruction" errors
178- Resolve some ambiguities around publishing that was causing some issues on some versions and platforms of npm and node
179- [linux] bug fix in `.list()` where we weren't filtering out non block devices that are named like serial ports
180- [unix] Better unix error messages
181- [unix] Refactor `setBaudrate` for Unix making it easier for custom baudRate support
182- [unix] Update now has less memory leaks, documentation and better error messages
183- [windows] Better error messages for opening ports
184
185Version 3.1.1
186-------------
187- fix an issue with bundled deps for node-pre-gyp on npm
188
189Version 3.1.0
190-------------
191- Upgrade nan and fix warnings for node 6.0
192- Update the cli tools. serialport-term can now list ports, serialport-list can now output in different formats
193
194Version 3.0.1
195-------------
196- Change from BlueBird to es6-promise to save 9.5MB from the package size (19M -> 9.5) and 130k bundle size (186.1kb -> 55.2kb)
197- Experimental node 6 support
198
199Version 3.0.0
200-------------
201- `close` and `disconnect` events no longer call `removeAllListeners` and removes your event listeners. This was particularly bad for the `error` event. This is the only change and if you didn't have a special code to deal with this behavior you should probably upgrade from v2.1.2
202
203Version 2.1.2
204-------------
205- Start bundling node-pre-gyp but upgrade it to the latest as the previous version doesn't install
206
207Version 2.1.1
208-------------
209- `.list` errors are consistent across platforms and no longer has blocking `statSync` calls
210- Stop bundling node-pre-gyp to prevent issues when it's already installed
211- Internal restructuring
212
213Version 2.1.0
214-------------
215- Major refactor, bug fixes and docs improvements thanks to @ecksun, @fivdi, @gfcittolin, @jacobrosenthal, @mhart, @nebrius, @pabigot, @paulkaplan, @reconbot, @rodovich, @rwaldron, @sayanee, @tigoe and everyone who reported and helped debug issues!
216- Fix binary paths to confirm with modern standards
217- Integration tests on CI's that support it or for the folks at home with an arduino handy
218- Upgrade to nan-2.2.1 for memory leak fixes and node 6 compatibility (still not supported)
219- Confirm nw.js and electron compatibility
220- Make the outpout of `.list` consistent between platforms and docs
221- Define ambiguous flow control flags and document them
222- Fix support systems who provide 0 as a valid file descriptor
223- Fix race conditions when opening and closing ports that led to errors while reading and writing while closing or opening the port.
224- [unix] Fix a double open bug on unix that would cause opening and closing ports repetitively to error.
225- [unix] Listing serialports on linux now include more ports (including bluetooth devices eg. `/dev/rfcommXX`) and have less bugs in the output
226- [windows] Remove deprecated BuildCommDCB for windows 10 support
227- [windows] Fix a memory leak on windows
228- [windows] Fix a 100% cpu and possible hang bug when ports were disconnected on windows.
229
230Version 2.0.6
231-------------
232- Add 5.x build to matrix, thanks @deadprogram
233- Re add nmpignore, thanks @rwaldron
234- Swap to upstream version of node-pre-gyp-github
235
236Version 2.0.5
237-------------
238- Fix linux port listing crash since 2.0.3 refactor, thanks @monkbroc
239
240Version 2.0.4
241-------------
242- Fix heap corruption issue affecting windows users since 2.0.0, thanks @kunalspathak
243
244Version 2.0.3
245-------------
246- Move node-pre-gyp binaries away from Amazon S3 to Github Releases page
247- Fix for missing node-pre-gyp binaries, especially for windows users, since the 2.0.0 refactor which forced windows users to build from source -- generally failing due to lack of dependencies
248- Unix port listing moved away from udev which was not available on all platforms, to whitelisting ttyS ttyACM ttyUSB ttyAMA devices, see #610
249
250Version 2.0.2
251-------------
252- Cleanup minor Unix gcc warnings, Thanks @rwaldron
253
254Version 2.0.1
255-------------
256- El Capitan Support, thanks @tmpvar
257
258Version 2.0.0
259-------------
260- Upgrade to NAN2 to support Node 4 support. Technically not api breaking, though NAN2 requires gcc 4.8 which for Pi Wheezy users at the very least, would be breaking. For those affected users looking to utilize serialport 2.x.x and Node 4 see https://github.com/fivdi/onoff/wiki/Node.js-v4-and-native-addons
261
262Version 1.7.4
263-------------
264- Fix OSX 10.10 build errors
265
266Version 1.7.3
267-------------
268- Fix OSX 10.10 build errors
269
270Version 1.7.2
271-------------
272- Fix OSX 10.10 build errors
273
274Version 1.7.1
275-------------
276- Fixed breaking issues in underlying code. (@voodootikigod)
277
278Version 1.7.0
279-------------
280- Fix for #518 and #498 If you pass to SerialPort function (constructor) the same object for argument "options", inside SerialPort will use it as internal object and adds handlers to it. That causes only one callback to work on different SerialPort instances. (@bullmastiffo)
281- Update README.md #515 (@arahlf)
282- Fix a memory leak in SerialportPoller::New (@jpilet)
283- unix support for update baudrate #502 (@jacobrosenthal)
284- set cloexec after open, possible fix for #468 (@jacobrosenthal)
285- Added hang up on close option to constructor. #495 (@jbendes)
286- Upgraded NAN to 1.8.4 due to complaints from io.js 2.x users. (@imyller)
287
288Version 1.6.1
289-------------
290- Upgraded to NAN 1.7.0
291- #476 adding break signal
292
293Version 1.6.0
294-------------
295- Long standing issue resolved thanks to @jacobrosenthal for adding control signals into the serialport. YAY!
296- Fix for #426
297- Ability to return from inside loop #453
298- Emits for close/disconnect. #452
299
300Version 1.5.0
301-------------
302- Fixed to work with io.js and node 0.11.x by upgrading to recent nan 1.6.2
303
304
305Version 1.4.8
306-------------
307- Simple bump for the binary.
308
309Version 1.4.7
310-------------
311- Fix for Issue #398 - Dropped sent characters on OSX and Linux
312- Fix for Issue #387 - added isOpen
313- removed a residual comment
314- Added osx control signalling
315- Fix for Issue #401
316- Fix for double write callbacks.
317- detect a serialport disconnect on linux.
318
319Version 1.4.6
320-------------
321- Emit error on serialport when explicit handler present. Fixes gh-369
322- Fix for windows and Node 0.11.13 (atom-shell)
323- Fix for broken Travis-CI build.
324
325Version 1.4.5
326-------------
327- Identified and report issue to node.js core about recent 0.11.x system.
328- Removed support for 0.8.x
329- Updated dependencies
330
331Version 1.4.4
332-------------
333- Fix for delete error.
334
335Version 1.3.0
336-------------
337- Merged NAN integration for Node 0.8->0.11+ compatibility (#270)
338
339Version 1.2.5
340-------------
341- Fixed an issue with pool handlers being global instead of instance isolation (Issue #252 and #255 thanks: foobarth !!! )
342
343
344Version 1.2.4
345-------------
346- Resolved parity error under linux as reported here: https://github.com/voodootikigod/node-serialport/issues/219
347
348
349Version 1.1.3
350-------------
351- Remove ATL dependency on Windows (added Visual Studio Pro requirement)
352- Update build instructions
353- Four small bugfixes
354
355Version 1.0.7
356-------------
357- Guaranteed in-order delivery of messages thanks to Jay Beavers and bnoordhuis
358
359Version 1.0.6
360-------------
361- Support higher baud rates in Mac OS X
362
363Version 1.0.5
364-------------
365- Added flush support.
366
367Version 1.0.4
368-------------
369- Fix for arduino firmata support on windows thanks to @jgautier.
370
371Version 1.0.3
372-------------
373- Fixed issue 65 - https://github.com/voodootikigod/node-serialport/issues/65
374- Added note in readme about what is required for the system to be able to compile module, should solve 90% of issues.
375
376Version 1.0.2
377-------------
378- Fixed issue 59 - https://github.com/voodootikigod/node-serialport/issues/59
379
380Version 1.0.1
381-------------
382- Fixed items from Firmata
383- Added flexibility for options (camelcase or all lower)
384
385Version 1.0.0
386-------------
387- Added Windows support thanks to Joe Ferner.
388- Merged in the various underlying changes from node-serialport2 complete thanks to Joe Ferner for that!
389- Verified against known installations.
390
391
392Version 0.6.5
393-------------
394- Added SetBaudRate, SetDTR; Custom Baud Rates
395- New "close" listener when device being disconnected
396
397Version 0.2.8
398-------------
399- BufferSize fix for readstream (thanks jgautier, you rock)
400
401Version 0.2.7
402-------------
403- Make no port available be an exception not error emitted - Ticket #12.
404
405Version 0.2.5 - Version 0.2.6
406-----------------------------
407- Debugging issue with IOWatcher not holding in the event loop in node.js.
408- Converted to ReadStream instead of IOWatcher.
409
410Version 0.2.4
411-------------
412- Integrated arduino tests (rwaldron)
413- Integrated options bug fix (w1nk)
414- Integrated hardware flow control for crazier serial port action (w1nk)
415
416Version 0.2.3
417-------------
418- Something amazing that has since been lost and forgotten.
419
420Version 0.2.2
421-------------
422- Integrated enhanced version of arduino/readline that actually buffers the data (epeli)
423
424Version 0.2.1
425-------------
426- Refactored the parsing code upon data receipt, now allows for dynamic specification of how incoming data is handled.
427- Revised creation interface to use named parameters as an object versions positional parameters.
428
429Version 0.2.0
430------------
431- Upgraded to node v. 0.4.X compatibility
432
433All other version are not recorded.