@serialport/bindings-cpp
Access serial ports with JavaScript. Linux, OSX and Windows. Welcome your robotic JavaScript overlords. Better yet, program them!
Go to https://serialport.io/ to learn more, find guides and api documentation.
Quick Links
📚 Guides- API Docs
@serialport/bindings-cpp
🐛 Help and Bugs All serialport issues are pointed to the main serialport repo.
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.
-
@serialport/bindings
bindings for Linux, Mac and Windows -
@serialport/binding-interface
as an interface to use if you're making your own bindings -
@serialport/binding-mock
for a mock binding package for testing
Developing
Developing node serialport projects
- Clone this repo
git clone git@github.com:serialport/bindings-cpp.git
- Run
npm install
to setup local package dependencies (run this any time you depend on a package local to this repo) - Run
npm test
to ensure everything is working properly - If you have a serial loopback device (TX to RX) you can run run
TEST_PORT=/path/to/port npm test
for a more comprehensive test suite. (Defaults to 115200 baud customize with the TEST_BAUD env.) You can use an arduino with thetest/arduino-echo
sketch.
Developing Docs
See https://github.com/serialport/website
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
Contributors
This project exists thanks to all the people who contribute. [Contribute].
Backers
Thank you to all our backers!
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]