Display

Endpoints

Method	Path	Description
GET	/api/v2/device/display	Returns display state
PUT	/api/v2/device/display	Changes display state

Get Display State

URL	/api/v2/device/display
Method	GET
Authentication	basic
Version	2.0.0

Description

Returns information about the display like brightness, mode and size in pixels. Since version 2.1.0 returns information about screen saver settings.

Response

{
  "brightness": <0-100>,
  "brightness_mode": "[auto|manual]",
  "height": 8,
  "width": 37,
  "type": "mixed"
}

Since version 2.1.0 screensaver node has been added:

{
  "brightness": <0-100>,
  "brightness_mode": "[auto|manual]",
  "height": 8,
  "width": 37,
  "type": "mixed",
  "screensaver": {
    "enabled": [true|false],
    "modes": {
      "time_based": {
        "enabled": [true|false]
        "start_time": "<time>"
        "end_time": "<time>",
      },
      "when_dark": {
        "enabled": [true|false]
      }
    },
    "widget": "<widget_uuid>"
  }
}

Property	Type	Description
brightness	Integer	Brightness of the display. Valid values [0..100]
brighrness_mode	Enum	[“auto”, “manual”] auto – automatically adjust brightness manual – brightness is configured by the user
width	Integer	Width of the display in pixels
height	Integer	Height of the display in pixels
type	Enum	Display type. Valid values are : [“monochrome”, “grayscale”, “color”, “mixed”]
Since API version 2.1.0
screensaver	Object	Object for screensaver configuration (off, when dark, timebased).

Screensaver

Property	Type	Description
enabled	Boolean	Enables or disables the screensaver.
modes	Map	Map of modes supported by the device. Currently “time_based” and “when_dark” are supported time_based – activates if time is between start_time and end_time when_dark – activates when light sensor senses darkness.
widget	String	UUID of the widget that should be activated when screensaver is active. Currently clock is supported.

Example

Request:

GET https://<device ip address>:4343/api/v2/device/display

cURL:

$ curl -X GET -u "dev" -k \
  -H "Accept: application/json" \
  https://<device ip address>:4343/api/v2/device/display
$ Enter host password for user 'dev': <device API key>

Response:

HTTP/1.1 200 OK
CONTENT-TYPE: application/json;charset=UTF8
Transfer-Encoding: chunked
Date: Wed, 29 Jun 2016 13:47:05 GMT
Server: lighttpd/1.4.35

{
  "brightness": 100,
  "brightness_mode": "auto",
  "height": 8,
  "width": 37,
  "type": "mixed",
  "screensaver": {
    "enabled": true,
    "modes": {
      "time_based": {
        "enabled": true,
        "end_time": "18:42:56",
        "start_time": "18:41:53"
      },
      "when_dark": {
        "enabled": false
      }
    },
    "widget": "08b8eac21074f8f7e5a29f2855ba8060"
  }
}

---

Update Display State

URL	/api/v2/device/display
Method	PUT
Authentication	basic
Version	2.0.0

Description

Updates display state. It is possible to change brightness, mode and screen saver settings. If brightness_mode is set to “auto”, brightness value still can be changed but this will not affect the actual brightness of the display. Brightness will be changed as soon as brightness_mode is set to “manual”. Since API 2.1.0 it is possible to configure screensaver settings.

Body

{
"brightness": <0-100>,
"brightness_mode": "[auto|manual]"
}

Since API 2.1.0:

{
"brightness": <0-100>,
"brightness_mode": "[auto|manual]",
"screensaver": {
        "enabled": [true|false],
        "modes": {
                "when_dark": {
                        "enabled": [true|false]
                }
                }
        }
}

Example

Let’s set auto brightness and enable screensaver in mode “when dark”:

Request

REST:

PUT https://<device ip address>:4343/api/v2/device/display

Content-Type: application/json
Accept: application/json

{
    "brightness_mode": "auto",
    "screensaver": {
        "enabled" : true,
        "modes": {
            "when_dark": {
                "enabled": true
            }
        }
    }
}

cURL:

$ curl -X PUT -k -u "dev" \
  -H "Accept: application/json"
  -H "Content-Type: application/json" \
  -d '{
        "brightness_mode":"auto",
        "screensaver": {
        "enabled":true,
        "modes": {
            "when_dark" : {
            "enabled" : true
          }
        }
      }
    }' https://<device ip address>:4343/api/v2/device/display
$

Response

HTTP/1.1 200 OK
CONTENT-TYPE: application/json;charset=UTF8
Transfer-Encoding: chunked
Date: Wed, 29 Jun 2016 14:25:48 GMT
Server: lighttpd/1.4.35

{
    "success" : {
        "data" : {
            "brightness" : 50,
            "brightness_mode" : "manual",
            "height" : 8,
            "type" : "mixed",
            "width" : 37
        },
        "path" : "/api/v2/device/display"
    }
}

Since API 2.1.0:

HTTP/1.1 200 OK
CONTENT-TYPE: application/json;charset=UTF8
Transfer-Encoding: chunked
Date: Thu, 02 Mar 2017 16:24:18 GMT
Server: lighttpd/1.4.35

{
    "success" : {
        "data" : {
            "brightness" : 100,
            "brightness_mode" : "auto",
            "height" : 8,
            "width" : 37,
            "type" : "mixed",
            "screensaver" : {
                "enabled" : true,
                "modes" : {
                    "when_dark" : {
                        "enabled" : true
                    },
                    "time_based" : {
                        "enabled" : false,
                        "end_time" : "00:00:00",
                        "start_time" : "00:00:00"
                    }
                },
                "widget" : "08b8eac21074f8f7e5a29f2855ba8060"
            }
        },
        "path" : "/api/v2/device/display"
    }
}