TESAIoT Hackathon

Install Bitstream Studio, flash the TESAIoT PSoC Edge DevKit, and run live sensor demos — no firmware or extension build required.

Latest VSIX: Bitstream Studio 0.1.14 (vsix/bitstream-studio-0.1.14.vsix)
Paired firmware HEX: 0.1.12 (no newer HEX drop yet — prefer matching versions when flashing)
Updated: 2026-07-24
Repository: github.com/drsanti/TESAIoT_Hackathon

Prefer matching VSIX and firmware versions. When in doubt, use the latest entry in the firmware manifest.

Folder	Purpose
`vsix/`	Bitstream Studio extension — install in VS Code or Cursor
`ide/`	BitStream IDE installers (all-in-one app; optional)
`hex/`	DevKit firmware — flash before hardware labs
`flasher/`	TESAIoT Flasher desktop installers (Windows / macOS / Linux)
`web-app/`	Telemetry provider HTML examples (ex01–ex15)
`python-app/`	Progressive BLE + BS2 Python labs (GATT ATT ops + all sensors)

Requirements

Item	When you need it
VS Code or Cursor	Always — to run Bitstream Studio VSIX or use `ide/` BitStream IDE
BitStream IDE (optional)	All-in-one installers in `ide/` — no separate VSIX step
TESAIoT PSoC Edge DevKit + USB cable	Hardware labs (Bitstream mode)
TESAIoT Flasher or ModusToolbox	To flash firmware from `hex/` — installers in `flasher/`
Bitstream Simulator extension (optional)	Try the UI without a board (Simulator mode)

Quick start

1. Download this repo

Option A — Git

git clone https://github.com/drsanti/TESAIoT_Hackathon.git
cd TESAIoT_Hackathon

Option B — ZIP — On GitHub, click Code → Download ZIP, then extract the folder.

2. Install Bitstream Studio

Open vsix/ and select the newest bitstream-studio-<version>.vsix (current VSIX: 0.1.14; paired HEX still 0.1.12), or the version your instructor specified.
In VS Code or Cursor: Extensions → … → Install from VSIX… → select that file.
Click Reload when prompted.
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) → Open Bitstream Studio.

More detail: vsix/README.md

Optional — install from the terminal (from the repo root; change the version if needed):

code --install-extension vsix/bitstream-studio-0.1.14.vsix
code -r

Use cursor instead of code if you use Cursor. To replace an older install first:

code --uninstall-extension TERNIONDEV.bitstream-studio

3. Flash firmware (hardware labs)

Open hex/ and pick tesaiot-bitstream-<version>.hex with the same version as your VSIX (current: tesaiot-bitstream-0.1.12.hex).
Flash the board with TESAIoT Flasher (flasher/) or ModusToolbox.
If no serial port appears, unplug and replug the USB cable.

More detail: hex/README.md

4. Connect your board or simulator

In Bitstream Studio, choose Bitstream (real DevKit) or Simulator (no hardware).
For Bitstream: select your COM port and set baud rate to 921600.
Open Sensor Telemetry or Sensor Studio and confirm readings update.

Bitstream Studio starts its background services when the extension loads — nothing else to install for normal use.

5. First-time tips

Goal	What to do
3D models in the UI	Command Palette → Download Free Assets from GitHub
Blank or frozen panel	Command Palette → Bitstream Studio: Reload Webview, or Developer: Reload Window

Web app examples

The web-app/ folder has HTML pages that display live sensor data while Bitstream Studio is running on your computer.

How to run

Complete steps 2 and 4 above (extension installed, telemetry connected).
For MQTT examples (ex09–ex15): toolbar Server → Start broker.
Command Palette → Serve Web App Folder over HTTP → select the web-app folder from this repo.
Click the link in the notification, or open index.html from that served URL.
Choose an example from the list.

Open web-app/index.html in the served site for the full catalog and short instructions.

Desktop BLE (Python labs)

For direct BLE to the DevKit (no browser Web Bluetooth), use the teaching labs in python-app/:

cd python-app
python -m pip install -r requirements.txt
./run_lab.sh 01          # Unix
run_lab.cmd 01           # Windows

See python-app/README.md for the lab map (scan → connect → GATT → PING → sensors).

Rate tip: keep teaching labs near 1 Hz periodic rates (shared/rates.py). High multi-sensor rates over BLE can starve CM33.

Browser BLE (React / Web Bluetooth)

Interactive tutorial + @ternion/tbs-* live in ble-react/:

cd ble-react
pnpm install
pnpm dev                 # http://localhost:5174/

Use system Chrome or Edge. Follow Why → Do → Check on each chapter. On Windows, if GATT drops right after connect, pair TESAIoT-* in Settings → Bluetooth, then open /diag (Run all 1→6). Canonical notes: ble-react/docs/WEB_BLUETOOTH_WINDOWS.md.

Example catalog

Page	Sensors / topic
ex01 — SHT40	Temperature and humidity
ex02 — DPS368	Pressure and temperature
ex03 — BMM350	Magnetometer and compass
ex04 — BMI270 IMU	Accelerometer and gyro
ex05 — BMI270 horizon	Artificial horizon
ex16 — ADC_POT	POT1–POT4 millivolts
ex17 — SW_BTN	SW0 / SW5 / SW6 state + press counts
ex06 — Dashboard	All six sensors (IMU, env, pots, switches)
ex07 — Catalog browser	Browse sensor catalog
ex08 — Stale / route	Connection status demo
ex09 — MQTT subscriber	MQTT broker smoke test (`ws://127.0.0.1:8883`)
ex10 — MQTT publisher	Publish lab JSON to `sensors/lab/temp`
ex11 — MQTT wildcards	`sensors/+/temp` and `sensors/#` filter log
ex12 — DevKit gauges	Parse MQTT `channels` payload to gauge cards
ex13 — LiveDataClient MQTT	SDK connect, subscribe, and publish
ex14 — QoS & retain	QoS 0/1/2 and retain flag lab
ex15 — WS vs MQTT dashboard	Switch `:9998` WebSocket bus vs `:8883` MQTT

Bitstream vs Simulator

Mode	Use this when
Bitstream	Your DevKit is plugged in and firmware from `hex/` is flashed
Simulator	You have no board — install the separate Bitstream Simulator extension

Use one mode at a time. Switching modes clears old sample data.

Troubleshooting

Problem	What to try
VSIX will not install	Use VS Code 1.85+ or a current Cursor build; download the VSIX again
Bitstream panel is blank	Reload the webview or reload the window; check the extension is enabled
No COM port	Re-flash firmware; try another USB port or cable; on Windows, install the KitProg3 driver
Linux: board not listed	Replug USB; Refresh in the flasher; udev rules for KitProg3 — see `flasher/README.md`
Port open but no sensor data	Toolbar set to Bitstream; baud 921600; VSIX and firmware versions match
Web examples show no data	Bitstream Studio is open; board or simulator connected; you used Serve Web App Folder over HTTP on the `web-app` folder
Missing 3D models	Command Palette → Download Free Assets from GitHub

Step-by-step help: vsix/README.md · hex/README.md · flasher/README.md

Navigation Menu

Repository files navigation

TESAIoT Hackathon

Contents

Requirements

Quick start

1. Download this repo

2. Install Bitstream Studio

3. Flash firmware (hardware labs)

4. Connect your board or simulator

5. First-time tips

Web app examples

How to run

Desktop BLE (Python labs)

Browser BLE (React / Web Bluetooth)

Example catalog

Bitstream vs Simulator

Troubleshooting

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
ble-flet		ble-flet
ble-react		ble-react
flasher		flasher
hex		hex
ide		ide
python-app		python-app
vsix		vsix
web-app		web-app
.gitattributes		.gitattributes
.gitignore		.gitignore
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

TESAIoT Hackathon

Contents

Requirements

Quick start

1. Download this repo

2. Install Bitstream Studio

3. Flash firmware (hardware labs)

4. Connect your board or simulator

5. First-time tips

Web app examples

How to run

Desktop BLE (Python labs)

Browser BLE (React / Web Bluetooth)

Example catalog

Bitstream vs Simulator

Troubleshooting

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages