PHAL Wifi Setup

The WIFI setup plugin is responsible from managing the wifi setup process, additional plugins are required to provide specific wifi implementations, this plugin just coordinates the co-existence of multiple wifi setup methods

Listens to

Message Type Message Data Description Emitted Response Type Handled by
ovos.phal.wifi.plugin.register.client 'client': str
'type': str
'display_text': str
'has_gui': bool
'requires_input': bool
Register a wifi setup client with the plugin ovos.phal.wifi.plugin.client.registered handle_register_client
ovos.phal.wifi.plugin.deregister.client 'client': str Deregister a wifi setup client from the plugin ovos.phal.wifi.plugin.client.deregistered handle_deregister_client
ovos.phal.wifi.plugin.get.registered.clients Get the list of registered clients ovos.phal.wifi.plugin.registered.clients handle_get_registered_clients
ovos.phal.wifi.plugin.set.active.client 'client': str
'id': str
Activate a wifi setup client ovos.phal.wifi.plugin.activate.{clientID} handle_set_active_client
ovos.phal.wifi.plugin.remove.active.client Deactivate a wifi setup client ovos.phal.wifi.plugin.deactivate.{clientID} handle_remove_active_client
ovos.phal.wifi.plugin.client.setup.failure Informs the plugin that the wifi setup failed handle_client_setup_failure
ovos.phal.wifi.plugin.client.select 'client': str
'id': str
Informs the plugin about the user selected setup mechanism handle_client_select
ovos.phal.wifi.plugin.skip.setup Informs the plugin that user wants to do setup later ovos.phal.wifi.plugin.fully_offline handle_skip_setup
ovos.phal.wifi.plugin.fully_offline Notify that the user has selected fully offline operation ovos.phal.wifi.plugin.fully_offline handle_fully_offline
ovos.phal.wifi.plugin.client.select.page.removed handle_setup_page_removed
ovos.phal.wifi.plugin.user.activated Inform the plugin that the user has activated a wifi setup client handle_user_activated
mycroft.internet.connected Inform the plugin that the internet is connected handle_internet_connected
ovos.phal.wifi.plugin.status Report status of wifi setup plugin ovos.phal.wifi.plugin.status,response
ovos.phal.wifi.plugin.alive
handle_ready_check
mycroft.internet.is_ready handle_ready_check

Emits

Message Type Message Data Description Trigger Message Type Emitted by
ovos.phal.wifi.plugin.alive Inform the wifi clients that the plugin is alive on startup ovos.phal.wifi.plugin.status on load
handle_status_request
ovos.phal.wifi.plugin.client.registration.failure "error": "str" Registration failed handle_register_client
ovos.phal.wifi.plugin.client.registered "client": str
"type": str
"display_text": str
"has_gui": bool
"requires_input": bool
"id": str
Registration successful handle_register_client
ovos.phal.wifi.plugin.client.deregistered "client": str Deregistration successful handle_deregister_client
ovos.phal.wifi.plugin.registered.clients "clients": list Report registered wifi setup clients ovos.phal.wifi.plugin.get.registered.clients handle_get_registered_clients
ovos.phal.wifi.plugin.activate.{clientID} Inform the client that the activation was successful handle_set_active_client
ovos.phal.wifi.plugin.deactivate.{clientID} Inform the client that the deactivation was successful mycroft.internet.connected handle_remove_active_client
ovos.phal.wifi.plugin.fully_offline Notify that the user has selected fully offline operation handle_fully_offline
ovos.phal.wifi.plugin.status.response "watchdog_active": bool
"in_setup": bool
Notify setup and watchdog status ovos.phal.wifi.plugin.status handle_status_request
ovos.phal.wifi.plugin.setup.launched Inform about the start of wifi setup process launch_networking_setup
ovos.phal.wifi.plugin.setup.failed "error": "str" Inform the interested parties that the plugin itself failed launch_networking_setup
ovos.phal.wifi.plugin.setup.completed Inform about the end of wifi setup. typically on internet connection handle_internet_connected
ovos.shell.status.ok Make sure the GUI spinner is dismissed handle_internet_connected
mycroft.internet.is_ready.response "status": bool Report to ovos-core if internet setup has finished mycroft.internet.is_ready handle_ready_check
ovos.phal.wifi.plugin.stop.setup.event Abort ongoing wifi setup, typically during shutdown stop_setup
enclosure.notify.no_internet Signal other PHAL plugins there is no internet available _watchdog