/pps/services/update/control

Software Update manager listens for messages on this control object

Publishers
Any app
Subscribers
Software Update—legacy HMI plugin (swud-legacy-hmi.so)
Note: This type of object is known as a server object, a special PPS object designed for point-to-point communication between a server and one or more clients. For details, see "Server objects" in the Persistent Publish/Subscribe Developer's Guide.

Message format

Commands sent to the /pps/services/update/control object are of the form:

msg::command_string\nid::ID_number\ndat:json:{JSON_data}

The id::ID_number field is optional.

Attributes

Attribute Data type Description
cmd Number Values 1,2,3 specify the Update Manager's behavior:
  • 1 = Reserved for future use.
  • 2 = Start an update (has no effect if update is unavailable).
  • 3 = Cancel this update.
data String Miscellaneous data; depends on the command used (for future use).

Event behavior

The Update Manager knows whether an update is available when the user inserts a USB stick containing a valid update file.
Note: The update must contain a delta file (.mld) as well as a .manifest file. For details, see "Software Updates" in the System Services Reference.

When it determines whether an update is available (e.g., the user inserts a USB stick with a valid update), the Update Manager sets updateAvailable to 1 on the /pps/services/update/status object. The HMI prompts the user and then writes the appropriate command to this control object (cmd:n:2 to install).

Example

Start an update:

# echo "cmd:n:2" > /pps/services/update/control