Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ovos-PHAL-plugin-system

This PHAL plugin gives OpenVoiceOS commands to control the host system. It handles NTP sync, SSH, reboot, shutdown, factory reset, and language configuration through bus events. The plugin does not yet define a dbus interface.

Install

pip install ovos-PHAL-plugin-system

Config

This plugin can run as an admin plugin. An admin plugin runs as root. To enable it, add this to mycroft.conf:

{
"PHAL": {
    "admin": {
        "ovos-PHAL-plugin-system": {"enabled": true}
    }
}
}

If you omit this config, the plugin runs as the regular user. In that case, you need a polkit policy that allows systemctl without sudo. This policy is not yet implemented.

Usage

The plugin listens for these bus events and reacts to each one:

self.bus.on("system.ntp.sync", self.handle_ntp_sync_request)
self.bus.on("system.ssh.status", self.handle_ssh_status)
self.bus.on("system.ssh.enable", self.handle_ssh_enable_request)
self.bus.on("system.ssh.disable", self.handle_ssh_disable_request)
self.bus.on("system.reboot", self.handle_reboot_request)
self.bus.on("system.shutdown", self.handle_shutdown_request)
self.bus.on("system.factory.reset", self.handle_factory_reset_request)
self.bus.on("system.factory.reset.register", self.handle_reset_register)
self.bus.on("system.configure.language", self.handle_configure_language_request)
self.bus.on("system.mycroft.service.restart", self.handle_mycroft_restart_request)

Related projects

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ovos_phal_plugin_system-1.3.8a2.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ovos_phal_plugin_system-1.3.8a2-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file ovos_phal_plugin_system-1.3.8a2.tar.gz.

File metadata

File hashes

Hashes for ovos_phal_plugin_system-1.3.8a2.tar.gz
Algorithm Hash digest
SHA256 e54177be369721b140b693049bbee34b3e2c87e2ca602955d15754cc17623499
MD5 741ef5f567d9f94bcb59de125ae74b0a
BLAKE2b-256 dead795698dd363152c6e42575e7386f8aad7a454598004b692022f51be4b4bb

See more details on using hashes here.

File details

Details for the file ovos_phal_plugin_system-1.3.8a2-py3-none-any.whl.

File metadata

File hashes

Hashes for ovos_phal_plugin_system-1.3.8a2-py3-none-any.whl
Algorithm Hash digest
SHA256 b43523928ab69e5b0449e2ee6b16a4517dad4df556ee3b6f3332f1d061ec771a
MD5 7a78904915d496eef0a17fcefa94206e
BLAKE2b-256 7d1273623706c97fdc84753d0539c6470889b148fbe8b5289fcc68fcecd33173

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page