Files
orangepi-rag/raw/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.json
2026-06-11 23:53:48 +07:00

73 lines
18 KiB
JSON
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"success": true,
"data": {
"markdown": "[Bỏ qua nội dung](https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html#main)\n\nNếu như bài trước [**Cài đặt Home Assistant phiên bản supervised trên Orange Pi Zero2**](https://orangepi.vn/cai-dat-home-assistant-phien-ban-supervised-tren-orange-pi-zero2.html) bạn đã có thể cài Orange Pi Zero2 với USB Zigbee như là một Zigbee Gateway để quản lý các thiết bị Zigbee, thì cũng với Orange Pi Zero2 với built-in bluetooth, bạn có thể cài thêm Theengs Gateway để thiết bị này trở thành 1 BLE Gateway kết nối với các thiết bị Bluetooth.\n\n### Đầu tiên, phải hiểu khái niệm gateway là gì?\n\nMột Gateway hay một IOT Gateway nói chung, như tên gọi của nó là thiết bị đóng vai trò cổng kết nối giữa giữa các thiết bị IoT, (cảm biến, công tắc, camera, mô tơ, bộ điều khiển v.v.) và mạng internet. Tất cả dữ liệu di chuyển lên mạng internet hoặc ngược lại sẽ đi qua gateway này. IoT gateway thông thường sẽ là một thiết bị phần cứng chuyên dụng, có thiết kế linh hoạt, chịu được môi trường khắc nghiệt, hỗ trợ các chuẩn kết nối khác nhau như: LAN, WiFi, 3G, Zigbee, Z-wave, RF, Bluetooth v.v.\n\n![](https://orangepivn.b-cdn.net/wp-content/uploads/2023/02/Iot-gateway.jpg)\n\nDo đặc trưng giữa các chuẩn kết nối, như Wifi hay Zigbee, RF hay Z-wave là các tần số khác nhau, vì vậy mỗi một IOT Gateway hầu như chỉ hỗ trợ được một chuẩn kết nối, hoặc nhiều nhất là 2 chứ hiếm khi có một gateway có thể kết nối đầy đủ các chuẩn. Hơn nữa, do sự đồng bộ giữa các thiết bị, nên thường một dự án sẽ sử dụng một chuẩn kết nối chung như Zigbee hoặc RF .v.v\n\n### Giới thiệu về Theengs Gateway\n\n![](https://orangepivn.b-cdn.net/wp-content/uploads/2023/02/theengs.png) Theengs Gateway nằm trong bộ sản phẩm của Theengs ( [https://www.theengs.io](https://www.theengs.io/)) Theengs là một nhóm phần mềm mã nguồn mở trên gihub, bao gồm 6 thành phần khác nhau:\n\n- [Theeng Decoder libary](https://github.com/theengs/decoder) là thư viện bằng C++ giải mã dữ liệu trên các thiết bị cảm biến trở thành dữ liệu JSON.\n- [Theeng Gateway](https://gateway.theengs.io/) là phần mềm viết bằng Python hoạt động như một cầu kết nối BLE với MQTT, và kết nối với các controller khác nhau, trong đó có thể là Home Assistant, OpenHAB, hay NodeRED. Nó sử dụng Theeng Decoder libary bên trên để giải mã dữ liệu và phát dữ liệu qua MQTT.\n- [OpenMQTTGateway](https://github.com/theengs/OpenMQTTGateway) cũng là một gateway BLE to MQTT nhưng lại sử dụng cho các phần cứng low-end như ESP8266, ESP32, hay Arduino (Microchip AVR).\n- [Theengs Explorer](https://github.com/theengs/explorer), cũng là 1 phần mềm được viết trên Python, thiết kế để phát hiện ra các thiết bị BLE mới, đọc dữ liệu raw của các thiết bị đó, hiển thị ra trên màn hình.\n- Ngoài ra thì có thêm addon của Theengs viết riêng trên Home Assistant. [https://gateway.theengs.io/install/install.html#install-theengs-gateway-as-an-add-on-in-home-assistant](https://gateway.theengs.io/install/install.html#install-theengs-gateway-as-an-add-on-in-home-assistant)\n- và 1 app trên Android, dùng chính Bluetooth của diện thoại để kết nối các thiết bị, sử dụng điện thoại như một gateway (cái này có bản bán trả phí trên android nhưng nó cũng là mã nguồn mở nên có thể tự build apk)\n\nTheengs là chơi chữ của từ Things, trong Internet of Things Internet vạn vật mà người ta vẫn hay nói tới gần đây. Theengs chưa hoạt động được một độc lập mà vẫn cần khá nhiều công sức để cấu hình, xử lý và kết nối giữa các thiết bị IOT và Home Assistant hay NodeRED. Tuy nhiên Theengs Gateway mở ra một khả năng cho các máy tính nhúng mini-pc có sẵn Bluetooth trở thành 1 gateway  bluetooth kết nối các thiết bị IOT BLE mà không cần thêm các công cụ ngoại vi nào. Ví dụ như với Zigbee bạn sẽ cần thêm usb zigbee hay z-wave cũng vậy, thì với Theengs Gateway, chỉ riêng 1 chiếc Orange Pi đã trở thành 1 gateway BLE sau khi cài đặt.\n\n### Có cài đặt Theengs Gateway trên Orange Pi không?\n\nTất cả các thiết bị Orange Pi có sử dụng chip Dual-band như **AW859A** như [Orange Pi Zero2](https://orangepi.vn/shop/san-pham-moi-orange-pi-zero2-chip-h616-ram-512m-1gb-hdmi-cap-nguon-usb-type-c), [Orange PI 3 LTS](https://orangepi.vn/shop/orange-pi-3-phien-ban-lts-chip-allwinnner-h6-2gb-ram), … hoặc chip mới **CDW 20U5622-00** như là [Orange PI 4 LTS](https://orangepi.vn/shop/orange-pi-4-phien-ban-lts-chip-loi-6-rk339-emmc-16gb-tuy-chon-3gb-hoac-4gb-ram), …  đều có thể cài được Theengs Gateway. Cách cài đặt cũng rất dễ dàng. Bạn chỉ cần có Python3 và MQTT là đủ. Hầu hết các hệ điều hành Debian hay Ubuntu kernel 5 đều có sẵn Python3. Bạn chỉ cần cài thêm MQTT bằng câu lệnh sau\n\n`apt install mqtt`\n\nSau đó cài thêm các gói python hỗ trợ\n\n`apt install python3-pip python3-dev`\n\nVà cài Theengs Gateway\n\n`pip install TheengsGateway`\n\nSau khi cài, dùng lệnh help sau để hiện các tùy chọn\n\n`python3 -m TheengsGateway -h`\n\nthông thường nếu như bạn cài MQTT trên chính Orange Pi này, bạn sẽ chạy lệnh như sau\n\n`python3 -m TheengsGateway -H localhost [-u \"username\" -p \"password\"]` username và password của MQTT của bạn nếu có\n\nNếu bạn muốn kiểm tra xem MQTT đã nhận được thông tin mà Theengs Gateway gửi lên chưa, bạn cần cài 1 MQTT client, tôi sử dụng [MQTT Explorer](http://mqtt-explorer.com/). Các bạn có thể cài MQTT Explorer lên PC, sau đó connect đến Orange Pi và đọc các dữ liệu MQTT trên đó. Để cho MQTT Explorer trên PC có thể đọc được server MQTT trên Orange Pi, bạn cần mở cổng MQTT Server trên Orange Pi như sau\n\n`nano /etc/mosquitto/mosquitto.conf`\n\nthêm dòng này vào file, Ctrl + X và Y để lưu lại\n\n> listener 1883 0.0.0.0\n>\n> allow\\_anonymous true\n\n![](https://orangepivn.b-cdn.net/wp-content/uploads/2023/02/TheengsGateway_mqtt_explorer.png)\n\nBạn cũng có thể cài TheengGateway add-on trên Home Assistant để bắt đầu sử dụng. Chọn theo thứ tự **Settings -> Add-ons -> Add-on store -> ⁞ (Menu) -> Repositories ->** thêm vào repo sau **https://github.com/mihsu81/addon-theengsgw** -\\> Add.\n\nSau đó bạn sẽ thấy Add-on của Theengs bên dưới để cài.\n\nCác bạn tham khảo video của tôi cài full Home Assistant supervised, Zigbee2MQTT và  Theeng Gateway trên Orange Pi Zero2 bên dưới\n\n[Chia sẻ trên WhatsApp](whatsapp://send?text=Gi%E1%BB%9Bi%20thi%E1%BB%87u%20v%E1%BB%81%20Theengs%20Gateway%2C%201%20c%E1%BB%95ng%20k%E1%BA%BFt%20n%E1%BB%91i%20gi%E1%BB%AFa%20c%C3%A1c%20thi%E1%BA%BFt%20b%E1%BB%8B%20bluetooth%20v%E1%BB%9Bi%20MQTT%20-%20https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html \"Chia sẻ trên WhatsApp\")[Chia sẻ trên Facebook](https://www.facebook.com/sharer.php?u=https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html \"Chia sẻ trên Facebook\")[Chia sẻ trên Twitter](https://twitter.com/share?url=https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html \"Chia sẻ trên Twitter\")[Gửi email cho bạn bè](mailto:?subject=Gi%E1%BB%9Bi%20thi%E1%BB%87u%20v%E1%BB%81%20Theengs%20Gateway%2C%201%20c%E1%BB%95ng%20k%E1%BA%BFt%20n%E1%BB%91i%20gi%E1%BB%AFa%20c%C3%A1c%20thi%E1%BA%BFt%20b%E1%BB%8B%20bluetooth%20v%E1%BB%9Bi%20MQTT&body=Xem%20n%C3%A0y%3A%20https%3A%2F%2Forangepi.vn%2Fgioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html \"Gửi email cho bạn bè\")[Ghim trên Pinterest](https://pinterest.com/pin/create/button?url=https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html&media=https://orangepi.vn/wp-content/uploads/2023/02/theengs.png&description=Gi%E1%BB%9Bi%20thi%E1%BB%87u%20v%E1%BB%81%20Theengs%20Gateway%2C%201%20c%E1%BB%95ng%20k%E1%BA%BFt%20n%E1%BB%91i%20gi%E1%BB%AFa%20c%C3%A1c%20thi%E1%BA%BFt%20b%E1%BB%8B%20bluetooth%20v%E1%BB%9Bi%20MQTT \"Ghim trên Pinterest\")[Chia sẻ trên LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html&title=Gi%E1%BB%9Bi%20thi%E1%BB%87u%20v%E1%BB%81%20Theengs%20Gateway%2C%201%20c%E1%BB%95ng%20k%E1%BA%BFt%20n%E1%BB%91i%20gi%E1%BB%AFa%20c%C3%A1c%20thi%E1%BA%BFt%20b%E1%BB%8B%20bluetooth%20v%E1%BB%9Bi%20MQTT \"Chia sẻ trên LinkedIn\")\n\n![](https://secure.gravatar.com/avatar/fedf9d992f1e8a3e3109ac596191d91386f32fb01a7f6a91e35636c5eefb761e?s=90&d=mm&r=g)\n\n##### superadmin\n\n### Để lại một bình luận [Hủy](https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html\\#respond)\n\nEmail của bạn sẽ không được hiển thị công khai.Các trường bắt buộc được đánh dấu \\*\n\nBình luận \\*\n\nTên \\*\n\nEmail \\*\n\nTrang web\n\nΔ\n\n- Tìm kiếm:\n\n- [![](https://orangepivn.b-cdn.net/wp-content/uploads/2017/02/cropped-logo-transparent-280x280.png)Orange Pi Việt Nam](https://orangepi.vn/)\n - [Giới thiệu về máy tính nhúng](https://orangepi.vn/gioi-thieu-ve-may-tinh-nhung)\n - [Hướng dẫn đặt hàng](https://orangepi.vn/dat-hang-tai-orange-pi-viet-nam)\n - [Chính sách Bảo hành](https://orangepi.vn/chinh-sach-ban-hang-va-bao-hanh)\n - [Thư ủy quyền phân phối tại Việt Nam](https://orangepi.vn/thu-uy-quyen-phan-phoi-tai-viet-nam)\n - [Chính sách bảo mật](https://orangepi.vn/chinh-sach-bao-mat)\n - [Liên hệ](https://orangepi.vn/lien-he)\n- [Shop](https://orangepi.vn/shop)\n - [Bo Mạch Orange Pi](https://orangepi.vn/danh-muc-san-pham/bo-mach-orange-pi)\n - [Chip H3](https://orangepi.vn/tu-khoa-san-pham/chip-h3)\n - [Chip H6](https://orangepi.vn/tu-khoa-san-pham/chip-h6)\n - [RK3399](https://orangepi.vn/tu-khoa-san-pham/chip-rk3399)\n - [RK3588, RK3566](https://orangepi.vn/tu-khoa-san-pham/rk3588)\n - [Chip H616, H618](https://orangepi.vn/tu-khoa-san-pham/chip-h616)\n - [Allwinner A733](https://orangepi.vn/tu-khoa-san-pham/allwinner-a733)\n - [RAM 1GB](https://orangepi.vn/tu-khoa-san-pham/ram-1gb)\n - [RAM 2GB](https://orangepi.vn/tu-khoa-san-pham/ram-2gb)\n - [RAM 4GB](https://orangepi.vn/tu-khoa-san-pham/ram-4gb)\n - [RAM 6GB](https://orangepi.vn/tu-khoa-san-pham/ram-6gb)\n - [RAM 8GB](https://orangepi.vn/tu-khoa-san-pham/ram8gb)\n - [Phụ kiện Orange Pi](https://orangepi.vn/danh-muc-san-pham/phu-kien-orange-pi)\n - [Màn hình](https://orangepi.vn/tu-khoa-san-pham/man-hinh)\n - [Vỏ Mica lắp ghép](https://orangepi.vn/tu-khoa-san-pham/vo-mica)\n - [Vỏ thép kiêm tản nhiệt](https://orangepi.vn/tu-khoa-san-pham/vo-thep)\n - [Vỏ nhôm nhẹ tản nhiệt tốt](https://orangepi.vn/tu-khoa-san-pham/vo-nhom)\n - [Nguồn Orange Pi](https://orangepi.vn/tu-khoa-san-pham/nguon-orange-pi)\n - [Thẻ nhớ microSD](https://orangepi.vn/tu-khoa-san-pham/the-nho-microsd)\n - [Compute Module](https://orangepi.vn/tu-khoa-san-pham/compute-module)\n- [Blog](https://orangepi.vn/blog)\n - [Giới thiệu](https://orangepi.vn/category/gioi-thieu)\n - [Hướng dẫn](https://orangepi.vn/category/huong-dan)\n - [Trình diễn](https://orangepi.vn/category/trinh-dien)\n- [Đăng nhập](https://orangepi.vn/my-account \"Đăng nhập\")\n- [**Hotline: 0923449899**](tel:0923449899)\n\nBạn cần trợ giúp?\n\n[![Messenger](https://orangepi.vn/wp-content/plugins/chat-bubble/assets/images/fbmessenger.svg)Messenger](https://m.me/orangepivietnam \"Messenger\") [![Zalo Official Account](https://orangepi.vn/wp-content/plugins/chat-bubble/assets/images/zalo.svg)Zalo Official Account](https://oa.zalo.me/1687181280533723118 \"Zalo Official Account\") [![Telegram](https://orangepi.vn/wp-content/plugins/chat-bubble/assets/images/telegram.svg)Telegram](https://t.me/maytinhnhung \"Telegram\") [![Whatsapp](https://orangepi.vn/wp-content/plugins/chat-bubble/assets/images/whatsapp.svg)Whatsapp](https://api.whatsapp.com/send?phone=84923449899 \"Whatsapp\")\n\n![Orange Pi Việt Nam](https://orangepivn.b-cdn.net/wp-content/uploads/2017/02/logo-transparent.png)\n\nOrange Pi Việt NamNhà phân phối chính thức\n\nXin chào! 👋🏼👋🏼👋🏼 Tôi có thể giúp gì được bạn?\n\n- [Hotline](tel:0923449899 \"Hotline\")\n- [Facebook](https://www.facebook.com/orangepivietnam \"Facebook\")\n- [Zalo](https://oa.zalo.me/1687181280533723118 \"Zalo\")\n\n## Đăng nhập\n\nSign In - Google Accounts\n\nContinue with GoogleContinue with Google. Opens in new tab\n\nTên tài khoản hoặc địa chỉ email \\*Bắt buộc\n\nMật khẩu \\*Bắt buộc\n\nGhi nhớ mật khẩuĐăng nhập\n\n[Quên mật khẩu?](https://orangepi.vn/my-account/lost-password)",
"metadata": {
"twitter:label2": "Ước tính thời gian đọc",
"viewport": [
"width=device-width, initial-scale=1",
"width=device-width, initial-scale=1",
"width=device-width, initial-scale=1.0",
"initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no"
],
"og:type": "article",
"og:url": "https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html",
"og:image:height": "239",
"twitter:data1": "superadmin",
"ogLocale": "vi_VN",
"twitter:label1": "Được viết bởi",
"google-site-verification": "aChCo9My21XgiT2Vte3H89FgebzV7TIv4Ol3OkXaIFU",
"msapplication-TileImage": "https://orangepivn.b-cdn.net/wp-content/uploads/2025/01/cropped-fb-logo-big-png-270x270.webp",
"article:modified_time": "2023-02-06T13:12:01+00:00",
"author": "superadmin",
"description": "Đây là trang Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
"title": "Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT - Orange Pi Viet Nam",
"robots": "index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1",
"og:image": "https://orangepivn.b-cdn.net/wp-content/uploads/2023/02/theengs.png",
"publishedTime": "2023-02-06T02:32:22+00:00",
"modifiedTime": "2023-02-06T13:12:01+00:00",
"twitter:site": "@orangepi_me",
"language": "vi",
"article:published_time": "2023-02-06T02:32:22+00:00",
"ogTitle": "Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT - Orange Pi Viet Nam",
"twitter:data2": "6 phút",
"article:publisher": "https://www.facebook.com/orangepivietnam/",
"og:description": "Đây là trang Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
"ogDescription": "Đây là trang Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
"og:image:type": "image/png",
"twitter:creator": "@orangepi_me",
"og:title": "Giới thiệu về Theengs Gateway, 1 cổng kết nối giữa các thiết bị bluetooth với MQTT - Orange Pi Viet Nam",
"ogImage": "https://orangepivn.b-cdn.net/wp-content/uploads/2023/02/theengs.png",
"og:image:width": "455",
"ogSiteName": "Orange Pi Viet Nam",
"generator": [
"dominant-color-images 1.2.1",
"Site Kit by Google 1.180.0",
"webp-uploads 2.6.1"
],
"og:site_name": "Orange Pi Viet Nam",
"ogUrl": "https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html",
"og:locale": "vi_VN",
"twitter:card": "summary_large_image",
"referrer": [
"no-referrer",
"origin"
],
"favicon": "https://orangepivn.b-cdn.net/wp-content/uploads/2025/01/cropped-fb-logo-big-png-32x32.webp",
"scrapeId": "019eb212-1082-7152-9428-32b196dc7a2c",
"sourceURL": "https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html",
"url": "https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html",
"statusCode": 200,
"contentType": "text/html; charset=UTF-8",
"timezone": "America/New_York",
"proxyUsed": "basic",
"cacheState": "miss",
"indexId": "beaf6a58-df28-4cc5-a7f7-07a0b395be67",
"creditsUsed": 1,
"concurrencyLimited": false
}
},
"_http_status": 200,
"_source_url": "https://orangepi.vn/gioi-thieu-ve-theengs-gateway-1-cong-ket-noi-giua-cac-thiet-bi-bluetooth-voi-mqtt.html",
"_scraped_at": "2026-06-10T15:06:34.935501+00:00"
}