Skip to content

StreamingTime/Barmband

Repository files navigation

Barmband

Link: barm.band

Barmband is a wearable wristband designed to gamify social interactions. The concept is driven by the often daunting task of starting conversations in bars and pubs, where socialising is the lifeblood. Barmband offers an innovative solution - a fun, engaging tool that acts as an icebreaker in these social environments.

Project structure

documentation contains the presentation and project report

src and include contain the Barmband firmware (PlatformIO/Arduino) (instructions)

bandcommand contains the management software (Go) (instructions)

broker contains a Docker compose setup to run a MQTT broker (instructions)

ui_app contains a Graphical user interface, visualizing the Barmbands (Processing)

website contains sources for https://www.barm.band/ (generated with Hugo)

Useful Links

Graphical messaging and communication overview

Prerequisites

MQTT broker

In order to run the application, you need to have a MQTT broker running. You can use the compose.yml file in the broker directory to run a local MQTT broker. The broker is responsible for receiving messages from the clients and forwarding them to the appropriate subscribers. After running the broker, you have to configure the application to use the correct IP address and port of the broker. Adjust the MQTT_HOST and MQTT_PORT in include/config.h accordingly. The default port is 1883. The IP address of the broker depends on your network configuration. If you are running the broker on the same machine as the application, you can use localhost.

Of course, you can also use a remote MQTT broker.

Network configuration

The application uses the ESP32 WiFi module. You have to configure the WiFi module to connect to your WiFi network. Adjust the WIFI_SSID and WIFI_PASSWORD in include/config.h accordingly.

Configuration

Configuration is done in include/config.h. See include/config_example.h.

Build and flash

pio run --target upload

Serial monitor

pio device monitor

Sources

About

Barmband is a wearable wristband designed to gamify social interactions.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •