Apparaatbeheer

Vergelijkt de laatste internetsnelheidstest van een faciliteit met wat de apparaten nodig hebben. network retourneert de download- en uploadsnelheid in Mbps, en voor schermen, camera's (opname plus livestreaming) en verbonden luidsprekersystemen die in de afgelopen 24 uur zijn gezien: het aantal apparaten, de bandbreedte die elk nodig heeft en of de verbinding volstaat. Gebruik dit om trage of wegvallende apparaten te diagnosticeren, of voordat je apparaten toevoegt. Geef facilityIds mee om meerdere faciliteiten te controleren.

Acties:

• network: Controle van de netwerkbandbreedte.

Elk apparaat dat bij een faciliteit is geregistreerd: Display Screens, cloudcamera's, netwerkcamera's, AI Edge Processors, duress-knoppen, deurcontrollers, AI-agents en IoT-sensoren. Gebruik dit om problemen op te lossen, apparatuur te controleren of de ID van een apparaat te vinden.

Elk apparaat heeft een type, model, ID's (deviceUuid; deviceID voor schermen; deviceSerialNumber voor duress-knoppen), locatie, netwerkgegevens (IP, Wi-Fi of Ethernet, SSID, kanaal, netwerken in de buurt; metadata.networkStats bevat de poort op de PoE-switch), status (CPU-temperatuur, geheugen, uptime) en metadata.updated, de laatste heartbeat in Unix-ms. Offline betekent 5 minuten geen heartbeat; een apparaat dat meer dan 7 dagen offline is en een online tegenhanger heeft (dezelfde apparatuur, naam of locatie), is waarschijnlijk vervangen. Regels met networkCamera zijn streams die de Edge Processor in edgeProcessorUUID ophaalt; hun deviceUuid (beginnend met ep_) kan geen opdrachten ontvangen. Inloggegevens in stream-URL's worden getoond als :, tenzij includeCredentials is ingesteld. Raad bekabeld Ethernet aan boven Wi-Fi.

Gerelateerd: cctv_cameras_read en cctv_cameras_write (camera's), cctv_edge_processors_write (Edge Processors), device_inventory_write (hernoemen, configureren, verplaatsen), device_send_command (bediening), device_health_read (bandbreedte).

Acties:

• list: Apparaten weergeven. Apparaten bij de faciliteit, gefilterd op type of naam. Met facilityIds retourneert elke faciliteit de eerste pagina.

Wijzigt een apparaat dat bij een faciliteit is geregistreerd. rename_screen en configure_screen wijzigen een scherm (identificeer het met deviceID uit device_inventory_read); gebruik voor groepen, tags of weergavemodus van een scherm de displaytools. move verplaatst een scherm, cloudcamera, duress-knop, deurcontroller, AI-agent of AI Edge Processor naar een andere faciliteit in dezelfde organisatie.

Acties:

• rename_screen: Een scherm hernoemen. Wordt direct toegepast, ook voor offline schermen of schermen aan het einde van hun levensduur. Vereist deviceID, displayName.
• configure_screen: De hardware-instellingen van een scherm wijzigen. Alleen de instellingen die je meegeeft veranderen. Ze worden naar het apparaat gepusht en kunnen de weergave opnieuw starten. Offline schermen en schermen aan het einde van hun levensduur (status 409) kunnen alleen worden hernoemd. Vereist deviceID. Vraagt om bevestiging.
• move: Een apparaat naar een andere faciliteit verplaatsen. facilityId is waar het apparaat nu staat; je hebt ook toegang tot de doelfaciliteit nodig. Een Edge Processor verplaatsen verplaatst ook de netwerkcamera's ervan; gebruik cctv_edge_processors_write transfer_cameras om losse netwerkcamera's te verplaatsen. Vereist targetFacilityId, deviceType. Vraagt om bevestiging.

Stuurt een live opdracht naar één apparaat, of naar elk apparaat bij een faciliteit: herstarten, weergave aan of uit, de browser herstarten, een bericht tonen, een pagina laden, updates installeren of een PoE-poort uit- en weer aanzetten. Online apparaten voeren de opdracht binnen enkele seconden uit; offline apparaten ontvangen hem nooit. Elke opdracht vraagt eerst om bevestiging.

Richt je op één apparaat met uuid (de deviceUuid uit device_inventory_read), of op elk apparaat met broadcast: true. Geef facilityIds mee om bij meerdere faciliteiten uit te voeren. Schermen accepteren elke opdracht; camera's accepteren rebootDevice en unlockUpdates. Netwerkcamera's (deviceUuid beginnend met ep_) kunnen geen opdrachten ontvangen; richt je op hun Edge Processor (edgeProcessorUUID) of zet hun PoE-poort uit en weer aan.

Om een offline PoE-camera terug te krijgen, lees je de metadata.networkStats (switchID, sw_port) ervan in device_inventory_read en stuur je powerCyclePort naar een willekeurig online apparaat bij de faciliteit met de argumenten {switchID, switchPort}. Dat apparaat vraagt de netwerkcontroller van de faciliteit de stroom op de poort te onderbreken en te herstellen.