Categories

Categories in Eclipse SmartHome are used to provide meta information about things channels, etc. UIs can use this information to render specific icons or provide a search functionality to for example filter all things for a certain category.

Differences between categories

We seperate the categories into functional and visual. Therefore we treat thing categories as how the physical device looks like and channel categories as something that describes the functional purpose of the channel.

Thing Categories

The thing type definition allows to specify a category. User interfaces can parse this category to get an idea how to render this thing. A binding can classify each thing into one of the existing categories. The list of all predefined categories can be found in our categories overview:

Category Description Icon Example
Battery Batteries, Energy Storages battery.png
Blinds Roller shutters, window blinds, etc. blinds.png
Camera All kinds of cameras camera.png
Car Smart Cars
CleaningRobot Vacuum robots, mopping robots, etc.
Door Door door.png
FrontDoor Front Door frontdoor.png
GarageDoor Garage Door garagedoor.png
HVAC Air condition devices, Fans
Inverter Power inverter, such as solar inverters etc.
LawnMower Lawn mowing robots, etc. lawnmower.png
Lightbulb Devices that illuminate something, such as bulbs, etc. lightbulb.png
Lock Devices whose primary pupose is locking something lock.png
MotionDetector Motion sensors/detectors
NetworkAppliance Bridges/Gateway need to access other devices like used by Philips Hue for example, Routers, Switches
PowerOutlet Small devices to be plugged into a power socket in a wall which stick there poweroutlet.png
Projector Devices that project a picture somewhere projector.png
RadiatorControl Controls on radiators used to heat up rooms
Receiver Audio/Video receivers, i.e. radio receivers, satelite or cable receivers, recorders, etc. receiver.png
Screen Devices that are able to show a picture screen.png
Sensor Device used to measure something
Siren Siren used by Alarm systems siren.png
SmokeDetector Smoke detectors
Speaker Devices that are able to play sounds
WallSwitch Any device attached to the wall that controls a binary status of something, for ex. a light switch wallswitch.png
WebService Account with credentials for a website
Window Window window.png
WhiteGood Devices that look like Waschingmachines, Dishwashers, Dryers, Fridges, Ovens, etc. whitegood.png

Channel Group Categories

Channel groups can be seen as a kind of sub-device as they combine certain (physical) abilities of a thing into one. For such group channels one can set a category from the thing category list.

Channel Categories

The channel type definition allows to specify a category. A binding should classify each channel into one of the existing categories or leave the category blank, if there is no good match. There are different types of categories for channels, which are listed below.

Widgets

Category Icon Example
Colorpicker colorpicker
Number number
Rollershutter rollershutter
Slider slider
Switch switch
Text text
Group group

Weather

Category Icon Example
Sun sun
Moon moon
Clouds clouds
Sun_Clouds sun_clouds
Rain rain
Snow snow
Wind wind
Humidity humidity
Temperature temperature

Properties

Category Icon Example
BatteryLevel batterylevel
LowBattery lowbattery
CarbonDioxide carbondioxide
Energy energy
Gas gas
Oil oil
Water water
Light light
ColorLight colorlight
Temperature temperature
Smoke smoke
SoundVolume soundvolume
Pressure pressure
Fire fire
Motion motion
QualityOfService qualityofservice
Moisture moisture
Noise noise
Flow flow
Price price
Time time

Control

Category Icon Example
Heating heating
MediaControl mediacontrol
MoveControl movecontrol
Zoom zoom

Purpose

Category Icon Example
Alarm alarm
Presence presence
Vacation vacation
Party party