macOS¶

Introduction¶

If you need more permanent solution than HARDWARIO Playground you can install all the services yourself in your system. This guide will help you to install and configure these services:

HARDWARIO Gateway bcg
HARDWARIO Firmware Tool bcf
- If you want to develop firmware please visit the Firmware section.
HARDWARIO Host Tool bch
Mosquitto MQTT broker
Node-RED
The process manager pm2

Playground Setup on macOS¶

open Terminal application

Step 1: Install the driver for the HARDWARIO Radio Dongle¶

Download & Install drivers from FTDI

Step 2: Restart your computer¶

Step 3: Install Homebrew ¶

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Step 4: Upgrade all packages¶

brew update && brew upgrade

Step 5: Install Mosquitto server and clients¶

brew install mosquitto

brew services start mosquitto

Step 6: Install Node.js version 6 (required by Node-RED)¶

brew install node

Step 7: Install Node-RED¶

sudo npm install -g --unsafe-perm node-red

Step 8: Install node-red-dashboard for graphs, gauges, buttons¶

cd ~/.node-red/

npm i node-red-dashboard

Step 9: Install PM2¶

sudo npm install -g pm2

Tip

PM2 is a process manager that will help you to start Node-RED and other processes on boot.

Step 10: Tell PM2 to run Node-RED¶

pm2 start `which node-red`

Step 11: Tell PM2 to run on boot¶

pm2 save

pm2 startup

Caution

Now you must follow the instructions provided by the command pm2 startup systemd.

Step 12: Install Python 3 (required by the HARDWARIO Firmware Tool and HARDWARIO Gateway)¶

brew install python3

Step 13: Update pip (Python Package Manager) to the latest version¶

sudo pip3 install --upgrade --no-cache-dir pip

Step 14: Install the HARDWARIO Firmware Tool¶

sudo pip3 install --upgrade --no-cache-dir bcf

Step 15: Install the HARDWARIO Gateway¶

sudo pip3 install --upgrade --no-cache-dir bcg

Step 16: Plug the HARDWARIO Radio Dongle into a USB port¶

Step 17: List the available devices¶

bcf devices

Tip

You can use -v parameter to see verbose information about the connected devices (possibly helping you to identify them).

Step 18: Upload the latest firmware into the HARDWARIO Radio Dongle¶

bcf update

bcf flash hardwario/bcf-gateway-usb-dongle:latest

Step 19: Start the HARDWARIO Gateway as PM2 service¶

pm2 start `which python3` --name "bcg-ud" -- `which bcg` --device ...

Important

Replace ... with the device listed using bcf devices.