This page is part of archived documentation for openHAB 4.1. Go to the current stable version
# MCD Binding
This binding allows you to send sensor events from your openHAB environment to the cloud application Managing Care Digital (MCD) by C&S Computer und Software GmbH (opens new window).
MCD is the platform for inpatient and outpatient nursing services. Our REST API allows you to send a variety of sensor events to the system and thus being able to connect your Ambient Assisted Living (AAL) or smart home environment to the documentation software of your nursing service.
Please note that a valid account is needed to access MCD and the Sensor API.
# Supported Things
There are two supported things: MCD Bridge and MCD Sensor Thing.
# Discovery
Discovery is not supported.
# Thing Configuration
This section shows the configuration parameters of both supported things.
# MCD Bridge
The MCD Bridge (mcdBridge) needs to be configured with your valid C&S MCD / sync API credentials.
| parameter | description |
|---|---|
| userEmail | Email of account |
| userPassword | valid password for the given email |
# MCD Sensor Thing
Each sensor thing (mcdSensor) needs to be configured with the identical serial number, that is assigned to this sensor in MCD.
| parameter | description |
|---|---|
| serialNumber | serial number of the sensor in MCD |
# Channels
The mcdSensor thing supports the following channels. To see the sensors' events, please visit Managing Care Digital (opens new window) and navigate to the dashboard.
| channel | type | description |
|---|---|---|
| lastEvent | String | shows the last event that was sent with date and time |
| sendEvent | String | stateless channel for sending events to the API, see list below for valid commands |
The channel sendEvent accepts valid Sensor Event Definitions as well as the corresponding ID.
The following table contains all currently accepted Sensor Event Definitions that can be passed as String type commands.
As soon as new events are added to the API, you can use their ID, even if the Definition is not yet added to this list.
For more information about the API, you can have a look at the C&S Sync API (opens new window).
| Valid String Type Commands |
|---|
| BEDEXIT |
| BEDENTRY |
| FALL |
| CHANGEPOSITION |
| BATTERYSTATE |
| INACTIVITY |
| ALARM |
| OPEN |
| CLOSE |
| ON |
| OFF |
| ACTIVITY |
| CAPACITY |
| GAS |
| VITALVALUE |
| ROOMEXIT |
| ROOMENTRY |
| REMOVESENSOR |
| SITDOWN |
| STANDUP |
| INACTIVITYROOM |
| SMOKEALARM |
| HEAT |
| COLD |
| QUALITYAIR |
| ALARMAIR |
| ROOMTEMPERATURE |
| HUMIDITY |
| AIRPRESSURE |
| CO2 |
| INDEXUV |
| WEARTIME |
| FIRSTURINE |
| NEWDIAPER |
| DIAPERREMOVED |
| NOCONNECTION |
| LOWBATTERY |
| CONTROLLSENSOR |
| LYING |
| SPILLED |
| DAMAGED |
| GEOEXIT |
| GEOENTRY |
| WALKING |
| RESTING |
| TURNAROUND |
| HOMEEMERGENCY |
| TOILETFLUSH |
| DORSALPOSITION |
| ABDOMINALPOSITION |
| LYINGLEFT |
| LYINGRIGHT |
| LYINGHALFLEFT |
| LYINGHALFRIGHT |
| MOVEMENT |
| PRESENCE |
| NUMBERPERSONS |
| BRIGHTNESSZONE |
# Full Example
Here is an example for the textual configuration. You can of course use the Administration section of the GUI as well.
demo.things:
Bridge mcd:mcdBridge:exampleBridge [userEmail="[email protected]", userPassword="your.password"]{
Thing mcd:mcdSensor:examlpeSensor [serialNumber="123"]
Thing mcd:mcdSensor:secondExamlpeSensor [serialNumber="456"]
}
demo.items:
String lastValue "Last Value" {channel="mcd:mcdSensor:examlpeSensor:lastValue"}
String sendEvent "Send Event" {channel="mcd:mcdSensor:examlpeSensor:sendEvent"}
demo.sitemap:
Text item=sendEvent
Text item=lastValue