Website

PI2c OS allows you to control GPIO, SPI, I2C, PWM, and serial via a REST API and communicate serial over TCP and Websockets. You can flash the OS onto an SD card to begin or install and run the applications directly via npm.

Once you have successfully programmed the device and have your Pi running you can view get started and rest api help.


Application Installation

The applications repo's can be found on Github at

Both repositories contain instructions to build, install, and run on your target.


OS Installation

The PI2c image can be downloaded and flashed onto an SD card.

Items needed

  • Raspberry Pi 3 A/B+ (At some point in the future there will also be an image availabe for the Pi Zero W)
  • SD Card 8GB +
  • PI2c Zipped Image to flash on the SD Download
  • Application to flash the bridge image (Balena Etcher) onto the SD. Balena Etcher
  • Optional USB drive

Steps

  1. Leave Pi completely unpowered
  2. Download and unzip the Bridge image
  3. Use balenaEtcher to program the image onto your SD
  4. Plug the SD into the Pi
  5. Optionally insert a USB drive into the Pi
  6. Connect the Pi via ethernet to your router or computer
  7. Power the Pi with a stable source
  8. Wait at least 5 minutes for Pi to install latest firmware

To find your device scan for it via Bonjour/Zeroconf.

On a MAC run the following command and look for devices prefixed with GO-XXXXXXX

dns-sd -B _ssh

On a linux with avahi-browse installed run the following command and look for devices prefixed with GO-XXXXXXX

avahi-browse -rac

Or if you had inserted a USB drive (Device will log ip, host, and other info on powerup to a USB)

  • Remove USB from your Pi and place in your computer
  • Open the file info.txt
  • Get the hostname from the file GO-XXXXXXX or the ip at eth

Now let's test by getting the version

curl GO-XXXXXXX/api/v1/version
or
curl ip-address/api/v1/version