Manufacturer:
Type:
Protocoll:
Devicename:
Model_nr:
Version_nr:
Version_info:
Version_timestamp
Release:
ID
Min_mygekko_version:
Function_type:
Progress_state:

Description (HTML)

<p>With this DDF, you can integrate employee absence data from <strong> Microsoft Shifts / Teams </strong> into the <strong> ROOM CONTROL </strong> system. By determining presence times and applying configurable arrival and departure lead times, the system provides <strong> predictive room climate control </strong> based on actual occupancy.</p>
<p>A DEVICE element named <strong> "Info" </strong> is used for status displays. The team name is entered there; the associated TeamID is retrieved automatically.</p>
<p>Each person is represented by a DEVICE group <strong> "User" </strong> . The person's name is entered there, and their regular <strong> presence times </strong> are specified under <strong> Parameters </strong> for each weekday. The associated UserID is retrieved automatically when changed. Enter unique abbreviations in the Device Station for the Slave list. Link <strong> HVAC NOW </strong> to the room control (Buttons/Contacts &gt; Contact of Presence) either directly or using a Memory.</p>
<p><strong> Notes: </strong></p>
<ul>
<li>Maximum of <strong> 31 people </strong></li>
<li>Manual configuration required &mdash; <strong> not plug-and-play </strong></li>
<li>No overnight shifts and no overnight HVAC/heating intervals are supported</li>
<li><strong> All entries </strong> , except shared shifts, are interpreted as <strong> absences </strong></li>
<li>Only one shift entry per day is supported</li>
<li>Only one contiguous HVAC interval will be calculated</li>
<li>This DDF is provided as-is and may need further improvement</li>
<li>Today's shift entries (02:00&ndash;22:00) are updated automatically every <strong> hour </strong> , or can be queried manually via a command in Info</li>
</ul>
<p><strong> Regular Present: </strong> True if the current time is between the start and end of the defined regular presence time.</p>
<p><strong> Present: </strong> True if <strong> Regular Present </strong> AND there is <strong> no </strong> current <strong> absence entry</strong>.</p>
<p>Shows absence shifts entered for today for each person (for example: "Vacation from &hellip; to &hellip;").</p>
<p>The <strong> presence range </strong> is taken from the shift entry <strong> [S] </strong> if a shift has a duration between the <strong> "Full-day Absence" parameter (e.g., 6 h) </strong> and 11 hours.</p>
<p><strong>no</strong> HVAC if</p>
<ul>
<li><strong>NO_REG_PRES: </strong> No presence interval</li>
<li><strong>INV_REG_PRES:&nbsp;</strong>Invalid presence interval (P_START &gt;= P_END)</li>
<li><strong> ABS_COV_PRES: </strong> Absence covers whole presence</li>
<li><strong>LEAD_IS_LONGER:</strong> Leadtime Error (HVAC_START &gt;= HVAC_END)</li>
</ul>
<p>Using a <a href="https://devicelib.my-gekko.com/list.php?device_type=0&id_dv=426&id_pr=13" target="_blank"> dedicated DDF for rooms </a> , the presence states of persons are assigned via IO inputs. The overall presence state of the room is then derived from these inputs.&nbsp;Alternatively, in the System LOGICS, the HVAC signals of persons can be combined using <strong> OR </strong> blocks to determine the HVAC signal of a room with multiple occupants.</p>
<div id="gtx-trans" style="position: absolute; left: -10px; top: 371px;">&nbsp;</div>

Note

from

*2025-12-11 16:06:21 (do) ******************************
several changes
*2025-12-26 15:02:14 (do) ******************************
Last Commit: 829ace3d | 2025-12-26 15:01:23

Document
MS_Shifts_Screenshots_and_Timeline.pdf

Device Images

Detail view (400x400px)MS_Shifts.jpg

Tile view (200x200px)calender.jpg

Download SignedFile: Microsoft.Gateway.REST-API (DDF).Shifts.1(0x0D00007700020100).csvRevision/Date: 829ace3d 2025-12-26 15:01:23Ref: master

INDEX	ALIAS	NAME	UNIT
0	USER_NAME	User Name	Firstname Lastname
1	USER_ID	User ID	xxxxxxxx-xxxx-Uxxx-Vxxx-xxxxxxxxxxxx
2	TEAM_NAME	Team Name
3	TEAM_ID	Team ID	xxxxxxxx-xxxx-Uxxx-Vxxx-xxxxxxxxxxxx
5	SHIFTS_COUNT	Shifts Count
6	START_DATETIME	Start DateTime	YYYY-MM-DDTHH:MM:SS.sssssss
7	END_DATETIME	End DateTime	YYYY-MM-DDTHH:MM:SS.sssssss
8	THEME	Theme
9	NOTES	Notes
10	ABSENCE_SHIFT	Absence Shift
20	OUT_REGULAR_PRESENT	OUT Regular Present	1 = Regular Present Now
21	OUT_PRESENT	OUT Present	1 = Present Now
22	OUT_HVAC	OUT HVAC	1 = HVAC Now
25	OUT_STATE	OUT State	0 = Away, 1 = Here, 2 = HVAC, 3 = Here and HVAC
28	FULL_DAY_ABSENCE	Full Day Absence	h
30	REGULAR_PRESENCE_TODAY	Regular Presence Today	HH:MM - HH:MM
31	REGULAR_PRESENCE_MON	Regular Presence Mon	HH:MM-HH:MM
32	REGULAR_PRESENCE_TUE	Regular Presence Tue	HH:MM-HH:MM
33	REGULAR_PRESENCE_WED	Regular Presence Wed	HH:MM-HH:MM
34	REGULAR_PRESENCE_THU	Regular Presence Thu	HH:MM-HH:MM
35	REGULAR_PRESENCE_FRI	Regular Presence Fri	HH:MM-HH:MM
36	REGULAR_PRESENCE_SAT	Regular Presence Sat	HH:MM-HH:MM
37	REGULAR_PRESENCE_SUN	Regular Presence Sun	HH:MM-HH:MM
38	LEAD_ARRIVE	Lead Arrive	h
39	LEAD_DEPARTURE	Lead Departure	h
40	ABSENCE_TIME_RANGE	Absence Time Range	HH:MM - HH:MM
41	HVAC_TIME_RANGE	HVAC Time Range	HH:MM - HH:MM
160	CMD_TOKEN_NOW	Command Token Now
161	CMD_VERBOSE	Command Verbose
162	CMD_SHIFT_NOW	Command Shift Now
180	TIMER_TOKEN_REFRESH	Timer Token Refresh	s
181	TIMER_SHIFT_REFRESH	Timer Shift Refresh	s
182	TIMER_ID_REFRESH	Timer ID Refresh	s
183	TIMER_PRESENCE_CALC	Timer Precence Calc	s
195	STATION_CONFIG_DONE	Station Config Done	1 = config done
200	QUALITY	Quality
201	QUALITY_GETTOKEN	Quality GETTOKEN
202	QUALITY_GETTEAMID	Quality GETTEAMID
203	QUALITY_GETSHIFTS	Quality GETSHIFTS
204	QUALITY_GETUSERID	Quality GETUSERID
208	NO_ERROR_USER	No Error User
210	ERROR_MESSAGE	Error Message
220	REGULAR_PRESENT_NOW_TREND	Regular Present Now Trend
221	PRESENT_NOW_TREND	Present Now Trend
222	HVAC_NOW_TREND	HVAC Now Trend