Skip to main content

Device Types

Device Types categorize devices for grouping, filtering, and UI presentation. They provide a way to organize your device inventory by function.

Overview

Device types are simple categorization labels assigned to devices. They help with:

  • Filtering: Quickly find devices of a specific type in the device grid
  • Grouping: Organize devices logically in reports and dashboards
  • UI Icons: Some UI components use device type for icon selection

Viewing Device Types

The main grid displays all configured device types:

  • ID - Unique identifier
  • Name - Internal type name
  • Description - Type description

Grid Actions

  • Add - Create a new device type
  • Delete - Remove a device type

Creating a Device Type

  1. Click Add in the grid toolbar
  2. Enter the device type details:

Name

  • Internal identifier (lowercase_with_underscores)
  • Auto-formatted on blur
  • Examples: av_receiver, lighting_controller, thermostat

Description

  • Human-readable description of the device category
  • Examples: "Audio/Video Receivers", "Lighting Controllers", "HVAC Thermostats"
  1. Click Save

Common Device Types

NameDescription
controllerSystem controllers and gateways
av_receiverAudio/video receivers
displayTVs, projectors, monitors
matrixVideo/audio switchers
processorAudio processors, DSPs
cameraIP cameras and NVRs
thermostatHVAC controls
lighting_controllerLighting gateways
shade_controllerWindow treatment controllers
lockDoor locks and access control
sensorEnvironmental sensors
relayContact closure devices

Assigning Device Types

Device types are assigned in the Devices editor:

  1. Navigate to System > Devices
  2. Edit a device
  3. In the General tab, select a Device Type
  4. Save

Accessing This Page

The Device Types page is accessible from:

  • The Device Types button in the Devices page header

Database Schema

ColumnTypeDescription
idINTEGERPrimary key
nameSTRINGType name (required)
descriptionSTRINGOptional description
  • Devices - Device management and type assignment
  • Subsystems - Subsystem-level device organization