Transcript DCN Open Interface Version 1.0 - Starin

DCN Next Generation Open Interface

Control a meeting using Open Interface
• Microphones
• Voting
• All room settings
Communications Systems
1
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Touchscreen Control
Activate Microphone

Touch panel and interface box + custom made software
Communications Systems
2
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Custom made SW for controlling DCN
Assigning applications
 Microphone control and mode
selection
 Voting control and showing results
 Activating Attendance Registration

Communications Systems
3
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Page for selecting DCN voting modes
Communications Systems
4
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Control equipment from AMX & Crestron


Communications Systems
5
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
www.amx.com
www.crestron.com
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
How to handle
Bosch Security Systems BV is not supplying touch screen equipment.
 Contact AMX or Crestron dealer locally.
 React proactive. Select the dealer which has experience and is dealer
for Bosch and AMX or Crestron.

Communications Systems
6
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Synoptic Panel Control
Communications Systems
7
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Remote Controller with Single CCU




Authorization Code for Open Interface (LBB4187) needed.
Register your CCU online together with the authorization code to get a license
key.
Connect PC to Port 1 of the CCU
• Baudrate 115200
• Protocol Full
Enter License key into the CCU using the Download and License Tool.
Download &
License
Tool
Communications Systems
8
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Remote Controller with Single CCU



Configure Port 1 of the CCU for Simple Protocol.
Connect Open Interface Device to Port 1 of the CCU
• Baudrate 115200
• Protocol Simple
Open Interface protocol ready for use.
Open Interface
Open Interface
Device
Communications Systems
9
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Open Interface Applications











(SC)
(SI)
(DB)
(MM)
(VT)
(AT)
(MD)
(IN)
(IC)
(LD)
(CC)
System Configuration
System Installation
Database
Microphone Management
Voting
Attendance Registration
Message Distribution
Simultaneous Interpretation
Intercom
Text Status Display
Camera Control
Communications Systems
10
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
System Structure
RS232
CCU
Open Interface
SC
SI
DB
MM
VT
IN
MD
AT
IC
LD
CC
ACN
Units
Communications Systems
11
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Communication

The communication between the CCU and the remote controller is
message based (remote functions and update notification).
Communications Systems
12
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Support & Information
DCN Open Interface (DOS) Tool
 Open Interface Documentation
• Protocol Description
• Open Interface Commands

Communications Systems
13
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
(CCU_DDTK.EXE)
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Open Interface Documentation

All information which is needed to make an Open Interface program is
described in the Open Interface Documentation.
Communications Systems
14
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
CCU_DDTK tool
DOS-based (also Windows DOS-Box)
 Uses Simple or Full protocol for communication
• Full has handshaking
• Simple no handshaking
 Definition file (fnid.def) with:
• Names
• Function number
• Input and/or output structures

Communications Systems
15
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
System setup Open Interface Training
DCN-CCU
Central Control Unit
RS-232
DDTK
PC
Chairman Unit
ID 1
Del. without
LCD
ID 2
Communications Systems
16
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
Del. with LCD
ID 3
Del. with LCD
& CR
ID 4
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Hands On

Install the DDTK Toolkit
• CCU_DDTK -PS -S1:19200
- Note : FNID.def file and CCU_DDTK.exe should be in the same
folder.
Communications Systems
17
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 1

System Configuration
Collect System configuration
• Use Open Interface document for SC-commands and
parameters explanation
• Use following commands:
- SC_C_START_APP
- SC_C_GET_CCU_VERSIONINFO
- SC_C_GET_CCU_CONFIG
Communications Systems
18
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 2

System Configuration
Fill DB with your name residing on a unit
• Check it with MM Speakers info on LCD.
• Use following commands to fill Database with one record:
- DB_C_START_APP
- DB_C_MAINT_CCU_DB1 1 1 3 1 1 0 0 3 1 1 1 1 1 “Test”
Communications Systems
19
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 3

System Configuration
Add your neighbor to another unit and do not give him voting
authorization
• Check by running a voting round
• Use Following commands:
- DB_C_CCU_APPLY_ONE 1 1 3 1 2 0 0 4 1 1 1 0 1
- DB_C_STOP_APP
- SC_C_STOP_APP
Communications Systems
20
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 4

System Installation
Try behavior of SI functions :
• SC_C_START_APP
• SI_C_START_INSTALL 1
• SI_C_SELECT_UNIT 1 1 (turns Unit 1 on)
• SI_C_SELECT_UNIT 2 1 (turns Unit 2 on)
• SI_C_SELECT_UNIT 2 0 (turns Unit 2 off)
• SI_C_STOP_INSTALL
• SC_C_STOP_APP
Communications Systems
21
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 5

Microphone Management
Start MM on DDTK and check behavior Remote controller
• Turn On/Off Microphone
• Add delegate to request list
• Change Max number of speakers
• Change Microphone mode to override
•
•
•
•
•
•
•
MM_C_START_MM
MM_C_SET_MICRO_ON_OFF 1 1
MM_C_SPK_APPEND 3
MM_C_RTS_APPEND 2 65535
MM_C_SET_ACTIVE_MICS 3
MM_C_SET_MIC_OPER_MODE 2
MM_C_STOP_MM
Communications Systems
22
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Practice 6

Voting
Prepare YES/NO voting
• End voting time = 10 seconds
• Flashing secret response
• Use present key for presence
• No Notifications
• Results not Compressed
• Show result on stop voting
Communications Systems
23
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Suggestion

VT_C_START_APP 0 0 10

Preparation:
• VT_C_SET_GLOBAL_SETTINGS 2 1 0 0 0 0 1 0 0 0
• VT_C_SET_VOTINGPARAMS 1 2 0 0 1
• VT_C_DOWNLOAD_SUBJECT 234 “Voting Test” “Mymotion”

Execution:
• VT_C_START_VOTING
• VT_C_HOLD_VOTING
• VT_C_GET_RESULTS
• VT_C_RESTART_VOTING
• VT_C_STOP_VOTING 1
• VT_C_GET_RESULTS
• VT_C_STOP_APP
Communications Systems
24
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header

Message
Header and Checksum are protocol dependent!
Communications Systems
25
Checksum
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Simple Protocol VS Full Protocol
Simple Protocol
 Checksum over messages
 No acknowledgement
 No retransmissions
 No line checking
• Controller can check use SC_C_CHECK_LINK function
Full Protocol
 Line checking
• Starts after first message
 Checksum over messages
 Acknowledge of message reception
 Retransmissions on failures

We will use Simple Protocol in this training!
Communications Systems
26
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header
ESC

$
Checksum
CR
The header has a fixed length and forms a leader to recognize the startpoint of a message
• ESC value = 0x1B
• ‘$‘ value
= 0x24
• CR value = 0x0D
Communications Systems
27
Message
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header
Type Length

Checksum
Data
Currently the following types are defined for communication with the CCU:
• MDSM_REMOTEPROCEDURE_REQ
: Always transmitted to the CCU.
• MDSM_REMOTEPROCEDURE_RSP
: Respons back from the CCU
• MDSM_NOTIFY
: Notification from the CCU
Communications Systems
28
Message
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header
Type Length
Checksum
Data

Defines the actual length of the data present in the array following.

Only this amount of data of the ‘byData’ array is transmitted.
Communications Systems
29
Message
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header
Type Length

Checksum
Data
The actual function (+ if necessary some parameters) or notification
which has to be sent or received.
Communications Systems
30
Message
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Protocol Layout
Header
Message
Checksum
Checksum Byte

The Checksum is calculated using the following sequence:
• Sum all bytes over the header and the message.
• Take modulo 256 of the calculated checksum and do a bitwise invert
of the checksum.

This calculated checksum is sent along with the packet. The receiver
executes the same calculation and verifies the calculated checksum
with the received checksum.
Communications Systems
31
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Packing a request message
Header
Message
Chk
Checksum
Calculation
ESC
$
CR 03 04 00 30 00 1C 00 60
Type
28
Length
MM_C_SPK_APPEND
Communications Systems
32
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
1b
hex
24
0d
03
04
00
30
00
1c
00
==
09F
9F
Inverse  60
Unpacking a response message
Header
Message
Chk
03 04 00 30 00 00 00 params
Type
Error code
Length
MM_C_SPK_APPEND
Communications Systems
33
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.
Unpacking a notification
Header
Message
Chk
05 04 00 0E 00 1C 00
Type
Length
MM_C_SPK_APPEND_ON_PC 28
Communications Systems
34
ST/PRM3-EU | 14.Mar.07
DCNNG Open Interface
DCN Next Gen
| © Robert Bosch GmbH reserves all rights even in the event of industrial property rights. We reserve all rights of
disposal such as copying and passing on to third parties.