Home

GoPolloPlus Wiki

Building on Ubuntu with Go 1.15

sudo apt install -y golang
sudo apt install -y gcc libgl1-mesa-dev xorg-dev git
git clone https://github.com/cjeanneret/gopolloplus
cd gopolloplus
go install .

This creates a gopolloplus binary in ~/go/bin/

Building on Fedora33

• Install go - DONE! (Fedora 33 has go v1.15 pre-installed.)
  • If you want go v1.16, wait for Fedora 34 (~2021-Apr) or download/extract golang into /usr/local/go as per the Go install page; add that dir to your path. Note that go 1.16 install command does not appear to automatically get all program dependencies.
• Install Fyne.io dependencies
  • Fyne.io Getting Started - provides installer commands for grabbing a bunch of dependencies with the dnf package manager, shortened version shown here for Fedora:
  • sudo dnf install libXcursor-devel libXrandr-devel mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm-devel
  • Note: TBD if all are actually required; note that xorg-dev from notes above is not in the list, but xorg-x11-proto-devel is in the dependencies of the installed packages.
• Verify Fyne installed...
  • TimC - I suggest you verify the Fyne GUI toolkit works. The instructions say to go get two packages, and then you can simply type "fyne_demo" - but that seems to be incorrect in my case because ~/go/bin was not in my path.
  • go get fyne.io/fyne/v2
  • go get fyne.io/fyne/v2/cmd/fyne_demo --> fyne_demo or possibly ~/go/bin/fyne_demo
  • Success means you'll get a sample GUI app that launches. Nifty!
• go install
• gopollowplus -- to run the program; note, check the logs as you may not have access to the /dev/ttyUSB0 port, this generally requires access to the dialout group.

Building on MacOS

Installing Go and building the project is similar on MacOS to Linux, with a few notable differences:

There is no need to install gcc or the libgl1-mesa-dev and xorg-dev libraries required by Fyne - the GUI builder for Go, but you will need the Xcode command line tools.

Setup and Build the Project

1. Download the MacOS GoLang Installer Pkg
2. Install Xcode command line tools xcode-select --install
3. Clone the project git clone https://github.com/cjeanneret/gopolloplus
4. Change into the gopolloplus directory, and run go install . If the system complains about dependencies - you may need to get them manually with go get . Note: go version 1.15 appears to get all the dependencies during install, but 1.16 does not.

Find the Unique Serial Device ID

1. Plug in the FDF Console to USB
2. List the /dev/tty.usbserial* files - take note

Create a Config file

1. Copy the configs/config.sample.ini to config.ini
2. Set the serial device from above for the "socket"

Run the app -> ./gopolloplus -c <config_file_name>