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

  • BigClown Gateway bcg
  • BigClown Firmware Tool bcf
  • BigClown Host Tool bch
  • Mosquitto MQTT broker
  • Node-RED
  • The process manager pm2

Setup on macOS

  1. Install the driver for the BigClown Radio Dongle:

    Download drivers from FTDI
  2. Restart your computer.

  3. Open the Terminal application.

  4. Install Homebrew (unless you already have it).

  5. Upgrade the Homebrew packages:

    brew update && brew upgrade
    
  6. Install Mosquitto server and clients:

    brew install mosquitto
    

    brew services start mosquitto
    
  7. Install Node.js (required by Node-RED).

    brew install node
    
  8. Install Node-RED:

    sudo npm install -g --unsafe-perm node-red
    
  9. Install node-red-dashboard for graphs, gauges, buttons

    cd ~/.node-red/
    npm i node-red-dashboard
    
  10. Install PM2:

    sudo npm install -g pm2
    
  11. Tell PM2 to run Node-RED:

    pm2 start `which node-red`
    
  12. Tell PM2 to run on boot:

    pm2 save
    

    pm2 startup
    
  13. Install Python 3 (required by the BigClown Firmware Tool and BigClown Gateway).

    brew install python3
    
  14. Update pip (Python Package Manager) to the latest version:

    sudo pip3 install --upgrade --no-cache-dir pip
    
  15. Install the BigClown Firmware Tool:

    sudo pip3 install --upgrade --no-cache-dir bcf
    
  16. Install the BigClown Gateway:

    sudo pip3 install --upgrade --no-cache-dir bcg
    
  17. Plug the BigClown Radio Dongle into a USB port.

  18. List the available devices:

    bcf devices
    
  19. Upload the latest firmware into the BigClown Radio Dongle:

    bcf update
    

    bcf flash --device ... bigclownlabs/bcf-gateway-usb-dongle:latest
    
  20. Start the BigClown Gateway as PM2 service:

    pm2 start `which python3` --name "bcg-ud" -- `which bcg` --device ...
    
  21. Open your web browser with the URL:

    http://localhost:1880/

Upgrade on macOS

  1. Upgrade the Homebrew packages:

    brew update && brew upgrade
    
  2. Upgrade Node-RED:

    sudo npm update -g node-red
    
  3. Upgrade PM2:

    sudo npm update -g pm2
    
  4. Upgrade the BigClown Firmware Tool:

    sudo pip3 install --upgrade --no-cache-dir bcf
    
  5. Upgrade the BigClown Gateway:

    sudo pip3 install --upgrade --no-cache-dir bcg
    
Chapters in this document:
Edit this page

We will inspire you!

You will get regularly our Clownsletter with real projects from other Makers. Do not miss it!

By sign up you will know how even you can inspire others and get €100 discount coupon!