PC GUI App

📋 Features

This is a graphical heart rate & SpO2 monitoring host application supporting the following features:

1. ✅ Serial port selection - Automatically scans available serial ports
2. ✅ Baud rate selection - Supports 9600/19200/38400/57600/115200
3. ✅ Connect/Disconnect - One-click connect/disconnect of the module
4. ✅ Start/Stop collection - Controls the sensor LED on/off
5. ✅ Start/Stop monitoring - Displays data in real time
6. ✅ Real-time data display - SpO2, heart rate, temperature

---

🔌 Hardware Connection

Heart Rate & SpO2 Module	USB-to-TTL Module
VCC	5V (important! do not connect 3.3V)
GND	GND
TX	RX (cross-connect)
RX	TX (cross-connect)

⚠️ Note: slide the module switch to UART; TX and RX must be cross-connected!

---

🚀 Running the Program

Option 1: Run the Python Script Directly

1. Install the dependency library:

pip install pyserial

1. Run the program:

cd D:\JUXI_HeartRate_SPO2\python\windows

python HeartRateOximeter.py

---

📖 Usage Steps

Step 1: Connect the Hardware

1. Connect the sensor and the USB-to-TTL adapter according to the wiring table above

VCC->VCC
GND->GND
RX->TX
TX->RX

1. Plug the USB-to-TTL adapter into a USB port on the computer

Step 2: Open the Program

Run HeartRateOximeter.exe

Step 3: Serial Port Settings

1. Select the correct serial port number (e.g., COM3)
2. Select baud rate 9600 (default)
3. Click the [Connect] button

Step 4: Start Collection

1. After a successful connection, click [Start Collection]
2. ✅ The sensor LED will light up

Step 5: Start Monitoring

1. Place your finger on the sensor
2. Click [Start Monitoring]
3. View the real-time data

---

📊 Interface Overview

┌─────────────────────────────────────────┐
│           串口设置                       │
│  串口:  [COM3  ↓]  [刷新]               │
│  波特率:[9600  ↓]  [连接]               │
├─────────────────────────────────────────┤
│           模块控制                       │
│  [启动采集]  [开始监测]                 │
├─────────────────────────────────────────┤
│           实时数据                       │
│  血氧 (SPO2):       98 %                │
│  心率 (Heart Rate): 75 Times/min        │
│  温度 (Temperature): 36.6 °C            │
│  状态:  正在监测...                     │
├─────────────────────────────────────────┤
│           使用提示                       │
│  1. 接线：VCC->5V, GND->GND, RX->TX, TX->RX          │
│  2. 点击连接后再启动采集                               │
│  3. 启动采集后传感器LED会亮起                           │
└─────────────────────────────────────────┘

---

📋 Data Interpretation

Data	Normal range	Description
Blood Oxygen (SPO2)	95% - 100%	Below 90%, consult a doctor
Heart rate	60 - 100 Times/min	Normal adult range
Temperature	25 - 35 °C	Module onboard temperature, not body temperature

Note: Just after startup or when the finger is not placed properly, the data may show -1; this is normal.

---

❓ FAQ

Q1: What should I do if no serial port is found?

A:

1. Check whether the USB-to-TTL driver is installed correctly
2. Unplug and replug the USB cable
3. Click the [Refresh] button to rescan

Q2: What should I do if the connection fails?

A:

1. Confirm the serial port selection is correct
2. Confirm the serial port is not occupied by another program (such as a serial assistant or Arduino IDE)
3. Check whether the USB-to-TTL adapter works properly

Q3: The LED does not light up after clicking Start Collection?

A:

1. Check whether VCC is connected to 5V (not 3.3V)
2. Check whether TX/RX are cross-connected
3. Confirm the sensor module itself is not damaged

Q4: The data keeps showing -1?

A:

1. Confirm that [Start Collection] has been clicked
2. Place your finger correctly on the sensor, completely covering the LED area
3. Keep your finger steady and wait a few seconds
4. Check whether the wiring is loose

Q5: The program is unresponsive?

A:

1. First click [Stop Monitoring]
2. Then click [Stop Collection]
3. Finally click [Disconnect]
4. Restart the program

---

⚠️ Precautions

1. Wiring order: Connect the sensor first, then plug in USB
2. Disconnect order: Stop monitoring first, then stop collection, and finally disconnect
3. Power requirements: The sensor must be powered at 5V; 3.3V may not work properly
4. Finger placement: During measurement, your finger must completely cover the optical area; do not press hard
5. Environmental requirements: Avoid direct strong light on the sensor

---

📞 Technical Support

If you have problems, please check:

1. Whether the hardware wiring is correct (especially TX/RX cross-connection)
2. Whether the power supply is 5V
3. Whether the USB-to-TTL driver is normal
4. Whether the serial port is occupied by another program