This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# Systeminfo Binding
The system information binding provides operating system and hardware information including:
- Operating system name, version and manufacturer;
- CPU average load for last 1, 5, 15 minutes, name, description, number of physical and logical cores, running threads number, system uptime;
- Free, total and available memory;
- Free, total and available swap memory;
- Hard drive name, model and serial number;
- Free, total, available storage space and storage type (NTSFS, FAT32 ..);
- Battery information - estimated remaining time, capacity, name;
- Sensors information - CPU voltage and temperature, fan speeds;
- Display information;
- Network IP,name and adapter name, mac, data sent and received, packets sent and received;
- Process information - size of RAM memory used, CPU load, process name, path, number of threads.
The binding uses the OSHI (opens new window) library to access this information regardless of the underlying OS and hardware.
# Supported Things
The binding supports only one thing type - computer. This thing represents a system with one storage volume, one display device and one network adapter.
The thing has the following properties:
cpu_logicalCores
- Number of CPU logical corescpu_physicalCores
- Number of CPU physical coresos_manufacturer
- The manufacturer of the operating systemos_version
- The version of the operating systemos_family
- The family of the operating system
If multiple storage or display devices support is needed, a new thing type has to be defined.
# Discovery
The discovery service implementation tries to resolve the computer name. If the resolving process fails, the computer name is set to "Unknown". In both cases it creates a Discovery Result with thing type computer.
It will be possible to implement creation of dynamic channels (e.g. the binding will scan how many storage devices are present and create channel groups for them). At the moment this is not supported.
# Thing configuration
The configuration of the Thing gives the user the possibility to update channels at different intervals.
The thing has two configuration parameters:
- interval_high - refresh interval in seconds for channels with 'High' priority configuration. Default value is 1 s.
- interval_medium - refresh interval in seconds for channels with 'Medium' priority configuration. Default value is 60s.
That means that by default configuration:
- channels with priority set to 'High' are updated every second
- channels with priority set to 'Medium' are updated every minute
- channels with priority set to 'Low' are updated only at initialization or if the
REFRESH
command is sent to the channel.
For more info see channel configuration
# Channels
The binding support several channel group. Each channel group, contains one or more channels. In the list below, you can find, how are channel group and channels id`s related.
thing computer
- group
memory
- channel
available, total, used, availablePercent, usedPercent
- group
swap
- channel
available, total, used, availablePercent, usedPercent
- group
storage
(deviceIndex) - channel
available, total, used, availablePercent, usedPercent, name, description, type
- group
drive
(deviceIndex) - channel
name, model, serial
- group
display
(deviceIndex) - channel
information
- group
battery
(deviceIndex) - channel
name, remainingCapacity, remainingTime
- group
cpu
- channel
name, description, load1, load5, load15, uptime
- group
sensors
- channel
cpuTemp, cpuVoltage, fanSpeed
- group
network
(deviceIndex) - channel
ip, mac, networkDisplayName, networkName, packetsSent, packetsReceived, dataSent, dataReceived
- group
process
(pid) - channel
load, used, name, threads, path
The groups marked with "(deviceIndex)" may have device index attached to the Channel Group.
- channel ::= channel_group & (deviceIndex) & # channel_id
- deviceIndex ::= number > 0
- (e.g. storage1#available)
The group process
is using a configuration parameter "pid" instead of "deviceIndex".
This makes it possible to change the tracked process at runtime.
The binding uses this index to get information about a specific device from a list of devices (e.g on a single computer several local disks could be installed with names C:, D:, E:\ - the first will have deviceIndex=0, the second deviceIndex=1 etc). If device with this index is not existing, the binding will display an error message on the console.
Unfortunately this feature can't be used at the moment without manually adding these new channel groups to the thing description (located in OH-INF/thing/computer.xml).
The table shows more detailed information about each Channel type. The binding introduces the following channels:
Channel ID | Channel Description | Supported item type | Default priority | Advanced |
---|---|---|---|---|
load1 | Load for the last 1 minute | Number | Medium | True |
load5 | Load for the last 5 minutes | Number | Medium | True |
load15 | Load for the last 15 minutes | Number | Medium | True |
threads | Number of threads currently running | Number | Medium | True |
uptime | System uptime (time after start) in minutes | Number | Medium | True |
name | Name of the device | String | Low | False |
available | Available size in MB | Number | High | False |
used | Used size in MB | Number | High | False |
total | Total size in MB | Number | Low | False |
availablePercent | Available size in % | Number | High | False |
usedPercent | Used size in % | Number | High | False |
model | The model of the device | String | Low | True |
serial | The serial number of the device | String | Low | True |
description | Description of the device | String | Low | True |
type | Storage type | String | Low | True |
cpuTemp | CPU Temperature in degrees Celsius | Number | High | True |
cpuVoltage | CPU Voltage in V | Number | Medium | True |
fanSpeed | Fan speed in rpm | Number | Medium | True |
remainingTime | Remaining time in minutes | Number | Medium | False |
remainingCapacity | Remaining capacity in % | Number | Medium | False |
information | Product, manufacturer, SN, width and height of the display in cm | String | Low | True |
ip | Host IP address of the network | String | Low | False |
mac | MAC address | String | Low | True |
networkName | The name of the network | String | Low | False |
networkDisplayName | The display name of the network | String | Low | False |
packetsSent | Number of packets sent | Number | Medium | True |
packetsReceived | Number of packets received | Number | Medium | True |
dataSent | Data sent in MB | Number | Medium | True |
dataReceived | Data received in MB | Number | Medium | True |
availableHeap | How many bytes are free out of the currently committed heap | Number:DataAmount | Medium | True |
usedHeapPercent | How much of the MAX heap size is actually used in % | Number:Dimensionless | Medium | False |
# Channel configuration
All channels can change its configuration parameters at runtime. The binding will trigger the necessary changes (reduce or increase the refresh time, change channel priority or the process that is being tracked).
Each of the channels has a default configuration parameter - priority. It has the following options:
- High
- Medium
- Low
Channels from group ''process'' have additional configuration parameter - PID (Process identifier). This parameter is used as 'deviceIndex' and defines which process is tracked from the channel. This makes the channels from this groups very flexible - they can change its PID dynamically.
Parameter PID has a default value 0 - this is the PID of the System Idle process in Windows OS.
# Reporting issues
As already mentioned this binding depends heavily on the OSHI (opens new window) API to provide the operating system and hardware information.
Take a look at the console for an ERROR log message.
If you find an issue with a support for a specific hardware or software architecture please take a look at the OSHI issues (opens new window). Your problem might have be already reported and solved! Feel free to open a new issue there with the log message and the and information about your software or hardware configuration.
For a general problem with the binding report the issue directly to openHAB.
# Example
Things:
Thing systeminfo:computer:work [interval_high=3, interval_medium=60]
Items:
/* Network information*/
String Network_AdapterName "Adapter name" <network> { channel="systeminfo:computer:work:network#networkDisplayName" }
String Network_Name "Name" <network> { channel="systeminfo:computer:work:network#networkName" }
String Network_IP "IP address" <network> { channel="systeminfo:computer:work:network#ip" }
String Network_Mac "Mac address" <network> { channel="systeminfo:computer:work:network#mac" }
Number Network_DataSent "Data sent" <flowpipe> { channel="systeminfo:computer:work:network#dataSent" }
Number Network_DataReceived "Data received" <returnpipe> { channel="systeminfo:computer:work:network#dataReceived" }
Number Network_PacketsSent "Packets sent" <flowpipe> { channel="systeminfo:computer:work:network#packetsSent" }
Number Network_PacketsReceived "Packets received" <returnpipe> { channel="systeminfo:computer:work:network#packetsReceived" }
/* CPU information*/
String CPU_Name "Name" <none> { channel="systeminfo:computer:work:cpu#name" }
String CPU_Description "Description" <none> { channel="systeminfo:computer:work:cpu#description" }
Number CPU_Load1 "Load (1 min)" <none> { channel="systeminfo:computer:work:cpu#load1" }
Number CPU_Load5 "Load (5 min)" <none> { channel="systeminfo:computer:work:cpu#load5" }
Number CPU_Load15 "Load (15 min)" <none> { channel="systeminfo:computer:work:cpu#load15" }
Number CPU_Threads "Threads" <none> { channel="systeminfo:computer:work:cpu#threads" }
Number CPU_Uptime "Uptime" <time> { channel="systeminfo:computer:work:cpu#uptime" }
/* Drive information*/
String Drive_Name "Name" <none> { channel="systeminfo:computer:work:drive#name" }
String Drive_Model "Model" <none> { channel="systeminfo:computer:work:drive#model" }
String Drive_Serial "Serial" <none> { channel="systeminfo:computer:work:drive#serial" }
/* Storage information*/
String Storage_Name "Name" <none> { channel="systeminfo:computer:work:storage#name" }
String Storage_Type "Type" <none> { channel="systeminfo:computer:work:storage#type" }
String Storage_Description "Description" <none> { channel="systeminfo:computer:work:storage#description" }
Number Storage_Available "Available" <none> { channel="systeminfo:computer:work:storage#available" }
Number Storage_Used "Used" <none> { channel="systeminfo:computer:work:storage#used" }
Number Storage_Total "Total" <none> { channel="systeminfo:computer:work:storage#total" }
Number Storage_Available_Percent "Available (%)" <none> { channel="systeminfo:computer:work:storage#availablePercent" }
Number Storage_Used_Percent "Used (%)" <none> { channel="systeminfo:computer:work:storage#usedPercent" }
/* Memory information*/
Number Memory_Available "Available" <none> { channel="systeminfo:computer:work:memory#available" }
Number Memory_Used "Used" <none> { channel="systeminfo:computer:work:memory#used" }
Number Memory_Total "Total" <none> { channel="systeminfo:computer:work:memory#total" }
Number Memory_Available_Percent "Available (%)" <none> { channel="systeminfo:computer:work:memory#availablePercent" }
Number Memory_Used_Percent "Used (%)" <none> { channel="systeminfo:computer:work:memory#usedPercent" }
/* Swap memory information*/
Number Swap_Available "Available" <none> { channel="systeminfo:computer:work:swap#available" }
Number Swap_Used "Used" <none> { channel="systeminfo:computer:work:swap#used" }
Number Swap_Total "Total" <none> { channel="systeminfo:computer:work:swap#total" }
Number Swap_Available_Percent "Available (%)" <none> { channel="systeminfo:computer:work:swap#availablePercent" }
Number Swap_Used_Percent "Used (%)" <none> { channel="systeminfo:computer:work:swap#usedPercent" }
/* Battery information*/
String Battery_Name "Name" <batterylevel> { channel="systeminfo:computer:work:battery#name" }
Number Battery_RemainingCapacity "Remaining Capacity" <batterylevel> { channel="systeminfo:computer:work:battery#remainingCapacity" }
Number Battery_RemainingTime "Remaining Time" <batterylevel> { channel="systeminfo:computer:work:battery#remainingTime" }
/* Display information*/
String Display_Description "Display description" <screen> { channel="systeminfo:computer:work:display#information" }
/* Sensors information*/
Number Sensor_CPUTemp "CPU Temperature" <temperature> { channel="systeminfo:computer:work:sensors#cpuTemp" }
Number Sensor_CPUVoltage "CPU Voltage" <energy> { channel="systeminfo:computer:work:sensors#cpuVoltage" }
Number Sensor_FanSpeed "Fan speed" <fan> { channel="systeminfo:computer:work:sensors#fanSpeed" }
/* Process information*/
Number Process_load "Load" <none> { channel="systeminfo:computer:work:process#load" }
Number Process_used "Used" <none> { channel="systeminfo:computer:work:process#used" }
String Process_name "Name" <none> { channel="systeminfo:computer:work:process#name" }
Number Process_threads "Threads" <none> { channel="systeminfo:computer:work:process#threads" }
String Process_path "Path" <none> { channel="systeminfo:computer:work:process#path" }
Sitemap:
sitemap systeminfo label="Systeminfo" {
Frame label="Network Information" {
Default item=Network_AdapterName
Default item=Network_Name
Default item=Network_IP
Default item=Network_Mac
Default item=Network_DataSent
Default item=Network_DataReceived
Default item=Network_PacketsSent
Default item=Network_PacketsReceived
}
Frame label="CPU Information" {
Default item=CPU_Name
Default item=CPU_Description
Default item=CPU_Load1
Default item=CPU_Load5
Default item=CPU_Load15
Default item=CPU_Threads
Default item=CPU_Uptime
}
Frame label="Drive Information" {
Default item=Drive_Name
Default item=Drive_Model
Default item=Drive_Serial
}
Frame label="Storage Information" {
Default item=Storage_Name
Default item=Storage_Type
Default item=Storage_Description
Default item=Storage_Available
Default item=Storage_Used
Default item=Storage_Total
Default item=Storage_Available_Percent
Default item=Storage_Used_Percent
}
Frame label="Memory Information" {
Default item=Memory_Available
Default item=Memory_Used
Default item=Memory_Total
Default item=Memory_Available_Percent
Default item=Memory_Used_Percent
}
Frame label="Swap Memory Information" {
Default item=Swap_Available
Default item=Swap_Used
Default item=Swap_Total
Default item=Swap_Available_Percent
Default item=Swap_Used_Percent
}
Frame label="Battery, Display and Sensor Information" {
Default item=Battery_Name
Default item=Battery_RemainingCapacity
Default item=Battery_RemainingTime
Default item=Display_Description
Default item=Sensor_CPUTemp
Default item=Sensor_CPUVoltage
Default item=Sensor_FanSpeed
}
Frame label="Process Information" {
Default item=Process_load
Default item=Process_used
Default item=Process_name
Default item=Process_threads
Default item=Process_path
}
}