Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Mihini/Device Management"
(New page: === Commands === This page references all generic commands used by the platform. The commands are serialized and sent using M3DA Protocol. This is an "applicative level" specification o...) |
(→Commands) |
||
Line 1: | Line 1: | ||
− | |||
=== Commands === | === Commands === | ||
This page references all generic commands used by the platform. The commands are serialized and sent using M3DA Protocol. | This page references all generic commands used by the platform. The commands are serialized and sent using M3DA Protocol. | ||
Line 5: | Line 4: | ||
This is an "applicative level" specification opposed to the "serialization level" specification from the M3DA Protocol document. | This is an "applicative level" specification opposed to the "serialization level" specification from the M3DA Protocol document. | ||
− | In order to send command from the server to the device, or from the device to the server, an | + | In order to send command from the server to the device, or from the device to the server, an M3DA data writing is to be done on a node path, encapsulated into an <code>M3DA::Message</code> object as stated into the protocol specification. |
{| border="1" | {| border="1" | ||
Line 159: | Line 158: | ||
Configure an application to start automatically or not. | Configure an application to start automatically or not. | ||
|} | |} | ||
+ | |||
=== Variables === | === Variables === | ||
{| border="1" | {| border="1" |
Revision as of 12:17, 1 March 2013
Commands
This page references all generic commands used by the platform. The commands are serialized and sent using M3DA Protocol.
This is an "applicative level" specification opposed to the "serialization level" specification from the M3DA Protocol document.
In order to send command from the server to the device, or from the device to the server, an M3DA data writing is to be done on a node path, encapsulated into an M3DA::Message
object as stated into the protocol specification.
Command Name |
Command Arguments |
Comments |
---|---|---|
Main |
||
ReadNode |
"1" -> path.of.the.node.to.read (string), ... "n" -> path.of.the.node.to.read (string) |
Read a node or several nodes and its/their children (if any) from a tree. |
Connect |
Ask the Mihini Agent to connect to the platform server. | |
Reboot |
Ask the device or one of its asset to reboot. | |
ResetToFactoryDefault |
"restart" | "1" -> restart after setting reset (boolean|number) |
Reset agent settings to factory defaults. All persisted data about agent settings and installed software are lost.
( depending on the differences between defaultconfig.lua and persisted config, this operation may impact: server url, hearbeat, ..., or any ReadyAgent config parameter)
Not impacted modules/functionalities:
Note:
-> If this is a boolean value and it is true, it requests the agent to be restarted with a default timeout (6 seconds) |
Software Update |
||
ExecuteScript |
"url" | "1" -> url to retrieve the Lua script (string) |
-> url to retrieve the Lua script |
SoftwareUpdate |
"url" | "1" -> url to download the package (string) |
-> url provided by the server where the Software Update Package can be downloaded. |
TCP Remote Connection |
||
TCPRemoteConnect |
Install a TCP tunnel | |
Log Upload |
||
LogUpload |
"url" | "1" -> url (string) |
The url where the logs are to be uploaded. Has to be of the form "ftp://" to request ftp upload, else "http://" for HTTP Post upload |
Application Container |
||
appcon.start |
"appname" | "1" -> application name (string) |
Start an application |
appcon.stop |
"appname" | "1" -> application name (string) |
Stop an application |
appcon.autostart |
"appname" | "1" -> application name (string) |
Configure an application to start automatically or not. |
Variables
Variable |
Read/Write |
Description |
---|---|---|
@sys.appcon.list |
RO |
list of all applications currently managed by appcon, as a single string of space-separated names |
@sys.appcon.apps.<appname>.started |
RW |
whether the application is currently started (Boolean) |
@sys.appcon.apps.<appname>.autostart |
RW |
whether the application starts automatically (Boolean) |
@sys.appcon.apps.<appname>.runnable |
RO |
whether it is a runnable application |
@sys.appcon.apps.<appname>.<daemonattr> |
RO |
The current value of every daemon attribute <daemonattr>. Current attributes include: |
TBCompleted
Events
TBD