Quản lý thiết bị

So sánh kết quả kiểm tra tốc độ internet gần nhất của một cơ sở với nhu cầu của các thiết bị. network trả về tốc độ tải xuống và tải lên tính bằng Mbps, và đối với màn hình, camera (ghi hình cùng phát trực tiếp) và hệ thống loa đã kết nối được ghi nhận trong 24 giờ qua: số lượng thiết bị, băng thông mỗi thiết bị cần và kết nối có đủ hay không. Dùng để chẩn đoán thiết bị chậm hoặc hay mất kết nối, hoặc trước khi thêm thiết bị. Truyền facilityIds để kiểm tra nhiều cơ sở.

Các hành động:

• network: Kiểm tra băng thông mạng.

Mọi thiết bị đã đăng ký với một cơ sở: màn hình hiển thị, camera đám mây, camera mạng, AI Edge Processor, nút duress, bộ điều khiển cửa, AI Agents và cảm biến IoT. Dùng để khắc phục sự cố, kiểm kê thiết bị hoặc tìm ID của một thiết bị.

Mỗi thiết bị có loại, model, các ID (deviceUuid; deviceID đối với màn hình; deviceSerialNumber đối với nút duress), vị trí, thông tin mạng (IP, Wi-Fi hoặc Ethernet, SSID, kênh, các mạng lân cận; metadata.networkStats có cổng switch PoE), tình trạng (nhiệt độ CPU, bộ nhớ, thời gian hoạt động) và metadata.updated, heartbeat gần nhất tính bằng Unix ms. Ngoại tuyến nghĩa là không có heartbeat trong 5 phút; một thiết bị ngoại tuyến hơn 7 ngày mà có thiết bị song sinh đang trực tuyến (cùng thiết bị, tên hoặc vị trí) nhiều khả năng đã được thay thế. Các dòng networkCamera là các luồng được Edge Processor trong edgeProcessorUUID kéo về; deviceUuid của chúng (bắt đầu bằng ep_) không thể nhận lệnh. Thông tin xác thực trong URL luồng hiển thị dưới dạng : trừ khi đặt includeCredentials. Nên khuyến nghị dùng Ethernet có dây thay cho Wi-Fi.

Liên quan: cctv_cameras_read và cctv_cameras_write (camera), cctv_edge_processors_write (Edge Processor), device_inventory_write (đổi tên, cấu hình, di chuyển), device_send_command (điều khiển), device_health_read (băng thông).

Các hành động:

• list: Liệt kê thiết bị. Các thiết bị tại cơ sở, lọc theo loại hoặc tên. Khi có facilityIds, mỗi cơ sở trả về trang đầu tiên của mình.

Thay đổi một thiết bị đã đăng ký với một cơ sở. rename_screen và configure_screen thay đổi một màn hình hiển thị (xác định bằng deviceID lấy từ device_inventory_read); đối với nhóm, thẻ hoặc chế độ hiển thị của màn hình, hãy dùng các công cụ hiển thị. move chuyển một màn hình, camera đám mây, nút duress, bộ điều khiển cửa, AI Agent hoặc AI Edge Processor sang một cơ sở khác trong cùng tổ chức.

Các hành động:

• rename_screen: Đổi tên màn hình. Áp dụng ngay, kể cả với màn hình ngoại tuyến hoặc đã hết vòng đời. Cần deviceID, displayName.
• configure_screen: Thay đổi cài đặt phần cứng của màn hình. Chỉ các cài đặt bạn truyền vào mới thay đổi. Cài đặt được đẩy xuống thiết bị và có thể khởi động lại màn hình. Màn hình ngoại tuyến và đã hết vòng đời (status 409) chỉ có thể đổi tên. Cần deviceID. Yêu cầu xác nhận.
• move: Chuyển thiết bị sang cơ sở khác. facilityId là nơi thiết bị đang ở; bạn cũng cần có quyền truy cập cơ sở đích. Chuyển một Edge Processor sẽ chuyển cả các camera mạng của nó; để chuyển từng camera mạng, hãy dùng cctv_edge_processors_write transfer_cameras. Cần targetFacilityId, deviceType. Yêu cầu xác nhận.

Gửi lệnh trực tiếp đến một thiết bị, hoặc đến mọi thiết bị tại một cơ sở: khởi động lại, bật hoặc tắt màn hình, khởi động lại trình duyệt, hiển thị tin nhắn, tải một trang, cài đặt bản cập nhật hoặc ngắt rồi cấp lại nguồn cho cổng PoE. Thiết bị trực tuyến thực hiện trong vài giây; thiết bị ngoại tuyến không bao giờ nhận được lệnh. Mọi lệnh đều yêu cầu xác nhận trước.

Nhắm tới một thiết bị bằng uuid (deviceUuid của thiết bị lấy từ device_inventory_read), hoặc mọi thiết bị bằng broadcast: true. Truyền facilityIds để chạy tại nhiều cơ sở. Màn hình nhận mọi lệnh; camera nhận rebootDevice và unlockUpdates. Camera mạng (deviceUuid bắt đầu bằng ep_) không thể nhận lệnh; hãy nhắm tới Edge Processor của chúng (edgeProcessorUUID) hoặc ngắt rồi cấp lại nguồn cho cổng PoE của chúng.

Để khôi phục một camera PoE đang ngoại tuyến, hãy đọc metadata.networkStats (switchID, sw_port) của camera trong device_inventory_read, sau đó gửi powerCyclePort đến bất kỳ thiết bị trực tuyến nào tại cơ sở với đối số {switchID, switchPort}. Thiết bị đó sẽ yêu cầu bộ điều khiển mạng của cơ sở ngắt và cấp lại nguồn cho cổng.