SystemK v2.01: The K-Points game #16

Open

Joe wants to merge 29 commits from coin_game_feature_dev into main

pull from: coin_game_feature_dev

merge into: Software:main

Software:main

Conversation 0 Commits 29 Files changed 122 +32328 -1159

Joe commented 2026-06-04 01:59:02 +00:00

Owner

Copy link

SystemK v2.01: The K-Points Game

This version of SystemK is based on Version 0.13 of the KTag Beacon Specification, which adds Packet Type 0x08: the TRANSFER packet. This packet is used for transferring items (starting with a in-game currency called K-Points) from device to device reliably.

Related PRs:

• #16
• Software/2024A-SW#19
• Software/2020TPC-SW#9
• Software/KTag-HIL-Tester#1

# SystemK v2.01: The K-Points Game This version of SystemK is based on [Version 0.13](https://ktag.clubk.club/Technology/BLE/KTag%20Beacon%20Specification%20v0.13.pdf) of the KTag Beacon Specification, which adds *Packet Type 0x08: the TRANSFER packet*. This packet is used for transferring items (starting with a in-game currency called K-Points) from device to device reliably. ## Related PRs: - https://git.ktag.clubk.club/Software/SystemK/pulls/16 - https://git.ktag.clubk.club/Software/2024A-SW/pulls/19 - https://git.ktag.clubk.club/Software/2020TPC-SW/pulls/9 - https://git.ktag.clubk.club/Software/KTag-HIL-Tester/pulls/1

Joe added 23 commits 2026-06-04 01:59:02 +00:00

Rate-of-fire is configurable a0bb936c28

Check for NULL pointers in the animations. 1305377081

Fully automatic operation supported. f1f881bf3b

pdMS_TO_TICKS() 8bf0872f19

Initialization fixes. f6d1a087a9

Raised SystemK task priority. 6c6685992f

Bumped SystemK version. f16d779200

Centralized BLE background advertising; fixed BLE quiet bugs in Configuring state. ... 896434f3be

Replaced the fragmented per-state BLE advertisement timers (BLEStatusTimer in
State_Playing and State_Ready) with a single BLEBackgroundAdvertisingTimer in
State_Machine.c. The central timer's callback dispatches to the correct
BLE_UpdateXXXPacket() function based on current state, with a per-state period
(500ms for Playing, 1000ms for Ready/Configuring, 2000ms for Wrapping Up).

SuspendBLEBackgroundAdvertising() and ResumeBLEBackgroundAdvertising() are
exposed from State_Machine for states that need to opt out.
State_Starting_Game__Instigating uses these to suppress the central timer while
it manages its own BLE updates inline.

Two bugs fixed in HandleBLEConfigurationPacket() in State_Configuring:

1. Non-targeted devices were not going quiet during a configuration exchange,
   consuming BLE bandwidth needed by the devices actually communicating.
   They now call BLE_Quiet() explicitly.

2. The BLEConfigurationResponseTimer (which resumes background advertising
   after 3 seconds) was only started when the packet was addressed to this
   device. It now starts unconditionally, so both targeted and non-targeted
   devices resume background advertising after the 3-second window.

BLEConfigurationResponseTimer callback now calls ResumeBLEBackgroundAdvertising()
instead of BLE_UpdateHelloPacket() directly; the background timer handles that
on its next tick.

Updated README. 83fabd5ebb

Added state machine tests. 9f62b27cb9

Stop the long press timer when leaving the Interacting state. b4e1b23c9e

Added BLE tests. 652b020e4f

BLE fixes after HIL testing. ab5f2062db

One more BLE fix. 3c61ddf87d

Added inventory. e942ef33b2

First working K-Point transfer. 80f424af55

Fixes from HIL testing. f0a13359c1

Changes to the Configuring state after testing with many devices. 9aaffb67b6

Handled FreeRTOS differences by platform. 147797efbc

Don't use BLE until the Initialization state is complete. 617835dd37

Fixed background advertising in the Configuring state. 4a237ad35f

More reasonable logging. 973e568c50

Stop the Packet Tracker from spamming the console. 861f79020b

Joe referenced this pull request from Software/2024A-SW 2026-06-04 02:01:09 +00:00

SystemK v02.01: The K-Points game #19

Joe added 1 commit 2026-06-06 02:00:48 +00:00

You lose your KPoints when you're tagged out. 6a2b4624fd

Joe added 1 commit 2026-06-07 19:54:35 +00:00

Added deduplication to BLE_TRANSFER_REQUEST_INVOLUNTARY_FRIENDLY 8b1c79971c

Joe added 1 commit 2026-06-07 21:35:48 +00:00

Added Min_RSSI_To_Initiate_Transfer f980a66311

Joe added 1 commit 2026-06-07 22:33:25 +00:00

Min_RSSI_To_Initiate_Transfer now configurable over BLE c8bd3ff8ac

Joe added 1 commit 2026-06-10 02:07:18 +00:00

DBQ Protocol was sometimes double-counting Purple tags. d996fa255c

Joe added 1 commit 2026-06-10 02:13:49 +00:00

Added BLE_UpdateConsolePacket() 4ffa68bb31

All checks were successful

Hide all checks

Tests / build-and-test (push) Successful in 15s

Details

Tests / build-and-test (pull_request) Successful in 14s

Required

Details

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin coin_game_feature_dev:coin_game_feature_dev

git switch coin_game_feature_dev

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Software/SystemK!16

No description provided.