Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[hdpowerview] Add properties with firmware information #11979

Closed
jlaur opened this issue Jan 6, 2022 · 0 comments · Fixed by #11980, #11989 or #12214
Closed

[hdpowerview] Add properties with firmware information #11979

jlaur opened this issue Jan 6, 2022 · 0 comments · Fixed by #11980, #11989 or #12214
Labels
enhancement An enhancement or new feature for an existing add-on

Comments

@jlaur
Copy link
Contributor

jlaur commented Jan 6, 2022

Hunter Douglas PowerView firmware information is available for:

  • Hub and radio within hub (v2).
  • Shade and motor within shade.

Firmware information consists of revision, sub revision and build. Additionally, for the hub itself a name is also available.

This information can be useful:

  • To detect v1 or v2 hub by the binding itself to support any incompatibilities.
  • When investigating behavioral differences.
  • When filing RMA's for faulty products.

For the hub the information can be retrieved with this request:
GET /api/fwversion

Example response for v1 hub:

{
   "firmware":{
      "mainProcessor":{
         "name":"PowerView Hub",
         "revision":1,
         "subRevision":1,
         "build":857
      }
   }
}

Example response for v2 hub:

{
    "firmware": {
        "mainProcessor": {
            "name": "PV Hub2.0",
            "revision": 2,
            "subRevision": 0,
            "build": 1056
        },
        "radio": {
            "revision": 2,
            "subRevision": 0,
            "build": 2610
        }
    }
}

As stated in PowerView-Hub-REST-API-v2.pdf: There are multiple processors in the hub (the primary processor and the Nordic chip for RF processing); the "mainProcessor" sub-key is intended to indicate that the firmware information being returned is for the main processor on the hub, not the Nordic.

Shade firmware information is included in the shade response from:
GET /api/shades/38196

Example:

[...]
        "firmware": {
            "revision": 1,
            "subRevision": 8,
            "build": 1944
        },
        "motor": {
            "revision": 48,
            "subRevision": 51,
            "build": 11825
        },
[...]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement An enhancement or new feature for an existing add-on
Projects
None yet
1 participant