FastPack Protocol (31172)
FastPack Protocol (31172)
Disclaimer
This document contains information that is the proprietary and confidential property of INNCOM International Inc. By
acceptance hereof, each recipient agrees to use the information contained herein only for the purpose anticipated by
INNCOM, and not to disclose to others, copy or reproduce, any part hereof without the written consent of INNCOM. The
recipient agrees to return this document to INNCOM immediately upon request.
Table of Content
INTRODUCTION..................................................................................................................................................................................................................... 3
Honeywell Internal
Monday, January 14, 2019 Page |2
7. DOCUMENT INFORMATION......................................................................................................................................................................................... 11
Honeywell Internal
Monday, January 14, 2019 Page |3
Header
set to 0 and ignore upon
2.1. Data Types reception.
USHORT DestinationID. For point-to-point
Note: All multi-byte values are encoded big- links, set to 0 and ignore upon
endian. reception.
ULONG RequestID. For point-to-point
Data Type Description links, set to 0 and ignore upon
BYTE 8-bit unsigned char reception.
USHORT 16-bit unsigned char xxx Data field 1
ULONG 32-bit unsigned char xxx Data field 2
Data
Honeywell Internal
Monday, January 14, 2019 Page |4
Honeywell Internal
Monday, January 14, 2019 Page |5
4.8. Tag 0xFF82: HVAC User Interface Update 4.11. Tag 0xFF8C: Tunnel Room
(Not supported)
Tunnel a data packet from the INNCOM server towards
This is handled by Attribute Update (Tag 0xFF81) the FPS gateway in the room. For the NAT information,
for HVAC UI. the INNCOM server will include the information that it
learned from the data packets in reverse direction.
This event is pushed by the INNCOM server to the third
party host on change and about every 10 minutes for the The BLOB[] fields contains RoomID etc… but does not
purpose of synchronization. have to have a published layout as art of the FastPack
definition.
Data Type Description of Data Section
USHORT RoomID (1..65535) Data Type Description of Data Section
BYTE User selected display unit. SBA NAT information.
0=Fahrenheit, 1=Celsius BLOB[] Tunneled data
USHORT User selected target temperature,
clipped and rounded as per thermostat
display. Number is multiplied by 10. 4.12. Tag 0xFFA0: Asynchronous Room Update
Examples:71.5°F = 715; 21.5°C = 215. This event is pushed by the INNCOM server to the third
BYTE Manual fan speed (applicable for AC party host on changes to alarm/event conditions.
mode fixed fan). 0=off, 1=low,
2=medium, 3=high. Data Type Description of Data Section
BYTE AC-mode. 0=off, 1=fan only, 2=fan USHORT RoomID (1..65535)
fixed, 3=auto BYTE Alarm flags:
4.9. Tag 0xFF83: Guestroom Controls 0x01: Undefined
0x02: Value has changed
The third party host can control aspects of the guestroom 0x04: Undefined
with this command. Examples are toggling the DND 0x08: Undefined
state, changing temperature, etc. A listing of commands 0x10: Undefined
that are available are created in partner-specific 0x20: Undefined
documents provided by INNCOM. 0x40: Undefined
0x80: Undefined
Data Type Description of Data Section USHORT Alarm/Event code. For alarm and event
USHORT RoomID (1..65535) codes, see respective chapter.
BYTE Device address. Set to 0 for general USHORT Parameter 1
commands. USHORT Parameter 2
ULONG Flags. Set to 0. USHORT Parameter 3
USHORT Command Code (see separate USHORT Parameter 4
document).
TIMESTAMP Date/time when alarm condition became
USHORT Param0 active.
USHORT Param1 TIMESTAMP Date/time when alarm condition was
STR String Parameter acknowledged.
STR Name of the person/system that has
4.10. Tag 0xFF8B: Tunnel Server taken on the responsibility to handle the
alarm condition.
Tunnel a data packet from the FPS gateway in the room
to the INNCOM server. The routing network (e.g. third
party server infrastructure) will have to include NAT 4.13. Tag 0xFFA3: Synchronization Request
information so that the tunnel can be operated in reverse Send by the third party host to the INNCOM server to
direction as well. request the synchronization of information.
The BLOB[] fields contains RoomID etc… but does not
Data Type Description of Data Section
have to have a published layout as art of the FastPack
USHORT Set value of this parameter to 0xFFFF
definition.
for a full synchronization. To receive the
Data Type Description of Data Section next block of information during
SBA NAT information. synchronization, insert the value as
BLOB[] Tunneled data provided by the tag 0xFFAC (end
synchronization).
Honeywell Internal
Monday, January 14, 2019 Page |6
Honeywell Internal
Monday, January 14, 2019 Page |7
5.2. Alarm 0xE001: Occupancy Update 5.8. Alarm 0xE007: Valet Call Update
5.3. Alarm 0xE002: DND Update 5.9. Alarm 0xE008: Comfort Status
Honeywell Internal
Monday, January 14, 2019 Page |8
Honeywell Internal
Monday, January 14, 2019 Page |9
Honeywell Internal
Monday, January 14, 2019 P a g e | 10
Honeywell Internal
Monday, January 14, 2019 P a g e | 11
7. Document Information
Author
Philipp Roosli, [email protected]
Michael Sobanko, [email protected]
File
Source:
N:\R&D\Doc\EngManuals\Protocols\FastPack\TCP-
IP\FastPack Protocol.doc
References
• UDP Control Protocol
History
2008/06/06 First draft based on UDP control protocol.
2008/06/06 Reviewed by John Clark. Added commands
for synchronization request and end.
2008/09/11 PHR/MDS – Added HVACUI update and
guestroom control capability.
2008/09/12 PHR Added raw alarm/event flag 0xFFA7.
2008/09/16 PHR Host SW Architecture.
2009/01/06 PHR Added 0xFF80, 0xFF81 commands.
2009/03/17 MDS Added USHORT Auxiliary Value to the
0xFF81. Marked HVAC UI Update 0xFF82 not supported.
2015/04/03 MDS Added 0xFF7A and 0xFF7B for the
Light Output State reporting.
2016/01/05 MDS Added DataType HVAC UI State for
the 0xE010 event update.
2017/05/23 MDS Added Guestroom Communication
Status message 0xFF77.
2018/01/11 MDS Added Attribut Update (2) message
0xFF7F as it was somehow deleted from the document.
Honeywell Internal