Skip to content
CC2 Device Documentation

UI & Display Config

Configures the device’s user interface language, screen lock behaviour, log level, and display orientation.

Key path: devcfg.ui

{
  "devcfg": {
    "ui": {
      "lang": "en:EN:0,fr:FR:1",
      "enable_lock": true,
      "lock_pin": "0000",
      "lock_timeout_secs": 60,
      "log_level": "0:RUN:1,1:INFO:0,2:DEBUG:0",
      "visitor_id": "NOTSET",
      "auto_rotate": false,
      "display_orient": 0,
    },
  },
}

lang

Section titled “lang”

Defines the available languages and which one is active. Format: langCode:LANG_NAME:activeFlag, comma‑separated. Only one language may have activeFlag=0.

Configuration variables

  • Type: string
  • Default: "en:EN:0"
{
  "devcfg": {
    "ui": {
      "lang": "fr:FR:0,en:EN:0,de:DE:1",
    },
  },
}

enable_lock

Section titled “enable_lock”

When true, the lock screen is enabled. The device locks after lock_timeout_secs of inactivity and requires lock_pin to unlock.

Configuration variables

  • Type: boolean
  • Default: false
{
  "devcfg": {
    "ui": {
      "enable_lock": true,
    },
  },
}

lock_pin

Section titled “lock_pin”

PIN code for unlocking the device.

Configuration variables

  • Type: string
  • Default: "0000"
{
  "devcfg": {
    "ui": {
      "lock_pin": "1234",
    },
  },
}

lock_timeout_secs

Section titled “lock_timeout_secs”

Seconds of inactivity before the lock screen activates.

Configuration variables

  • Type: integer
  • Default: 60
{
  "devcfg": {
    "ui": {
      "lock_timeout_secs": 30,
    },
  },
}

log_level

Section titled “log_level”

Controls which log levels are displayed. Format: level:name:enabled, comma‑separated. enabled=1 shows that level, 0 hides it.

Configuration variables

  • Type: string
  • Default: "0:RUN:1,1:INFO:0,2:DEBUG:0"
{
  "devcfg": {
    "ui": {
      "log_level": "0:RUN:1,1:INFO:1,2:DEBUG:0",
    },
  },
}

visitor_id

Section titled “visitor_id”

Identifier for the current visitor/user, used in logs and on screen.

Configuration variables

  • Type: string
  • Default: "NOTSET"
{
  "devcfg": {
    "ui": {
      "visitor_id": "guest42",
    },
  },
}

auto_rotate

Section titled “auto_rotate”

If true, the display rotates automatically based on the orientation sensor.

Configuration variables

  • Type: boolean
  • Default: false
{
  "devcfg": {
    "ui": {
      "auto_rotate": true,
    },
  },
}

display_orient

Section titled “display_orient”

Forces a fixed display orientation when auto_rotate is false.

Configuration variables

  • Type: integer (0 or 1)
  • Default: 0
Value Orientation
0 Portrait
1 Inverted portrait 
{
  "devcfg": {
    "ui": {
      "display_orient": 1,
    },
  },
}
Section titled “Related”