Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tab5 Remote Display

Actual Tab5 Remote Display setup moving from the PulseSensor and StickS3 sender to the Tab5 dashboard

One PulseSensor, one StickS3 sender, and one Tab5 display in the actual project setup.

Tab5 Remote Display gives a PulseSensor project a spacious, touch-driven dashboard. A StickS3 samples one PulseSensor and runs the demo beat detector; the Tab5 receives that sender's stream and turns it into a five-second waveform, BPM and IBI readouts, signal guidance, and a set of focused mini-app screens.

The public project scope is intentionally simple: one PulseSensor, one StickS3, and one Tab5.

From sensor to screen

The unconnected hardware needed for Tab5 Remote Display: PulseSensor, StickS3, Tab5, and removable battery

The hardware you need, shown separately and unconnected: one PulseSensor, one StickS3, one Tab5 with its battery cradle, and one removable battery.

  • PulseSensor + StickS3: capture the signal and produce the sender's demo measurements.
  • Tab5: receive the wireless display stream and render the touch interface.
  • Touch mini-apps: open the sender list, spectrum, diagnostics, power view, or return to the main dashboard.

Acquire the signal

PulseSensor worn on a finger and connected to the wrist-mounted StickS3 sender

To acquire data, wear the PulseSensor on a finger and the StickS3 on the wrist. The StickS3 samples the optical signal and sends the demo data stream over the local PulseLink network to the Tab5.

The Tab5 is the display companion to PulseLink. Follow PulseLink for the upstream PulseSensor-and-StickS3 hardware setup, then use the wireless sender and Tab5 receiver included here. Wiring instructions are kept with PulseLink rather than duplicated in this display project.

Official product pages: PulseSensor Kit · M5Stack Tab5

The upstream sender uses three connections: PulseSensor signal to StickS3 G2 / GPIO2, VCC to 3V3, and GND to GND.

Quick start

Install Python 3 and mpremote, clone the repository, and identify the two connected devices:

python3 -m pip install mpremote
git clone https://github.com/WorldFamousElectronics/Tab5-Remote-Display.git
cd Tab5-Remote-Display
python3 -m mpremote connect list

Copy the sender to the StickS3 and the display app to the Tab5, using the exact ports reported on your computer:

python3 -m mpremote connect STICKS3_PORT fs cp pulselink.py :main.py
python3 -m mpremote connect TAB5_PORT fs cp pulselink_tab5.py :main.py

Reset the Tab5 first, then reset the StickS3. See the concise installation guide for the verified software baseline and startup checks.

Feature set

These animated references show the current Tab5 feature set while replaying the same synthetic PulseLink session: one AA:BB:C0 sender at 75 BPM / 800 ms IBI and 25 packets per second. Together they cover the live dashboard, app navigation, sender overview, spectrum, developer diagnostics, and power telemetry. Each view is generated from the current Tab5 display source. They are host-rendered references rather than device photographs or framebuffer captures; fonts are approximate.

Dashboard Apps
Animated 75 BPM dashboard reference
Dashboard — approachable live waveform and vitals.
Animated Tab5 apps menu reference
Apps — routes into the deeper Tab5 views.
Sensors Spectrum
Animated one-sender sensors reference
Sensors — the same sender's BPM and IBI together.
Animated spectrum using the same 75 BPM input
Spectrum — the same waveform seen in frequency space.
Developer Power
Animated developer diagnostics reference
Developer — the same session's transport and counters.
Animated Tab5 power reference
Power — the same Tab5 session's telemetry.

Open the visual interface guide for larger images and the touch path to every screen.

Run the screen simulator

The simulator exercises every current screen, tap routing, the spectrum transform, and all four display orientations without requiring a device:

python3 -m pip install Pillow
./tools/sim_tab5.py
./tools/render_animated_svgs.py
./tools/render_animated_svgs.py --check

It is a layout and navigation reference, not a substitute for testing the physical touchscreen, radio link, sensor, or detector.

Project status

v0.1.0 marks the project's first physical-hardware checkpoint. Current main keeps the public one-sender scope and adds presentation and documentation assets; it does not add new product functionality.

Tab5 Remote Display is an educational maker project, not a calibrated instrument or medical device. Motion, ambient light, placement, and changing contact pressure can affect optical readings; do not use it for diagnosis, treatment, monitoring, or health decisions.

Troubleshooting

  • The Tab5 receiver or PulseSensor-Link network does not appear: reset the Tab5 and wait for its dashboard. If UIFlow2 opens the launcher instead, select the downloaded main.py as the boot application and reset again.
  • The StickS3 does not link: leave the Tab5 running on WAITING FOR STICK, then reset the StickS3. Give its automatic connection retries time to complete before resetting it again.
  • The dashboard keeps waiting or shows no waveform: confirm pulselink.py was copied to the StickS3 and pulselink_tab5.py to the Tab5, using the correct USB port for each board. Recopy either application if needed.
  • Restart the pair in order: reset the Tab5 first, wait for the dashboard, then reset the StickS3. A working link changes the dashboard to 1 LINKED.

For firmware-baseline and device-port details, see the optional installation guide.

Credits and license

Created by Yury Gitman and World Famous Electronics LLC. The detector adapts concepts from the MIT-licensed PulseSensor Playground; the notice is preserved in Third-party notices.

Disclosure: Yury is a co-founder of World Famous Electronics, the company that makes PulseSensor.

Released under the MIT License.

About

One PulseSensor, one StickS3, and one Tab5: a local Wi-Fi/UDP MicroPython display demo.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages