Node.js package to access serial ports. Linux, OSX and Windows. Welcome your robotic JavaScript overlords. Better yet, program them!
Switch branches/tags
Clone or download
reconbot docs: localization support for the document site (#1718)
Supporting
- zh-CN Chinese (Simplified)
- es-ES Spanish
- pt-BR Portuguese (Brazil)

I know first hand there are a lot of people who would welcome these languages. Lets start here.

If you'd like to contribute we now have an account with Crowdin and I'm using the [docusaurus translation tools](https://docusaurus.io/docs/en/translation)

If you'd like to help translate please check out our Crowdin page https://crowdin.com/project/node-serialport
Latest commit 50a0c03 Nov 9, 2018
Permalink
Failed to load latest commit information.
.generators chore: update packages (#1717) Nov 3, 2018
.github doc: change wontfix label to stale Sep 19, 2018
bin chore: drop node 4 and upgrade to node 6 features (#1633) Aug 26, 2018
docs Fix typo in docs/api-stream.md (#1701) Oct 16, 2018
packages docs: localization support for the document site (#1718) Nov 9, 2018
test chore: linting - a much more reasonable line length Sep 15, 2018
.eslintignore chore: change to a monorepo structure with Lerna (#1586) Jul 24, 2018
.eslintrc chore: linting - a much more reasonable line length Sep 15, 2018
.gitignore chore: split out more packages (#1611) Aug 25, 2018
.gitignore-example-from-docusaurus docs: New docs system (#1647) Sep 9, 2018
.jsdoc.json chore: change to a monorepo structure with Lerna (#1586) Jul 24, 2018
.travis.yml feat: move cli tools to their own packages (#1664) Sep 15, 2018
CODE_OF_CONDUCT.md docs: formalize a governance model (#1667) Sep 18, 2018
CONTRIBUTING.md docs(contributing): fix the roadmap issue link Sep 15, 2018
LICENSE Pull README edits into the template and JS Doc Jun 19, 2017
PUBLISHING.md docs(publishing): some notes on building binaries Sep 15, 2018
README.md docs(README): add Reconbot, HipsterBrown maintainers Sep 22, 2018
appveyor.yml chore: split out more packages (#1611) Aug 25, 2018
codecov.yml chore: split out more packages (#1611) Aug 25, 2018
crowdin.yaml docs: localization support for the document site (#1718) Nov 9, 2018
greenkeeper.json chore: enable greenkeeper monorepo edition Aug 29, 2018
lerna.json chore(packages): upgrade lerna Nov 6, 2018
package.json chore(packages): upgrade lerna Nov 6, 2018
plopfile.js chore: cleanup Sep 15, 2018
test-config.json feat(linux): Custom baud rates for linux (eg 250k baudrate) (#1464) Feb 5, 2018

README.md

Node Serialport

lerna codecov Build Status Build status Greenkeeper badge

Working with serial ports can be hard, this is a collection of projects that make it easier.

Go to https://serialport.io/ to learn more, find guides and api documentation.

Quick Links

Serialport

  • serialport Chances are you're looking for the serialport package which provides a good set of defaults for most projects. However it is quite easy to mix and match the parts of serialport you need.

Bindings

The Bindings provide a low level interface to work with your serialport. It is possible to use them alone but it's usually easier to use them with an interface.

Interfaces

Interfaces take a binding object and provide a different API on top of it. Currently we only ship a Node Stream Interface.

Parsers

Parsers are used to take raw binary data and transform them into usable messages. This may include tasks such as converting the data to text, emitting useful chunks of data when they have been fully received, or even validating protocols.

Parsers are traditionally Transform streams, but Duplex streams and other non stream interfaces are acceptable.

Developing

Developing node serialport projects

  1. Clone this repo git clone git@github.com:node-serialport/node-serialport.git
  2. Run npm install to setup local package dependencies (run this any time you depend on a package local to this repo)
  3. Run npm test to ensure everything is working properly
  4. Run npm run generate to generate a new project
  5. Add dev dependencies to the root package.json and package dependencies to the package's one.

Developing Docs

You can develop the docs by running

npm run docs:dev

And build them by running

npm run docs

Docs are automatically built with netlify including previews on branches. The master branch is deployed to https://serialport.io

License

SerialPort packages are all MIT licensed and all it's dependencies are MIT licensed.

Code of Conduct

SerialPort follows the Nodebots Code of Conduct. While the code is MIT licensed participation in the community has some rules to make this a good place to work and learn.

TLDR

  • Be respectful.
  • Abusive behavior is never tolerated.
  • Data published to NodeBots is hosted at the discretion of the service administrators, and may be removed.
  • Don't build evil robots.
  • Violations of this code may result in swift and permanent expulsion from the NodeBots community.

Governance and Community

SerialPort is currently employees a governance with a group of maintainers, committers and contributors, all fixing bugs and adding features and improving documentation. You need not apply to work on SerialPort, all are welcome to join, build, and maintain this project.

  • A Contributor is any individual creating or commenting on an issue or pull request. By participating, this is you.
  • Committers are contributors who have been given write access to the repository. They can review and merge pull requests.
  • Maintainers are committers representing the required technical expertise to resolve rare disputes.

If you have a PR that improves the project people in any or all of the above people will help you land it.

Maintainers