Skip to content

Node.js package to access serial ports. Linux, OSX and Windows. Welcome your robotic JavaScript overlords. Better yet, program them!

License

Notifications You must be signed in to change notification settings

maximejf42/node-serialport

 
 

Repository files navigation

Node Serialport

lerna codecov Build Status Build status Greenkeeper badge

Working with serialports can be hard, this is a collection of projects that make it easier. We currently have the following packages.

  • serialport npm the only package you need to get started.
  • @serialport/stream our traditional stream interface with nothing else
  • @serialport/binding-abstract as an abstract class for all bindings
  • @serialport/binding-mock for a mock binding package
  • Parser Byte Length
  • Parser cctalk
  • Parser delimiter
  • Parser readline
  • Parser ready
  • Parser regex
  • Parser slip-encoder

Quick Answers to Important Questions

Intro to Node-Serialport

Imagine a world where you can write JavaScript to control blenders, lights, security systems, or even robots. That's right—robots! Thanks to Node Serialport, that world is here.

Node-Serialport provides an interface for the low-level serial port code necessary to control Arduino chipsets, X10 interfaces, Zigbee radios, highway signs, lcd screens, cash drawers, motor controllers, sensor packages, fork lifts, modems, drones, CNC machines, plotters, vending machines, ccTalk coin accecptors, SMS Gateways, RFID scanners and much more. If you have a hardware device with a UART we can speak to it. The physical world is your oyster with this goodie.

For a full breakdown of why we made Node-Serialport, please read NodeBots - The Rise of JS Robotics. It explains why one would want to program robots in JS in the first place. It's not being against firmware but we can be better than it.

API Documentation

You can generate the docs by running

npm run docs

And browsing to ./docs/index.html.

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.

License

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

About

Node.js package to access serial ports. Linux, OSX and Windows. Welcome your robotic JavaScript overlords. Better yet, program them!

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 68.6%
  • C++ 30.2%
  • Other 1.2%