LunchTrak Beacon

What's LunchTrak?

LunchTrak is a "fastrak" system aimed to shorten the incredibly long school lunch lines. Students will be scanned in automatically without having to stop and type/scan their ID number. This change will allow the line to flow much quicker, letting students get to their clubs and events on time.

What Does the Beacon Do?

The LunchTrak beacon will be inside of the student's backpack. When they first receive them, they can enter pair mode by pressing the pair button for 3 seconds. They can then connect to with the LunchTrak website to configure their student ID.

Most of the time, the device will be in hibernate mode to conserve energy. Near the lunch line, a wakeup signal will be emitted to wake up the device, and the device will start beaconing for a couple minutes with information about the student's school and ID number.

State Diagram

stateDiagram
    [*] --> S_INIT
    S_INIT --> S_IDLE: OP_MODULE_INIT
    S_IDLE --> S_STARTING_LUNCH_ADV: OP_CREATE_LUNCH_ADV
    S_INIT --> S_IDLE: OP_CREATE_PAIR_ADV
    S_IDLE --> S_STARTING_PAIR_ADV: OP_CREATE_PAIR_ADV
    S_STARTING_LUNCH_ADV --> S_ADV_STARTED: OP_CREATE_LUNCH_CFM
    S_STARTING_PAIR_ADV --> S_ADV_STARTED: OP_CREATE_PAIR_CFM
    S_ADV_STARTED --> S_IDLE: OP_CREATE_PAIR_ADV
    S_ADV_STARTED --> S_CONNECTED: OP_CONNECTED
    S_CONNECTED --> S_ADV_STOPPED: OP_DISCONNECTED
    S_CONNECTED --> S_CONNECTED: OP_ADV_TIMEOUT
    S_ADV_STARTED --> S_ADV_STOPPED: OP_ADV_TIMEOUT
    S_ADV_STOPPED --> S_IDLE: OP_DELETE_PAIR_ADV
    S_ADV_STOPPED --> S_IDLE: OP_SLEEP

Loading

Notes and TODOs

Setup Locally

You'll need the Atmosic SDK, though I'm not sure if that is publically avaliable. Place this repo such that the relative path is as follows:

atmosic_sdk/platform/atm2/ATM22xx-x1x/examples/lunch_beacon

Build options

# Compile
make

# Compile and Program Chip
make run_all

# Disable WuRX (Wake Up Receiver)
make run_all WURX:=0

# Disable Debug
make run_all DEBUG:=0

# With external 32khz crystal
make run_all FORCE_LPC_RCOS:=0 LPC_RCOS:=0

Mass Programming

There is a python script in the "program" folder that can help with assigning unique Bluetooth MAC addresses. This script was tested with Python 3.9.9, but should work with later versions as well. To use, plug in the LunchTrak Beacon to the computer and run:

python program/program.py

Atmosic SDK Workaround

There is a necessary workaround as of April 2023 where you'll need to include the following lines to FIXME_EXAMPLE_USES_BLE in app.mk

FIXME_EXAMPLE_USES_BLE := \
 lunch_beacon.c \
 lunch_button.c \
 lunch_nvds.c \
 lunch_gatt.c \

LED States

As of now, the LED will only blink when entering pairing mode to avoid confusion.

Please check src/non_bt/lunch_led.c for LED duration times

TODO:

• Get a unique sticker for each with QR code or link or device ID
• More accessible pairing (not just website)
• Make it work :(