Chuẩn bị
| Thành phần | Yêu cầu |
|---|---|
| Hệ điều hành | Windows 10 hoặc Windows 11 (64-bit) |
| Máy tính | CPU Intel Core i5 thế hệ 8 / AMD Ryzen 5 trở lên, RAM tối thiểu 8 GB (khuyến nghị 16 GB) |
| Card đồ họa | Không bắt buộc. Có card NVIDIA, AMD hoặc Intel hỗ trợ DirectX 12 thì AI chạy nhanh hơn nhiều |
| Camera | Webcam của laptop, webcam USB, hoặc camera an ninh IP có hỗ trợ RTSP (Hikvision, Dahua/Imou, Yoosee, TP-Link Tapo, EZVIZ…) |
| Ổ cứng | Khoảng 450 MB trống |
| Internet | Chỉ cần lúc tải phần mềm và khi muốn gửi cảnh báo qua Telegram. Phần nhận diện AI chạy hoàn toàn trên máy |
Tải và cài đặt
- Bấm nút Tải về ở góc trên trang để tải tệp
Fall_and_Stroke_Warning_System_Setup.exe. - Mở thư mục Downloads và nhấp đúp vào tệp vừa tải.
- Nếu Windows hiện màn hình xanh “Windows protected your PC”: bấm More info (Thông tin thêm) rồi bấm Run anyway (Vẫn chạy).
- Chọn ngôn ngữ cho trình cài đặt (Tiếng Việt hoặc English).
- Ở bước chọn tác vụ bổ sung:
- Tích Tạo biểu tượng trên Màn hình chính (Desktop) để mở ứng dụng nhanh.
- Tích Tự động chạy bảo vệ khi khởi động Windows nếu máy này dùng để giám sát 24/7 (có thể bật/tắt lại sau trong phần Cài đặt).
- Bấm Install và chờ khoảng 1 phút.
- Ở màn hình cuối, giữ dấu tích Mở Fall and Stroke Warning System ngay rồi bấm Finish.
%LOCALAPPDATA%\Programs\Fall_and_Stroke_Warning_System, không cần quyền quản trị. Bạn không cần cài Python hay bất kỳ phần mềm nào khác.Vì sao Windows hiện cảnh báo khi cài?
Phần mềm mã nguồn mở này chưa có chữ ký số doanh nghiệp, nên Windows SmartScreen cảnh báo với mọi tệp tải từ Internet chưa đủ “uy tín”. Đây không phải dấu hiệu virus. Nếu máy dùng Smart App Control (Windows 11 cài mới) và không có nút Run anyway, xem mục Xử lý sự cố.
Khởi động lần đầu
- Nhấp đúp biểu tượng Fall and Stroke Warning System trên Desktop (hoặc tìm trong menu Start).
- Chờ 10–30 giây để hệ thống nạp mô hình AI. Ứng dụng chạy ngầm nên không có cửa sổ đen hiện ra, đây là bình thường.
- Cửa sổ giao diện tự mở. Nếu sau 1 phút vẫn không thấy, mở trình duyệt và vào
http://localhost:8000. - Nếu Windows hỏi cho phép truy cập mạng (Windows Defender Firewall): bấm Allow. Cần bước này nếu muốn xem từ điện thoại hoặc máy khác.
- Nếu Windows hỏi quyền dùng camera: bấm Yes / Cho phép.
Làm quen giao diện
Thanh bên trái gồm các mục:
| Mục | Chức năng |
|---|---|
| 🏠 Tổng quan | Màn hình chính: video trực tiếp, cảnh báo mới nhất, thống kê nhanh |
| 📹 Video trực tiếp | Khung camera lớn với khung xương người và trạng thái nguy cơ |
| 🕒 Lịch sử cảnh báo | Danh sách các lần phát hiện bất thường kèm thời gian và ảnh chụp |
| 📊 Thống kê | Số người đang theo dõi, tốc độ khung hình (FPS), tình trạng hệ thống |
| ⚙️ Cài đặt | Tự chạy cùng Windows, kiểm tra camera, làm mờ mặt, Telegram, tắt hệ thống |
Trên khung camera có nút ••• (Tùy chọn Camera & Thiết bị). Mọi thao tác đổi nguồn camera, chụp ảnh, toàn màn hình, dừng/bật luồng đều nằm ở đây.
Kết nối webcam (tích hợp hoặc USB)
- Cắm webcam USB vào máy (bỏ qua nếu dùng webcam của laptop).
- Trên khung camera, bấm •••, tìm phần CẤU HÌNH NGUỒN CAMERA.
- Ở Loại Nguồn, chọn 📷 Webcam Tích hợp / USB.
- Bấm Quét để tìm các webcam đang cắm, rồi chọn webcam trong ô Chọn Webcam. Webcam 0 thường là webcam laptop, webcam USB thường là Webcam 1.
- Bấm ÁP DỤNG CAMERA và chờ vài giây để hình hiện lên.
- Bấm LƯU MẶC ĐỊNH để lần sau mở ứng dụng sẽ tự dùng camera này.
Kết nối camera IP an ninh (RTSP)
Camera IP gắn tường, gắn trần cho góc nhìn bao quát hơn webcam. Máy tính và camera phải cùng mạng Wi-Fi / mạng nội bộ.
Bước A — Lấy thông tin camera
- Địa chỉ IP của camera: xem trong ứng dụng điện thoại của hãng (mục thông tin thiết bị) hoặc trong trang quản trị modem/router (danh sách thiết bị đã kết nối). Ví dụ:
192.168.1.100. - Tên đăng nhập và mật khẩu của camera (không phải mật khẩu tài khoản app).
- Đảm bảo RTSP / ONVIF đã được bật trong cài đặt camera.
Bước B — Nhập vào ứng dụng
- Bấm ••• trên khung camera.
- Loại Nguồn: chọn 🌐 Camera IP An Ninh (RTSP).
- Hãng Camera: chọn đúng hãng. Ô Đường dẫn RTSP Stream sẽ tự điền mẫu.
- Sửa đường dẫn: thay tên đăng nhập, mật khẩu và địa chỉ IP bằng thông tin thật của camera.
- Bấm ÁP DỤNG CAMERA. Có hình là kết nối thành công, sau đó bấm LƯU MẶC ĐỊNH.
Mẫu đường dẫn theo hãng
| Hãng | Đường dẫn mẫu | Ghi chú |
|---|---|---|
| Hikvision | rtsp://admin:MATKHAU@192.168.1.100:554/Streaming/Channels/101 | 101 = luồng chính, 102 = luồng phụ (nhẹ hơn) |
| Dahua / Imou | rtsp://admin:MATKHAU@192.168.1.100:554/cam/realmonitor?channel=1&subtype=0 | subtype=1 là luồng phụ |
| Yoosee | rtsp://admin:MATKHAU@192.168.1.100:554/onvif1 | Mật khẩu là mật khẩu thiết bị đặt trong app Yoosee |
| TP-Link Tapo | rtsp://TAIKHOAN:MATKHAU@192.168.1.100:554/stream1 | Tạo “Tài khoản camera” trong app Tapo: Cài đặt nâng cao → Tài khoản camera. stream2 là luồng phụ |
| EZVIZ | rtsp://admin:MAXACMINH@192.168.1.100:554/h264/ch1/main/av_stream | Mật khẩu là mã xác minh 6 chữ in hoa trên tem dán dưới camera |
@ # : /, hãy đổi mật khẩu camera sang chỉ gồm chữ và số để tránh lỗi đường dẫn.Thử bằng video mẫu (không cần camera)
Chọn Loại Nguồn là 🎬 Tệp Video Kiểm Thử (MP4) để chạy thử hệ thống bằng một tệp video có sẵn trên máy.
Đặt camera đúng cách để AI nhận diện chính xác
📐 Độ cao 2–2,5 m, chếch xuống
Nhìn bao quát cả sàn nhà, vì người ngã sẽ nằm trên sàn.
🧍 Thấy được toàn thân
Khung hình nên chứa trọn người từ đầu đến chân ở khu vực hay đi lại.
💡 Đủ sáng, không ngược sáng
Tránh hướng camera thẳng vào cửa sổ. Ban đêm dùng camera có hồng ngoại hoặc để đèn ngủ.
🚧 Ít vật che khuất
Hạn chế bàn ghế, lan can che phần thân dưới. Mỗi phòng cần giám sát nên có một camera riêng.
Ưu tiên các khu vực dễ xảy ra ngã: phòng ngủ, lối đi tới nhà vệ sinh, phòng khách, cầu thang.
Theo dõi giám sát
Khi đang chạy, mỗi người trong khung hình được vẽ khung xương và một thẻ trạng thái. Màu cho biết mức nguy cơ:
| Màu | Trạng thái | Ý nghĩa |
|---|---|---|
| Xanh lá | NORMAL | Sinh hoạt bình thường: đi, đứng, ngồi, cúi nhặt đồ |
| Vàng | SUSPICIOUS | Có dấu hiệu cần chú ý (loạng choạng, tư thế lạ) |
| Cam | ABNORMAL | Nghi ngã hoặc biểu hiện bất thường kéo dài |
| Đỏ | HIGH RISK / ALERT | Nguy cơ cao, hệ thống phát cảnh báo; khung video có viền đỏ |
Hệ thống theo dõi các dấu hiệu nhìn thấy được qua camera: ngã đột ngột, nằm bất động trên sàn, loạng choạng mất thăng bằng, ôm đầu, ôm ngực, nôn ói.
Các nút dưới khung video
- ⏯ Tạm dừng / Tiếp tục luồng video.
- 🔊 Bật / Tắt âm thanh chuông cảnh báo trên máy tính.
- 📷 Chụp ảnh nhanh màn hình hiện tại.
- ⛶ Phóng to toàn màn hình.
Khi có cảnh báo
- Thanh đỏ “PHÁT HIỆN HÀNH VI BẤT THƯỜNG / NGUY CƠ TÉ NGÃ!” hiện trên đầu màn hình kèm chuông báo. Nếu đã cài Telegram, điện thoại cũng nhận tin nhắn kèm ảnh.
- Kiểm tra người thân ngay lập tức: đến tận nơi hoặc gọi điện.
- Sau khi đã kiểm tra, bấm ĐÃ XÁC NHẬN (DISMISS) để tắt cảnh báo.
- Ở thẻ CẢNH BÁO TÉ NGÃ: bấm Xử lý để đánh dấu sự việc đã giải quyết, hoặc Xem chi tiết để xem trong lịch sử cảnh báo.
Ảnh chụp lúc xảy ra sự việc được lưu trên máy tại thư mục cài đặt, mục data\processed\events.
Nhận cảnh báo qua Telegram trên điện thoại
Để nhận tin ngay cả khi không ở gần máy tính, cài ứng dụng Telegram trên điện thoại, sau đó:
- Mở Telegram, tìm @BotFather, gửi lệnh
/newbotvà đặt tên cho bot (ví dụ: Canh bao nha ba). - BotFather gửi về một Bot Token dạng
123456789:AAH.... Sao chép đoạn này. - Trên ứng dụng giám sát, mở ⚙️ Cài đặt → mục 📱 Thông báo qua Telegram, dán vào ô Bot Token.
- Trên Telegram, mở bot vừa tạo và bấm Start. Muốn cả nhà cùng nhận: thêm bot vào nhóm gia đình rồi nhắn một tin bất kỳ trong nhóm.
- Quay lại ứng dụng, bấm 🔎 Lấy Chat ID tự động. Ô Chat ID sẽ tự điền.
- Bật công tắc Telegram, bấm 💾 Lưu cài đặt.
- Bấm 📨 Gửi tin thử. Điện thoại nhận được tin là đã cài xong.
Bật, tạm dừng và tắt hệ thống
| Muốn… | Thao tác |
|---|---|
| Bật hệ thống | Nhấp đúp biểu tượng ứng dụng trên Desktop / menu Start |
| Tạm dừng camera (vẫn giữ ứng dụng chạy) | Bấm ••• → ⏹️ DỪNG STREAM |
| Bật lại camera | Bấm BẬT CAMERA STREAM giữa khung video, hoặc ••• → ÁP DỤNG CAMERA |
| Video bị đứng hình | Bấm ••• → 🔄 Tải lại luồng |
| Đóng cửa sổ nhưng vẫn giám sát | Bấm nút ✕ của cửa sổ. Hệ thống vẫn chạy ngầm và vẫn gửi cảnh báo Telegram |
| Mở lại giao diện khi đang chạy ngầm | Mở trình duyệt, vào http://localhost:8000 |
| Tắt hẳn hệ thống | ⚙️ Cài đặt → 🛑 Dừng hoạt động hệ thống → TẮT HỆ THỐNG |
Fall_and_Stroke_Warning_System.exe → End task.http://localhost:8000.Tự chạy cùng Windows (giám sát 24/7)
- Mở ⚙️ Cài đặt.
- Gạt công tắc 🚀 Tự động chạy nền khi mở máy tính sang bật.
- Từ lần khởi động máy sau, hệ thống tự chạy ngầm với camera đã LƯU MẶC ĐỊNH, không cần mở tay.
Gạt công tắc về tắt nếu không muốn tự chạy nữa.
Xem từ điện thoại hoặc máy tính khác trong nhà
- Trên máy đang chạy hệ thống, mở Command Prompt (gõ
cmdtrong menu Start), gõipconfigvà nhấn Enter. Ghi lại dòng IPv4 Address, ví dụ192.168.1.25. - Trên điện thoại hoặc máy khác cùng mạng Wi-Fi, mở trình duyệt và vào
http://192.168.1.25:8000(thay bằng IP vừa ghi). - Nếu không vào được: kiểm tra đã bấm Allow ở hộp thoại Windows Firewall lần đầu chạy; nếu lỡ bấm Cancel, vào Windows Security → Firewall & network protection → Allow an app through firewall và cho phép ứng dụng.
Quyền riêng tư
- Hình ảnh camera được xử lý hoàn toàn trên máy tính của bạn, không gửi lên máy chủ nào.
- Muốn che mặt người trong khung hình: ⚙️ Cài đặt → bật 🔒 Bảo vệ quyền riêng tư (Làm mờ mặt).
- Ảnh sự cố chỉ lưu trên máy, trong thư mục
data\processed\eventscủa thư mục cài đặt. Bạn có thể xóa thủ công khi không cần nữa. - Dữ liệu chỉ rời máy khi bạn bật Telegram, và chỉ gửi tới bot do bạn tạo.
- Mật khẩu camera IP và Bot Token Telegram được lưu riêng cho tài khoản Windows của bạn trong
%APPDATA%\FallStrokeWarning, không nằm trong thư mục cài đặt.
Xử lý sự cố
Không cài được: Smart App Control chặn, không có nút “Run anyway”
Trên Windows 11 cài mới, Smart App Control chặn mọi ứng dụng chưa ký số. Thử chuột phải tệp cài → Properties → tích Unblock → OK rồi chạy lại. Nếu vẫn bị chặn, chỉ còn cách tắt Smart App Control trong Windows Security → App & browser control. Lưu ý: đã tắt thì không bật lại được nếu không cài lại Windows.
Khung camera đen hoặc báo “camera bận”
- Đóng các ứng dụng khác đang dùng camera (Zoom, Teams, Zalo, Camera…).
- Vào ⚙️ Cài đặt → 🔍 Kiểm tra Camera để chẩn đoán.
- Bấm 🔓 Mở Cài đặt Quyền Camera Windows, bật Camera access và Let desktop apps access your camera.
- Thử chọn webcam khác bằng nút Quét (Webcam 0 / 1).
- Rút ra cắm lại webcam USB, sang cổng USB khác.
Camera IP không kết nối được
- Kiểm tra máy tính và camera cùng mạng; thử
ping 192.168.1.100trong Command Prompt. - Kiểm tra lại tên đăng nhập, mật khẩu (EZVIZ dùng mã xác minh trên tem, Tapo dùng “Tài khoản camera”).
- Đảm bảo RTSP/ONVIF đã bật trong app của hãng.
- Kiểm tra đường dẫn bằng phần mềm VLC: Media → Open Network Stream, dán đường dẫn RTSP. VLC xem được thì ứng dụng cũng kết nối được.
- Camera đổi IP sau khi khởi động lại modem: đặt IP tĩnh cho camera trong modem.
Video giật, FPS thấp
- Cắm sạc laptop; chọn chế độ nguồn Best performance.
- Với camera IP, dùng luồng phụ (Hikvision
102, Dahuasubtype=1, Tapostream2). - Đóng bớt các chương trình nặng đang chạy.
- Xem số FPS hiện tại ở mục 📊 Thống kê; khoảng 15 FPS trở lên là đủ để nhận diện.
Giao diện không mở / trang localhost:8000 không vào được
- Chờ thêm 30 giây sau khi mở ứng dụng rồi tải lại trang.
- Có thể ứng dụng đã chạy ngầm từ trước: chỉ cần vào
http://localhost:8000, không mở thêm lần nữa. - Cổng 8000 bị chương trình khác chiếm: tắt chương trình đó, hoặc khởi động lại máy rồi mở lại ứng dụng.
Không nhận được tin Telegram
- Kiểm tra máy tính có Internet.
- Đã bấm Start với bot (hoặc đã nhắn một tin trong nhóm có bot) trước khi bấm Lấy Chat ID tự động.
- Bấm 📨 Gửi tin thử và đọc thông báo lỗi hiện ra.
Cảnh báo nhầm hoặc bỏ sót
- Kiểm tra lại vị trí camera theo mục 7: thấy toàn thân, đủ sáng, ít bị che.
- Người ra khỏi khung hình hoặc bị che khuất thì hệ thống không theo dõi được.
- Hệ thống chỉ là công cụ hỗ trợ, không thay thế sự chăm sóc trực tiếp của người thân.
Gửi thông tin lỗi cho nhà phát triển
Nhật ký hoạt động nằm ở %LOCALAPPDATA%\Programs\Fall_and_Stroke_Warning_System\app_log.txt (dán đường dẫn này vào thanh địa chỉ của File Explorer). Gửi kèm tệp này khi báo lỗi trên GitHub.
Gỡ cài đặt
- Tắt hệ thống bằng nút TẮT HỆ THỐNG trong Cài đặt.
- Mở Settings → Apps → Installed apps, tìm Fall and Stroke Warning System → Uninstall. Hoặc dùng lối tắt gỡ cài đặt trong menu Start.
- Trình gỡ cài đặt cũng xóa mục tự chạy cùng Windows.