Quản lý sản phẩm
Tổng quan trang
Lối vào sử dụng và quy trình khuyến nghị
- Vào Quản lý thiết bị → Quản lý sản phẩm, trước tiên xác nhận phân loại sản phẩm, loại thiết bị, giao thức truyền tải, giao thức truyền thông và phương thức xác thực.
- Sau khi thêm sản phẩm, vào chi tiết sản phẩm, theo năng lực thiết bị cấu hình Thing Model, Modbus, SIP, sản phẩm con, cấu hình ứng dụng hoặc ứng dụng SCADA.
- Sau khi cấu hình xong thì phát hành sản phẩm, rồi vào quản lý thiết bị thêm hoặc import thiết bị.
- Sau khi thiết bị online, quay lại trang sản phẩm và Thing Model rà soát dữ liệu, lệnh, sự kiện, quy tắc và cảnh báo có liên động bình thường không.
1. Giới thiệu quản lý sản phẩm
Sản phẩm là tập hợp thiết bị, thường là mô tả của các thiết bị vật lý cùng loại, cùng model. Qua bài viết này bạn có thể hiểu các chức năng liên quan đến sản phẩm.
1. Tổng quan
Sản phẩm có khả năng quản lý hàng loạt giao thức truyền tải, giao thức truyền thông, Thing Model, cấu hình modbus của các thiết bị giống nhau, các thiết bị giống nhau thuộc cùng một sản phẩm, hiện thực khả năng quản lý thống nhất thiết bị. Dựa trên sản phẩm còn có thể cấu hình Scene Linkage, giao diện SCADA...
2. Mục cấu hình sản phẩm
| Mục cấu hình | Mô tả |
|---|---|
| Tên sản phẩm | Bắt buộc, tên sản phẩm, tùy biến |
| Phân loại sản phẩm | Bắt buộc, dropdown chọn một, cấu hình tại menu phân loại sản phẩm, nhiều sản phẩm có thể gom về một phân loại, |
| Loại thiết bị | Bắt buộc, dropdown chọn một, giám sát chọn trực tiếp thiết bị giám sát, các loại thiết bị khác tham khảo tài liệu gateway và thiết bị con (简体中文) |
| Giao thức truyền thông | Bắt buộc, dropdown chọn một, mã hóa/giải mã dữ liệu thiết bị báo lên, phải chọn phù hợp, các giao thức hiện có tham khảo menu quản lý giao thức |
| Giao thức truyền tải | Bắt buộc, dropdown chọn một, cách thiết bị kết nối nền tảng IoT, phải chọn phù hợp |
| Loại firmware | Bắt buộc, dropdown chọn một, chọn phù hợp, tham khảo tài liệu nâng cấp OTA thiết bị (简体中文) |
| Cách kết nối mạng | Tùy chọn, dropdown chọn một, chính là một nhãn, tự chọn theo cách kết nối mạng của thiết bị |
| Sản phẩm riêng tư | Công tắc, sau khi đặt riêng tư cấp dưới không xem được |
| Ủy quyền thiết bị | Công tắc, chức năng ủy quyền thiết bị, mặc định không bật, sau khi sản phẩm bật mã ủy quyền thiết bị, cần phân bổ mã ủy quyền cho thiết bị, dùng khi thiết bị xác thực |
| Phương thức xác thực | Bắt buộc, phương thức xác thực kết nối thiết bị, dropdown chọn một, có thể tham khảo tài liệu kết nối thiết bị theo các giao thức khác nhau dưới mục kết nối thiết bị |
| Cách định vị | Bắt buộc, dropdown chọn một Định vị tự động: khi thiết bị xác thực nền tảng tự động lấy định vị thiết bị; Định vị thiết bị: thiết bị chủ động báo thông tin địa chỉ kinh vĩ độ qua topic /info/post; Vị trí tùy biến: tự cấu hình thông tin địa chỉ kinh vĩ độ trong chi tiết thiết bị |
| Mã sản phẩm | Hệ thống tự động sinh |
| Tài khoản xác thực | Bắt buộc, khi thêm mới hệ thống tự động sinh, có thể tự sửa |
| Mật khẩu xác thực | Bắt buộc, khi thêm mới hệ thống tự động sinh, có thể tự sửa |
| Khóa xác thực | Bắt buộc, khi thêm mới hệ thống tự động sinh, có thể tự sửa |
| Ảnh sản phẩm | Tùy chọn, tự sửa |
| Thông tin ghi chú | Ô nhập không bắt buộc |
3. Danh sách sản phẩm
3.1. Thêm mới
Nhấn nút "+ Thêm mới", mở cửa sổ thêm sản phẩm, sau khi nhấn xác nhận có thể thấy danh sách đã có sản phẩm này
提示
Lưu ý: khi loại thiết bị sản phẩm chọn thiết bị gateway, giao thức truyền thông chọn giao thức ModbusRtu, giao thức phân tích Modbus sang Json-Huapu, giao thức ModbusTcp, giao thức phân tích gateway JSON sẽ có một nút cấu hình sản phẩm con, sau khi chọn có thể trực tiếp import sản phẩm con, cách cấu hình cụ thể tham khảo tài liệu gateway và thiết bị con (简体中文)
3.2. Sao chép
Nhấn nút "Sao chép", mở cửa sổ chọn sản phẩm, chọn sản phẩm tương ứng, nhấn xác nhận là có thể sao chép ra một sản phẩm hoàn toàn giống 
3.3. Import
Nhấn nút "Import", mở cửa sổ import sản phẩm, trước tải file mẫu json, rồi chỉnh sửa file json, sau đó nhấn tải file lên, cuối cùng nhấn xác nhận là import được
3.4. Hiển thị sản phẩm của tổ chức cấp trên
Sau khi tích chọn sẽ truy vấn ra sản phẩm của tổ chức cấp trên, nhưng không hỗ trợ chỉnh sửa
4. Chi tiết sản phẩm
Trang chi tiết sản phẩm bao gồm thông tin cơ bản, mô hình sản phẩm, cấu hình Modbus, ủy quyền thiết bị, ứng dụng SCADA, cấu hình ứng dụng...
提示
Lưu ý: ngoài sản phẩm con, tác vụ polling, cấu hình ứng dụng, các chức năng khác đều cần hủy phát hành sản phẩm trước, mới có thể chỉnh sửa
4.1. Thông tin cơ bản
Có thể sửa một số thông tin cơ bản
4.2. Mô hình sản phẩm
Thing Model là mô tả của thiết bị trên đám mây, định nghĩa một thiết bị thực từ bốn chiều: thuộc tính, chức năng, sự kiện, nhãn
- Import file Thing Model: sau khi nhấn vào cửa sổ import hàng loạt, trước tải file mẫu import Thing Model sản phẩm, sau khi chỉnh sửa xong nhấn tải file lên, cuối cùng nhấn xác nhận là import được
- Import Thing Model dùng chung: sau khi nhấn vào cửa sổ import Thing Model dùng chung, chọn Thing Model dùng chung phù hợp, cuối cùng nhấn import
- Xem Thing Model: sau khi nhấn vào cửa sổ Thing Model, có thể xem cấu trúc dữ liệu của toàn bộ Thing Model
4.2. Cấu hình ứng dụng
Giao diện chế độ trạng thái đầu di động hỗ trợ tùy biến, có thể nhấn cấu hình tại cấu hình ứng dụng sản phẩm, tại giao diện cấu hình tùy biến giao diện theo nhu cầu của mình, sau khi cấu hình xong nhấn Bật
4.3. Ủy quyền thiết bị
Chức năng tùy chọn, sau khi bật chủ yếu dùng cho xác thực thiết bị, cần phân bổ mã ủy quyền cho thiết bị
4.4. Cấu hình SIP
Mục cấu hình giao thức SIP, tương ứng giao thức tiêu chuẩn quốc gia GB28181 (tiêu chuẩn quốc gia về hệ thống liên kết giám sát video an ninh công cộng), tác dụng chính là để sản phẩm này (thường là thiết bị video, như camera) có thể kết nối nền tảng giám sát video GB28181 tiêu chuẩn quốc gia qua giao thức SIP, hiện thực đăng ký thiết bị, truyền luồng video, điều khiển thiết bị...
4.5. Sản phẩm con
Loại thiết bị gateway, một số giao thức truyền thông hỗ trợ cấu hình sản phẩm con
- Thêm mới: sau khi nhấn vào cửa sổ chọn sản phẩm, chọn sản phẩm con tương ứng, cuối cùng nhấn xác nhận để gắn kết
- Đặt địa chỉ: sau khi nhấn có thể chỉnh sửa địa chỉ thiết bị con mặc định của sản phẩm con, không được trùng lặp;
4.6. Cấu hình Modbus
Sản phẩm có giao thức là giao thức liên quan Modbus cần cấu hình, cấu hình thuộc tính của chính gateway hoặc thiết bị con của gateway trong thiết bị modbus, cách cấu hình cụ thể tham khảo tài liệu gateway và thiết bị con (简体中文)
4.7. Tác vụ polling
Giao thức liên quan Modbus cần cấu hình tác vụ polling mới có thể chủ động thu thập dữ liệu, cấu hình Modbus sản phẩm - cấu hình gateway/thiết bị con - cách thu thập phải tích chọn polling từ đám mây, khi tạo thiết bị mới thiết bị kế thừa
4.8. Gửi lệnh xuống
Giao thức truyền thông sản phẩm chọn giao thức ModbusTcp, cấu hình một số lệnh, khi tạo thiết bị mới thiết bị kế thừa, có thể nhấn gửi xuống ở phía thiết bị
4.9. Ứng dụng SCADA
Thiết kế trang SCADA cho sản phẩm, thiết bị thuộc sản phẩm đó đều xem được trang SCADA này, và hiển thị thời gian thực dữ liệu thiết bị báo lên hoặc gửi lệnh xuống
5. Phát hành sản phẩm
Sản phẩm mới tạo mặc định ở trạng thái chưa phát hành, sau khi tham khảo chi tiết sản phẩm hoàn tất định nghĩa sản phẩm, nhấn nút "Phát hành sản phẩm" để bật, sau đó có thể tạo thiết bị tương ứng sản phẩm này
提示
Lưu ý: nếu sản phẩm ở trạng thái chưa phát hành, thiết bị xác thực sẽ thất bại
6. Đa tenant
Cách ly tenant, tổ chức cấp trên có thể dùng và chỉnh sửa sản phẩm của tổ chức cấp dưới; tổ chức cấp dưới có thể xem và dùng nhưng không thể chỉnh sửa sản phẩm của tổ chức cấp trên;
7. Bảng quyết định cấu hình
Khi tạo sản phẩm, dễ chọn sai nhất là loại thiết bị, giao thức truyền thông, giao thức truyền tải và phương thức xác thực. Khuyến nghị phán đoán theo bảng dưới đây trước, rồi mới tạo sản phẩm.
| Kịch bản | Loại thiết bị | Giao thức truyền tải | Giao thức truyền thông | Mô tả |
|---|---|---|---|---|
| Cảm biến MQTT thường | Thiết bị kết nối trực tiếp | MQTT | Phân tích JSON hoặc giao thức tùy biến | Cách kết nối phổ biến nhất, phù hợp làm quen nhanh |
| Thiết bị chủ động báo HTTP | Thiết bị kết nối trực tiếp | HTTP | Phân tích JSON hoặc giao thức tùy biến | Phù hợp thiết bị báo tần suất thấp, đã có năng lực HTTP |
| Thiết bị giao thức riêng TCP | Thiết bị kết nối trực tiếp | TCP | Giao thức tùy biến | Cần thích ứng mã hóa/giải mã phía server |
| Gateway Modbus RTU | Thiết bị gateway | Chọn theo đường truyền hiện trường | ModbusRtu hoặc giao thức gateway | Cần cấu hình sản phẩm con, thanh ghi và tác vụ polling |
| Thiết bị Modbus TCP | Thiết bị kết nối trực tiếp hoặc thiết bị gateway | Modbus TCP | Giao thức ModbusTcp | Cần xác định rõ thiết bị làm client hay server |
| Camera GB28181 | Thiết bị giám sát | SIP/GB28181 | Giao thức SIP/video | Cần cấu hình SIP và dịch vụ streaming |
| Thiết bị đầu cuối định vị xe | Thiết bị kết nối trực tiếp | TCP/JT808 | Giao thức JT808 | Cần quy hoạch ánh xạ số điện thoại đầu cuối và mã thiết bị |
Checklist nghiệm thu trước phát hành
Trước khi phát hành sản phẩm khuyến nghị kiểm tra từng mục:
| Mục kiểm tra | Trạng thái bình thường |
|---|---|
| Thông tin cơ bản sản phẩm | Tên sản phẩm, phân loại, loại thiết bị, giao thức, phương thức xác thực đã xác nhận |
| Thing Model | Định danh thuộc tính, chức năng, sự kiện duy nhất, kiểu dữ liệu đúng |
| Thông tin xác thực | Tài khoản, mật khẩu, khóa MQTT/HTTP/TCP đã sinh |
| Ủy quyền thiết bị | Nếu bật ủy quyền, đã chuẩn bị cách phân bổ mã ủy quyền |
| Cấu hình Modbus | Thanh ghi, địa chỉ slave, function code, tác vụ polling đã xác nhận |
| Sản phẩm con | Sản phẩm gateway đã gắn kết sản phẩm con cần quản lý |
| Cấu hình SIP | Sản phẩm video đã cấu hình thông tin SIP và dịch vụ streaming |
| Cấu hình ứng dụng | Chế độ trạng thái đầu di động hoặc ứng dụng SCADA đã bật theo nhu cầu |
| Trạng thái phát hành | Trạng thái cuối cùng của sản phẩm là đã phát hành |
Câu hỏi thường gặp
Phát hành sản phẩm thất bại
Kiểm tra trường bắt buộc có đầy đủ không, định danh Thing Model có trùng không, cấu hình giao thức có thiếu không. Một số cấu hình cần hủy phát hành trước mới sửa được.
Xác thực thiết bị thất bại
Ưu tiên kiểm tra sản phẩm đã phát hành chưa, Product ID, mã thiết bị, tài khoản xác thực, mật khẩu xác thực mà phía thiết bị dùng có khớp với sản phẩm hiện tại không.
Thiết bị báo lên nhưng trang không hiển thị dữ liệu
Kiểm tra định danh Thing Model có hoàn toàn khớp với id trong gói tin báo lên không, kiểu dữ liệu có khớp không, sản phẩm có phát hành trước rồi mới tạo thiết bị không.
Tổ chức cấp dưới không thấy sản phẩm
Kiểm tra sản phẩm có phải sản phẩm riêng tư không, quyền dữ liệu tổ chức, quyền vai trò hiện tại và có tích chọn hiển thị sản phẩm của tổ chức cấp trên không.
Lối vào phát triển thứ cấp
| Loại | Đường dẫn hoặc API | Mô tả |
|---|---|---|
| Trang Vue3 | vue3/src/views/iot/product | Danh sách sản phẩm, chi tiết sản phẩm, mô hình sản phẩm và cấu hình ứng dụng |
| API Vue3 | vue3/src/api/iot | Đóng gói API sản phẩm, mô hình, giao thức... |
| API backend | /iot/product | API quản lý sản phẩm |
| API backend | /iot/model | API Thing Model sản phẩm |
| API backend | /iot/protocol | API quản lý giao thức |
| Mô-đun giao thức | springboot/fastbee-protocol | Mã hóa/giải mã giao thức thiết bị |
| Mô-đun nghiệp vụ | springboot/fastbee-open-api | Controller liên quan sản phẩm |
| Script SQL | springboot/sql | Cấu trúc bảng và script nâng cấp liên quan sản phẩm, Thing Model, giao thức |