/pps/services/update/status

Software Update manager communicates to apps via this status object

Publishers
Software Update—legacy HMI plugin (swud-legacy-hmi.so)
Subscribers
Any app

Attributes

Attribute Data type Description
updateAvailable Number Values 0 and 1 indicate update status:
  • 0 = No update available
  • 1 = Update available
updateDetails JSON Contains the following:
  • sourceVersion, a string indicating the version to update from
  • targetVersion, a string indicating the version to update to
  • details, a string giving a brief description of the update
  • source, a number indicating where the update came from:
    • 1 = USB
    • n/a (all other values are reserved)
updateError String (up to 256 characters) This attribute will be stored in an update object when an update becomes available. If the current version number of the target system fails to match the sourceVersion attribute populated when the update was discovered, the error description will indicate that the two versions don't match and that the update is invalid.

Sample status objects

  1. When no update is available, the status object looks like this:
    [n]@status
    updateAvailable:n:0
    
  2. When a valid update is available, the status object will look something like this:
    [n]@status
    updateAvailable:n:1
    updateDetails:json:{"sourceVersion":"162","targetVersion":"9999","details":
    "Geolocation Test","source":1}
    
  3. The following status object indicates that an update has been discovered, but the update is considered unavailable because the versions don't match:
    [n]@status
    updateAvailable:n:0
    updateDetails:json:{"sourceVersion":"87","targetVersion":"9999","details":"
    Geolocation Test","source":1}
    updateError::Current version (162) does not match source version (87),
    invalid update
    
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 this status object. The HMI prompts the user and then writes the appropriate command (cmd:n:2 to start the update) to the /pps/services/update/control object.