Home

Application Programming Interface (API) Manual

1. Description Get list of all CON devices input including ID and namefFirst Index of CON device from which the list scan will start Example Get all CONs Ox1B 0x5B 0x68 0x07 0x00 0x00 0x00 Response Telegram ESC h Size Count Next List 1 List Count Description Count Number of items in the CPU list Next Index of the next CPU if the list of CPU devices exceeds the telegram size Contains O if there are no more CPU devices Example Return list of CONs 0x1B 0x5D 0x68 0x21 0x00 0x01 0x00 0x00 0x00 OxB8 0Ox0B 0x00 0x00 0x43 0x4F 0x4E 0x5F 0x56 0x69 0x64 0x65 0x6F 0x31 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Page 60 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 17 Get User List Request Telegram ESC i Size First Description Get list of all users First Index of the user from whom the list scan will start Example Get all users 0x1B 0x5B 0x69 0x07 0x00 0x00 0x00 Response Telegram ESC i Size Count Next List 1 List Count Description Count Number of items in the user list Next Index of the next user if the list of users exceeds the telegram size Contains O if there are no more users Example Return list of users 0x1B Ox5D 0x69 0x21 0x00 0x01 0x00 0x00 0x00 0x01 0x00 0x00 0x00 0x61 0x64 Ox6D 0x69 Ox6E 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x0
2. Page 92 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 15 Get CPU List Request Telegram ESC g Size First General Description Get list of all CPU devices output including ID and name First Index of CPU device from which the list scan will start Table 7 24 Get list of all CPU devices output Type Bytes Description Hex Coding ESC 1 Control character Ox1B 1 Server identification OX5B g 1 Command 0x67 Size 2 Total length of telegram 7 bytes 0x07 0x00 e g 1000 0xE9 0x03 First 2 Index of first CPU 0 all 0x00 0x00 Example Get all CPUs Ox1B 0x5B 0x67 0x07 0x00 0x00 0x00 Response Telegram ESC g Size Count Next List 1 List Count General Description Count Number of items in the CPU list Next Index of the next CPU if the list of CPU devices exceeds the telegram size Contains 0 if there are no more CPU devices 724 746 5500 blackbox com Page 93 ACX048 API manual Chapter 7 Specifications Type ESC Table 7 25 Get list of all CPU devices output response Bytes 1 Description Hex Coding Ox1B Control character Size 1 1 Command OX5D Server identification 0x67 Total length of telegram Count Number of CPUs e g 33 0x21 0x00 e g 1 0x01 0x00 Next ID of first CPU in next list ID of CPU device e g O 0x00 0x00 no further CPU e g 1000
3. Ox1B 0x5B 0x62 0x0B 0x00 OxF4 0x03 0xC9 Ox0B 0x02 0x00 Disconnect Ox1B Ox5B 0x62 0x0B 0x00 OxF4 0x03 0x00 0x00 0x02 0x00 6 4 4 USB 2 0 Access Establishing a USB 2 0 Data Connection To set a USB 2 0 connection based on devices that only consist of USB 2 0 standalone extenders you have to split the required bidirectional switching into two steps 1 Set CPU device Cpuld 1012 connection to CON device ConId 3017 Ox1B 0x5B 0x49 0x09 0x00 OxC9 Ox0B OxF4 0x03 2 Set CON device ConId 3017 connection to CPU device CpuId 1012 0x1B 0x5B 0x4D 0x09 0x00 OxF4 0x03 0xC9 Ox0B Page 70 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation Switching from a device within an existing connection to another device requires closing the current connection at first The disconnect has to be performed in two steps 1 Disconnect CPU device CpuId 1012 from CON device ConId 3017 Ox1B Ox5B 0x49 0x09 0x00 OxC9 Ox0B 0x00 0x00 2 Disconnect CON device ConId 3017 from CPU device CpuId 1012 Ox1B 0x5B 0x4D 0x09 0x00 OxF4 0x03 0x00 0x00 NOTE After disconnecting the existing connection a switching break of 1 2 seconds is strongly recommended until the next switching operation should be executed 724 746 5500 blackbox com Page 71 ACX048 API manual Chapter 7 Specifications 7 Specifications The DKM FX can be controlled via RS 232 serial interface or TCP IP socket Port 5555 T
4. Chapter 7 Specifications Example Set CON device ConId 3017 connection to CPU device CpuId 1012 Ox1B 0x5B 0x4D 0x09 0x00 OxF4 0x03 0xC9 Ox0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 7 2 8 Get CON Devices Connected to CPU Devices Request Telegram ESC N Size CpuCnt Cpuld 1 Cpuld CpuCnt General Description Get CON devices input connected to CPU devices output For CpuCnt 0 all CPU devices will be returned Table 7 15 Get CON devices input connected to CPU devices output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B N 1 Command Ox4E Size 2 Total length of telegram 7 Bytes data oo Ox0D 0x00 CpuCnt 2 ID of CPU device e g 3 0x03 0x00 Cpuld 2 ID of CON device e g 1012 OxF4 0x03 Example Get CON devices connected to CPU devices CpuId 1012 1013 1020 Ox1B Ox5B 0x4E 0x0D 0x00 0x03 0x00 OxF4 0x03 OxF5 0x03 OxFC 0x03 724 746 5500 blackbox com Page 83 ACX048 API manual Chapter 7 Specifications Response Telegram ESC N Size CpuCnt lt Cpuld ConId gt 1 lt Cpuld ConId gt CpuCnt General Description Return CON devices input connected to CPU devices output Returns a list of pairs of Could Conld Table 7 16 Return CON devices input connected to CPU devices output Type Bytes Description Hex Coding ESC 1 Control charac
5. Number Component 1 1 0 ports 1 16 CATx 2 1 0 ports 49 64 CATx 3 1 0 ports 17 32 CATx 4 1 0 ports 65 80 CATx 5 1 0 ports 33 48 CATx 6 Serial connection RJ 45 Network connection RJ 45 Figure 3 26 Back view ACXC80 Table 3 28 ACXC80 back panel components Number 1 2 3 Component Power supply unit 1 Power supply unit 2 Grounding 724 746 5500 blackbox com Chapter 3 Overview 3 6 16 ServSwitch DKM FX Compact 80 Port Fiber ACXC80F Ee E Eim manm A Figure 3 27 Front view ACXC80OF Table 3 29 ACXC80F components Number Component 1 1 0 ports 1 16 SFP 2 1 0 ports 49 64 SFP 3 1 0 ports 17 32 SFP 4 1 0 ports 65 80 SFP 5 1 0 ports 33 48 SFP 6 Serial connection RJ 45 7 Network connection RJ 45 Figure 3 28 Back view ACXC80 Table 3 30 ACXC80 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding Page 30 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 17 ServSwitch DKM FX Compact 48 CATx Ports 16 Fiber Ports ACXC48F16 o m Maen eee GRERGRER BAER RA AAA A hd o IU O a 3 ge e e Figure 3 29 Front view ACXC48F16 Table 3 31 ACXC48F16 components Number Component 1 1 0 ports 1 16 CATx 2 1 0 po
6. Response Telegram ESC T Size RConId VConId General Description Return virtual CON device of a real CON device 724 746 5500 blackbox com Page 99 ACX048 API manual Chapter 7 Specifications Table 7 25 Return virtual CON device of a real CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5D an 1 Command 0x54 Size 2 Total length of telegram 9 bytes 0x09 0x00 RConld 2 ID of real CON device e g 3017 0xC9 0x0B VConld 2 1D of virtual CON device e g 4034 0xC2 OxOF Return virtual CON device VConId 3017 Ox1B Ox5B 0x54 0x09 0x00 OxC9 Ox0B OxC2 OxOF or lt NAK gt Page 100 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 3 2 Set Virtual CON Device to a Real CON Device Request Telegram ESC U Size RConId VConId General Description Set virtual CON device to a real CON device Table 7 26 Set virtual CON device to a real CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B U 1 Command 0x55 Size 2 Total length of telegram 9 bytes 0x09 0x00 RConld 2 ID of real CON device e g 3017 0xC9 0x0B VConld 2 1D of virtual CON device e g 4034 0xC2 OxOF Example Set virtual CON device VConId 4034 to a real CON device RConId 3017 Ox1B Ox5B 0x48 0x09 0x00 OxC9 Ox0B 0xC2 0Ox0F Response lt ACK gt lt ECHO
7. 7 2 11 Set Connection of CON Devices to CPU Devices Bidirectional Request Telegram ESC Q Size Cnt lt Cpuld Conld gt 1 lt Cpuld ConId gt Cnt General Description Set connection of CON devices input to CPU devices output and CPU devices input to CON devices output Data of CON device USB audio will be transmitted to CPU device Data of CPU device video USB audio will be transmitted to CON device Table 7 19 Set connection of CON devices to CPU devices bidirectional Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B Q 1 Command 0x51 Size 2 Total length of telegram 7 bytes data 0x09 0x00 Cnt 2 Size of list Sae ae Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 0xC9 Ox0B Connect CONs with CPUs and CPUs with CONS Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 Cpuld 3 1020 ConId 3 3040 Ox1B Ox5B 0x51 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 Ox0B OxF5 0x03 OxD4 Ox0B OxFC 0x03 Ox0E 0x0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 87 ACX048 API manual Chapter 7 Specifications 7 2 12 Get All Connections for CON and CPU Devices Request Telegram General Description Get all CPU device CON device connections Table 7 20 Get all CPU device CON device connections Type B
8. Chapter 6 Operation 6 2 12 Get All Connections Request Telegram Description Get all CPU device CON device connections Example Get all CPU device CON device connections Ox1B 0x5B 0x52 Response Telegram ESC R Size CpuCnt ConCnt lt Cpuld ConId gt 1 lt Cpuld ConId gt CpuCnt lt Conld Cpuld gt 1 lt Conld Cpuld gt ConCnt Description Return all CPU device CON device connections in pairs For each defined CPU device the Conld of the connected CON device will be added or O if the CPU device is disconnected For each defined CON device the Cpuld of the connected CPU device will be added or 0 if the CON device is disconnected CpuCnt Number of CPU devices ConCnt Number of CON devices lt Cpuld Conld gt List of IDs CpulD ConID lt Cpuld Conld gt List of IDs ConID CpulD 724 746 5500 blackbox com Page 55 ACX048 API manual Chapter 6 Operation Example Return all CPU device CON device connections in pairs Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 Conld 2 3028 Cpuld 3 1020 ConId 3 3040 ConId 1 3017 Cpuld 1 1012 ConId 2 3028 Cpuld 2 0 0x1B 0x5D 0x52 0x15 0x00 0x03 0x00 0x02 0x00 OxF4 0x03 0xC9 0x0B OxF5 0x03 0xD4 0x0B OxFC 0x03 Ox0E 0x0B 0xC9 Ox0B 0xF4 0x03 0xD4 0x0B 0x00 0x00 Page 56 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 13 Set Connection for All CON Devices and
9. Data of CPU device video USB audio is transmitted to a CON device Cpuld ID of CPU device Conld ID of CON device Mode Connection Mode 0 full access 1 video only 2 private mode Example Set CON device connection to CPU device and CPU device connection to CON device Cpuld 1012 ConId 3017 Mode private mode 0x1B 0x5B 0x62 0x0B 0x00 OxF4 0x03 0xC9 Ox0B 0x02 0x00 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 58 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 15 Get CPU List Request Telegram ESC g Size First Description Get list of all CPU devices output including ID and name First Index of CPU device from which the list scan will start Example Get all CPUs Ox1B 0x5B 0x67 0x07 0x00 0x00 0x00 Response Telegram ESC g Size Count Next List 1 List Count Description Count Number of items in the CPU list Next Index of the next CPU if the list of CPU devices exceeds the telegram size Contains O if there are no more CPU devices Example Return list of CPUs Ox1B 0x5D 0x67 0x21 0x00 0x01 0x00 0x00 0x00 OxE8 0x03 0x00 0x00 0x43 0x50 0x55 0x5F 0x56 0x69 0x64 0x65 0x6F 0x31 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 724 746 5500 blackbox com Page 59 ACX048 API manual Chapter 6 Operation 6 2 16 Get CON List Request ESC h Size First
10. Black Box Tech Support FREE Live 24 7 Tech support the way it should be Great tech support is just 60 seconds away at 724 746 5500 or blackbox com BLACK BOX About Black Box Black Box provides an extensive range of networking and infrastructure products You ll find everything from cabinets and racks and power and surge protection products to media converters and Ethernet switches all supported by free live 24 7 Tech support available in 60 seconds or less Copyright 2014 Black Box Corporation All rights reserved ACX048 API manual version 2 724 746 5500 blackbox com
11. RCA Cinch A non standardized plug connection for transmission of electrical audio and video signals especially with coaxial cables SFP SFPs Small Form Factor Pluggable are pluggable interface modules for Gigabit connections SFP modules are available for CATx and fiber interconnect cables S PDIF A digital audio interconnect that is used in consumer audio equipment over relatively short distances Single Head A system with one video connection Single Link A DVI D interface for resolutions up to 1920x1200 by signal transmission of up to 165 Mpixel s 24 bit Alternative frequencies are Full HD 1080p 2K HD 2048x1080 and 2048x1152 Single mode 91 single mode fiber cable S Video Y C The S Video Y C is a video format transmitting luminance and chrominance signals separately Thereby it has a higher quality standard than CVBS TOSLINK Standardized fiber connection system for digital transmission of audio signals FO5 plug connection Triple Head A system with three video connections USB HID USB HID USB Human Interface Devices allow for data input There is no need for a special driver during installation New USB HID device found is reported 724 746 5500 blackbox com Page 115 ACX048 API manual Chapter 10 Glossary Typical HID devices include keyboards mice graphics tablets and touchscreens Storage video and audio devices are not HID VGA Video Graphics Array VGA is a compute
12. Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 67 ACX048 API manual Chapter 6 Operation 6 3 7 Get Real CPU Devices Request Telegram ESC Z Size CpuCnt VCpulId 1 VCpuld CpuCnt Description Get real CPU devices of virtual CPU devices For CpuCnt 0 all virtual CPU devices with assignments to virtual CPU devices will be returned CpuCnt Number of CPU device VCpuld List of IDs of virtual CPU devices Example Get real CPU devices of virtual CPU devices VCpuld 2018 2030 2035 Ox1B 0x5B Ox5A 0x0D 0x00 0x03 0x00 0xE2 0x07 OxEE 0x07 OxF3 0x07 Response Telegram ESC Z Size CpuCnt lt VCpuld RCpuld gt 1 lt VCpuld RCpuld gt CpuCnt Description Return real CPU devices of virtual CPU devices as pairs CpuCnt Number of CPU devices lt VCpuld RCpuld gt List of pairs of VCpuld and RCpuld Page 68 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation Example Return real CPU devices of virtual CPU devices as pairs VCpuld 1 2018 RCpuld 1 1012 VCpuld 2 2030 RCpuld 2 1013 VCpuld 3 2035 RCpuld 3 1020 0x1B 0x5D Ox5A 0x13 0x00 0x03 0x00 OxE2 0x07 OxF4 0x03 OxEE 0x07 OxF5 0x03 OxF3 0x07 OxFC 0x03 6 3 8 Set Real CPU Devices Request Telegram ESC a Size CpuCnt lt VCpuld RCpuld gt 1 lt VCpuld
13. Return system time Saturday 15 27 48 28 01 2012 Ox1B 0x29 0x53 0x0C 0x00 0x48 0x27 0x15 0x06 0x28 0x01 0x12 6 2 Switch Commands 6 2 1 Switch Off All Ports Request Switch off all ports Switch off all ports 0x1B 0x5B 0x41 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 44 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 2 Get CPU Device Connected to CON Device Request Telegram ESC H Size Conld Description Get CPU device input connected to CON device output Conld ID of CON device Example Get CPU device connected to CON device ConId 3017 0x1B Ox5B 0x48 0x07 0x00 0xC9 0Ox0B Response Telegram ESC H Size Conld Cpuld Description Return CPU device input connected to CON device output Conld ID of CON device Cpuld ID of CPU device Example Return CPU device Cpuld 1012 connected to CON device ConId 3017 0x1B 0x5D 0x48 0x09 0x00 0xC9 Ox0B OxF3 0x03 or lt NAK gt 724 746 5500 blackbox com Page 45 ACX048 API manual Chapter 6 Operation 6 2 3 Set CPU Device Connection to CON Device Request Telegram ESC I Size ConId Cpuld Description Set CPU device connection input to CON device output Input data of CPU device Video USB Audio will be transmitted to CON device Conld ID of CON devi
14. 2 3 4 5 Figure 3 2 System overview exemplary Table 3 3 System components Number Component 1 DKM FX matrix 2 Serial connection cable DB9 or DB9 to RJ 45 adapter cable 3 External serial control RS 232 Option 1 4 Network connection cable CATx 5 External serial control TCP IP Option 2 3 5 Product Range Table 3 4 Available products Number Description DKM FX and DKM FXC API ACX API DKM FX matrix application programming interface API Page 14 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 Device Views In Sections 3 6 1 through 3 6 4 Figures 2 2 through 2 5 illustrate the ServSwitch DKM FX chassis models Tables 3 5 through 3 8 describe their components NOTE The following images of the chassis are fully populated with I O cards and are intended to be example diagrams The chassis do not come with any 1 0 cards You need to purchase the I O cards separately 3 6 1 ServSwitch DKM FX 48 Port ACX048 Figure 3 3 Front view ACX048 Table 3 5 ACX048 components Number Component 1 Slot for fan tray 2 Slot for Power Supply Unit 1 3 Slot for I O Boards 1 6 4 Se or Ranar Suaa Unit 2 5 i Slot for CPU board 6 Slot for air filter A 7 Slot for Fan Tray 2 724 746 5500 blackbox com Page 15 ACX048 API manual Chapter 3 Overview 3 6 2 ServSwitch DKM FX 80 Port ACX080 Figure 3 4 Fron
15. 7 2 14 Set Extended Connection oooccccocccccconnccconnnncnonnnncconnnccninnnnos 92 7215 Get CPU Ubica tata 93 L216 Get CON Misc daa 95 AA ae e a a E aeei 97 T3 AMEN S siapa E A 99 7 3 1 Get Virtual CON Device cooooccccnnoncccnnonnccnonnnnononancccnnnocininnnnos 99 7 3 2 Set Virtual CON Device to a Real CON Device 101 7 3 3 Get Real CPU Device oocococccoccccconocccccnoncccnononononanccccnnnccininos 102 7 3 4 Set Real CPU to a Virtual CPU ereere 104 7 3 5 Get Virtual CON Devices siressa innnan 105 7 3 6 Set Virtual CON Devices to Real CON Devices 107 7 3 7 Get Real CPU DEV CE sssrinin ania 108 73 8 Set Real CPW Devices cuca adi 110 LA Connector PINOS arrived 111 Page 8 724 746 5500 blackbox com ACX048 API manual Table of Contents 8 MOUDIESHOOTING siii ati eE 112 8 1 Network Error cio atacada 112 8 2 Failure at the Matrix cccccccccccceeeecceeeeseeceeeceeceeteeseeeeaeeaeseteeterets 112 9 Technical Support eee eceeceeceeeeeceeeeeeeceeeeeeeeeeseeeeeeeseteeeteeeeeeeeeeteseeeneees 113 A E erage espera este cee cate cee etait 114 724 746 5500 blackbox com Page 9 ACX048 API manual Chapter 1 About this Manual 1 About This Manual 1 1 Scope This manual describes how to install your DKM FX API how to operate it and how to perform troubleshooting 1 2 Validity This manual is valid for all devices listed on the front page The product code is printed on the
16. FX Compact 48 Port ACXC48 O Oj Ah hhh h h a a h h oM VR NE gg gg G A E 1 Figure 3 17 Front view ACXC48 Table 3 19 ACXC48 front panel components Number Component 1 1 0 ports 1 16 CATx 2 1 0 ports 17 32 CATx 3 1 0 ports 33 48 CATx 4 Serial connection RJ 45 5 Network connection RJ 45 Figure 3 18 Back view ACXC48 Table 3 20 ACXC48 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding 724 746 5500 blackbox com Page 25 ACX048 API manual Chapter 3 Overview 3 6 12 ServSwitch DKM FX Compact 48 Port Fiber ACXC48F sol ooliotall mi E 1 2 3 45 O Bel JA Figure 3 19 Front view ACXC48F Table 3 21 ACXC48F front panel components Number Component 1 1 0 ports 1 16 SFP 2 1 0 ports 17 32 SFP 3 1 0 ports 33 48 SFP 4 Serial connection RJ 45 5 Network connection RJ 45 Figure 3 20 Back view ACXC48F Table 3 22 ACXC48 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding Page 26 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 13 ServSwitch DKM FX Compact 64 Port AAAA AAAA E ot Aff ca es A 3 REE age GUI Gg gg Gg gg ge ge i 1 2 3 4 56 Fi
17. OxE8 0x03 0x00 0x00 e g CPU_Video1 0x43 Name 20 Name of CPU 0x50 0x55 Ox5F 0x56 0x69 0x64 0x65 0x5F 0x31 Example Return list of CPUs 0x1B 0x5D 0x67 0x21 0x00 0x01 0x00 0x00 0x00 0xE8 0x03 0x00 0x00 0x43 0x50 0x55 Ox5F 0x56 0x69 0x64 0x65 0x6F 0x31 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Page 94 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 16 Get CON List Request Telegram ESC h Size First General Description Get list of all CON devices input including ID and name First Index of CON device from which the list scan will start Table 7 26 Get CON List Type Bytes Description Hex Coding ESC 1 Control character Ox1B 1 Server identification OX5B h 1 Command 0x68 Size 2 Total length of telegram 7 bytes 0x07 0x00 First 2 Index of first CPU E 9 OU OES OX0E O all 0x00 0x00 Example Get all CPUs Ox1B 0x5B 0x68 0x07 0x00 0x00 0x00 Response Telegram ESC h Size Count Next List 1 List Count General Description Count Number of items in the CON list Next Index of the next CON if the list of CON devices exceeds the telegram size Contains O if there are no more CON devices 724 746 5500 blackbox com Page 95 ACX048 API manual Chapter 7 Specifications Type Bytes ESC 1 g 1 Size 2 Count 2 Next 2 Id 4 Name 20 Example Ret
18. Port ACXC48 25 3 6 12 ServSwitch DKM FX Compact 48 Port Fiber ACXC48P 26 3 6 13 ServSwitch DKM FX Compact 64 Port ACXC64 27 3 6 14 ServSwitch DKM FX Compact 80 Port Fiber ACXC64P 28 3 6 15 ServSwitch DKM FX Compact 80 Port ACXC8O0 29 3 6 16 ServSwitch DKM FX Compact 80 Port Fiber ACXC8OF 30 3 6 17 ServSwitch DKM FX Compact 48 CATx Ports 16 Fiber Ports ACXCA8BFTO ocooccocccoccccccconconnononnccnnonoranonaninono 31 3 6 18 ServSwitch DKM FX Compact 48 CATx Ports 32 Fiber Ports ACXC48F32 cooooocooccccioccocconoonoononnoonconconnnnnono 32 3 7 Status LEDS iii a 33 4 Instala ati oil ati 35 4 1 How to Get DOCUMENTATION sessies 35 AZ SYSTEM SOU i tases stdanes iatavictanetbeed E AT 35 Page 6 724 746 5500 blackbox com ACX048 API manual Table of Contents 5 COMU ION cres ld tai 36 51 General Remark cuidad 36 5 2 DKM FX or DKM FX Compact Configuration oooooiccnoncnnomc 36 5 2 1 System Dala A narrar rca 36 5 2 2 NW Oe 38 5 3 COMMUNICATION SltUPD ocoocnnnninnicocinaconanco nono nono nono iaia cnica 41 BA Telegram StruclUEccceacocii cdt ica librnbs 42 54I A TT 42 Bid 2 RESPONSE aiii 42 55 Constan Genen a a N 42 6 OPTION eii ln idea 43 AS ASA an E 43 6 2 SWITCH COMMANA S ceca lacada dida caida 44 6 2 1 Switch Off All Ports oo cece cee cceeccesesesssecsstecsseesnresenies 44 6 2 2 Get CPU Device Connected to CON Device 45 6 2 3 Set CPU Dev
19. as an echo via LAN interface activated Enable NOTE This function should be enabled when using a media control via LAN Echo TCP IP connection deactivated Function not active default Page 36 724 746 5500 blackbox com ACX048 API manual Chapter 5 Configuration OSD Select Configuration gt System in the main menu NOTE The serial interface can be blocked while the OSD is open STAN Standard Figure 5 2 Menu Configuration System You can select between the following buttons Table 5 2 Button functions Number Component Cancel Reject changes Save Save changes 724 746 5500 blackbox com Page 37 ACX048 API manual Chapter 5 Configuration Java Tool Select System gt System Data in the main menu Esa Got yaa Esas 2 Dai O xD 44 22 Ba y a System System Data Figure 5 3 Menu System System Data 5 2 2 Network The DKM FX API relevant network configuration is set in this menu You can access the menu via OSD or Java Figure 5 4 OSD and Java icons Page 38 724 746 5500 blackbox com ACX048 API manual Chapter 5 Configuration You can select between the following DKM FX API relevant settings Field Selection activated DHCP deactivated IP address Byte Subnet mask ie Gateway Byte Tech activated Support deactivated activated FTP server deactivated Table 5 3 API relevant settings Description The network settings are automatical
20. returned ConCnt Number of CON devices RConld List of IDs of real CON devices Example Get virtual CON devices of a real CON devices RConId 3017 3028 3040 Ox1B 0x5B 0x58 0x0D 0x00 0x03 0x00 0xC9 Ox0B 0xD4 0x0B OxEO 0x0B Response Telegram ESC X Size ConCnt lt RConId VConId gt 1 lt RConId VConId gt ConCnt Description Return virtual CON devices of real CON devices as pairs ConCnt Number of CON devices lt RConld VConld gt List of Pairs of RConld and VConld Page 66 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation Example Return virtual CON devices of real CON devices as pairs RConID 1 3017 VConID 1 4034 RConID 2 3028 VConID 2 4042 RConID 3 3040 VConID 3 4045 0x1B 0x5D 0x58 0x13 0x00 0xC9 Ox0B 0xC2 0Ox0F 0xD4 0x0B OxCA Ox0F OxEO 0x0B 0xCD 0x0F 6 3 6 Set Virtual CON Devices to Real CON Devices Request Telegram ESC Y Size ConCnt lt RConId VConId gt 1 lt RConId VConId gt ConCnt Description Set virtual CON devices to real CON devices ConCnt Number of CON devices lt RConld VConld gt List of Pairs of RConld and VConld Example Set virtual CON devices to real CON devices RConld 1 3017 VConId 1 4034 RConId 2 3028 VConId 2 4042 RConId 3 3040 VConId 3 4045 Ox1B 0x5B 0x59 0x13 0x00 0xC9 Ox0B 0xC2 Ox0F 0xD4 0x0B OxCA Ox0F OxEO 0Ox0B 0xCD 0x0F
21. 0 0x00 0x00 0x00 0x00 724 746 5500 blackbox com Page 61 ACX048 API manual Chapter 6 Operation 6 3 Assignments 6 3 1 Get Virtual CON Device Request Telegram ESC T Size RConId Description Get virtual CON device of a real CON device RConld ID of real CON Example Get virtual CON device of a real CON device RConld 3017 0x1B 0x5B 0x54 0x07 0x00 0xC9 0x0B Response Telegram ESC T Size RConId VConId Description Return virtual CON device of a real CON device RConld ID of real CON device VConld ID of virtual CON device Example Return virtual CON device VConId 4034 of a real CON device RConId 3017 Ox1B 0x5B 0x54 0x09 0x00 0xC9 Ox0B 0xC2 0x0F or lt NAK gt Page 62 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 3 2 Set Virtual CON Device to a Real CON Device Request Telegram ESC U Size RConId VConId Description Set virtual CON device to a real CON device RConld ID of real CON device VConld ID of virtual CON device Example Set virtual CON device VConId 4034 to a real CON device RConId 3017 0x1B Ox5B 0x55 0x09 0x00 OxC9 0x0B OxC2 Ox0F Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 63 ACX048 API manual Chapter 6 Operation 6 3 3 Get Real CPU Device Request Telegram ESC V Size Vcpul
22. 028 CpuId 2 0 Ox1B 0x5B 0x53 0x15 0x00 0x03 0x00 0x02 0x00 OxF4 0x03 OxC9 Ox0B OxF5 0x03 0xD4 Ox0B OxFC 0x03 Ox0E Ox0B 0xC9 OxOB OxF4 0x03 0xD4 Ox0B 0x00 0x00 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 91 ACX048 API manual Chapter 7 Specifications 7 2 14 Set Extended Connection Request Telegram ESC b Size Cpuld ConId Mode General Description Set CON device input connection to CPU device output and CPU device input connection to CON device output Data of CON device USB audio is transmitted to a CPU device Data of CPU device video USB audio is transmitted to a CON device Table 7 23 Set a connection for all defined CON devices and CPU devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B b 1 Command 0x62 Size 2 Total length of telegram Ox0B 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 0xC9 0x0B Connection mode 0 full access DO Mode 2 A 1 0x01 0x00 1 video Only 2 0x02 0x00 2 private mode Example Set CON device connection to CPU device and CPU device connection to CON device CpuId 1012 ConId 3017 Mode private mode Ox1B Ox5B 0x62 Ox0B 0x00 OxF4 0x03 0xC9 Ox0B 0x02 0x00 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements
23. 0xC9 Ox0B Example Return virtual CON devices of a real CON devices as pairs RConId 3017 3028 3040 Ox1B 0x5B 0x58 0x0D 0x00 0x03 0x00 OxC9 Ox0B 0xD4 0x0B OxEO Ox0B Response Telegram ESC X Size ConCnt lt RConId VConld gt 1 lt RConId VConId gt ConCnt General Description Return virtual CON devices of a real CON devices as pairs 724 746 5500 blackbox com Page 105 ACX048 API manual Chapter 7 Specifications Table 7 31 Return virtual CON devices of a real CON device as pairs Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification 0X5D X 1 Command 0x58 e g for ConCnt 3 Size 2 Total length of telegram 7 bytes data 0x13 0x00 Conld 2 Number of CON device e g 3 0x03 0x00 RConld 2 1D of real CON device e g 3017 0xC9 Ox0B VConld 2 ID of virtual CON device e g 4034 0xC2 OxOF Example Returns virtual CON of a real CON as pairs RConID 1 3017 VConID 1 4034 RConID 2 3028 VConID 2 4042 RConID 3 3040 VConID 3 4045 Ox1B 0x5D 0x58 0x13 0x00 0xC9 Ox0B OxC2 0x0F 0xD4 0x0B OxCA Ox0F OxXEO Ox0B OxCD Ox0F Page 106 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 3 6 Set Virtual CON Devices to Real CON Devices Request Telegram ESC Y Size ConCnt lt RConId VConId gt 1 lt RConId VConId gt ConCnt General Description Set virtual CON devices to real CON devic
24. 1 Example Switch off all ports Ox1B 0x5B 0x41 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 75 ACX048 API manual Chapter 7 Specifications 7 2 2 Get CPU Device Connected to CON Device Request Telegram ESC H Size Conld General Description Get CPU device input connected to CON device output Table 7 6 Get system time Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification 0x28 S il Command 0x53 Size 2 Total length of telegram 7 bytes 0x07 0x00 ConID 2 ID of Con Device e g 3017 0xC9 0x08 Example Get CPU device connected to CON device ConId 3017 Ox1B Ox5B 0x48 0x07 0x00 OxC9 0x0B Response Telegram ESC H Size Conld Cpuld General Description General description Return CPU device input connected to CON device output Page 76 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Table 7 7 Return CPU device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification Ox5D H 1 Command 0x48 Size 2 Total length of telegram 9 bytes 0x09 0x00 ConID 2 ID of Con device e g 3017 OxC9 0x0B CpulD 2 ID of CPU device e g 1025 0x16 0x04 Return CPU device CpuId 1012 connected to CON device ConId 3017 0x1B 0x5D 0x48 0x09 0x00 0xC9 0x0B OxF3 0x03 7 2 3 Set CPU De
25. 45 3 Network connection RJ 45 Figure 3 12 Back view ACXC16F Table 3 14 ACXC16F back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding Page 22 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 9 ServSwitch DKM FX Compact 32 Port ACXC32 O o AAA MARA ARAAARAA CA MERE GE DU E E GE GE A DE py Figure 3 13 Front view ACXC32 Table 3 15 ACXC32 components Number Component 1 1 0 ports 1 16 CATx 2 1 0 ports 17 32 CATx 3 Serial connection RJ 45 4 Network connection RJ 45 Figure 3 14 Back view ACXC32 Table 3 16 ACXC32 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding 724 746 5500 blackbox com Page 23 ACX048 API manual Chapter 3 Overview 3 6 10 ServSwitch DKM FX Compact 32 Port Fiber ACXC32F O Figure 3 15 Front view ACXC32F Table 3 17 ACXC32F components Number Component 1 1 0 ports 1 16 SFP 2 1 0 ports 17 32 SFP 3 Serial connection RJ 45 4 Network connection RJ 45 Figure 3 16 Back view ACXC32F Table 3 18 ACXC32F back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding Page 24 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 11 ServSwitch DKM
26. 5 Set Connections of CPU Devices to CON Devices Request Telegram ESC K Size ConCnt lt ConId Cpuld gt 1 lt Conld Cpuld gt ConCnt Description Set connections of CPU devices input to CON devices output Data of CPU video USB audio will be transmitted to CON device ConCnt Number of CON devices lt Conld Cpuld gt List of IDs ConID CpulD Example Example Set connections of CPU devices to CON devices Conld 1 3017 CpulId 1 1012 ConId 2 3028 Cpuld 2 3013 ConId 3 3040 Cpuld 3 1020 0x1B 0x5B 0x4B 0x13 0x00 0x03 0x00 0xC9 Ox0B OxF4 0x03 OxD4 0Ox0B OxF5 0x03 Ox0E 0Ox0B OxFC 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 48 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 6 Get CON Device Connected to CPU Device Request Telegram ESC L Size Cpuld Description Get CON device input connected to CPU device output Cpuld ID of CPU device Example Get CON device connected to CPU device CpuId 1012 Ox1B 0Ox5B 0x4C 0x07 0x00 OxF4 0x03 Response ESC L Size Cpuld Conld Description Return CON device input connected to CPU device output Cpuld ID of CPU device Conld ID of CON device Example Return CON device Conld 3017 connected to CPU device CpuId 1012 Ox1B 0x5D 0x4C 0x09 0x00 OxF4 0x03 0xC9 Ox0B or lt NAK gt 724
27. 746 5500 blackbox com Page 49 ACX048 API manual Chapter 6 Operation 6 2 7 Set CON Device Connection to CPU Device Request Telegram ESC M Size Cpuld Conld Description Set CON device input connection to CPU device output Input data of CON device USB Audio will be transmitted to CPU device Cpuld ID of CPU device Conld ID of CON device Example Set CON device ConId 3017 connection to CPU device CpuId 1012 0x1B 0x5B 0x4D 0x09 0x00 OxF4 0x03 0xC9 0x0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 50 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 8 Get CON Devices Connected to CPU Devices Request Telegram ESC N Size CpuCnt Cpuld 1 Cpuld CpuCnt Description Get CON devices input connected to CPU devices output For CpuCnt 0 all CPU devices will be returned CpuCnt Number of CPU devices Cpuld List of CpulDs Example Get CON devices connected to CPU devices CpuId 1012 1013 1020 0x1B 0x5B 0x4E 0x0D 0x00 0x03 0x00 OxF4 0x03 0xF5 0x03 OxFC 0x03 Response Telegram ESC N Size CpuCnt lt Cpuld ConId gt 1 lt Cpuld Conld gt CpuCnt Description Return CON devices input connected to CPU devices output Return a list of pairs of Cpuld Conld CpuCnt Number of CPU devices lt Cpuld Conld gt List of IDs CpulD ConID Example Return CON de
28. ACX048 ACXC8 ACXC32 ACXC64 ACXC48F16 lt SBLACK BOX ACX080 ACXC8F ACXC32F ACXC64F ACXC48F32 ACX160 ACXC16 ACXC48 ACXC80 ACX288 ACXC16F ACXC48F ACXC80F Application Programming Interface API Mani Customer Order toll free in the U S Call 877 877 BBOX outside U S call 724 746 5500 Support FREE technical support 24 hours a day 7 days a week Call 724 746 5500 or fax Information 724 746 0746 Mailing address Black Box Corporation 1000 Park Drive Lawrence PA 15055 1018 Web site www blackbox com E mail info blackbox com Trademarks Used in this Manual Trademarks Used in this Manual Black Box and the Double Diamond logo are registered trademarks of BB Technologies Inc TOSLINK is a registered trademark of Kabushiki Kaisha Toshiba dba Toshiba Corporation Any other trademarks mentioned in this manual are acknowledged to be the property of the trademark owners Disclaimer Black Box Network Services shall not be liable for damages of any kind including but not limited to punitive consequential or cost of cover damages resulting from any errors in the product information or specifications set forth in this document and Black Box Network Services may revise this document at any time without notice Page 2 724 746 5500 blackbox com ACX048 API manual FCC and IC RFI Statements and NOM Statement FEDERAL COMMUNICATIONS COMMISSION AND INDUSTRY CANADA RADIO FREQUENCY INTERFERENCE STATEMENTS This equipmen
29. ACXC8 components Number Component 1 1 0 ports 1 8 CATx 2 Serial connection RJ 45 3 Network connection RJ 45 4 Connect to power supply 5 Connect to a 5 VDC power supply redundancy optional 724 746 5500 blackbox com Page 19 ACX048 API manual Chapter 3 Overview 3 6 6 ServSwitch DKM FX Compact 8 Port SFP ACXC8F O CELL o E B 23 4 5 Figure 3 8 Front view ACXC8F Table 3 10 ACXC8F components Number Component 1 1 0 ports 1 8 SFP 2 Serial connection RJ 45 3 Network connection RJ 45 4 Connect to power supply 5 Connect to a 5 VDC power supply redundancy optional Page 20 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 7 ServSwitch DKM FX Compact 16 Port ACXC16 o AAA A AAA o LIG IE GR E GE DR gt Figure 3 9 Front view ACXC16 Table 3 11 ACXC16 components Number Component 1 1 0 ports 1 16 CATx 2 Serial connection RJ 45 3 Network connection RJ 45 Figure 3 10 Back view ACXC16 Table 3 12 ACXC16 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding 724 746 5500 blackbox com Page 21 ACX048 API manual Chapter 3 Overview 3 6 8 ServSwitch DKM FX Compact 16 Port Fiber ACXC16F o Mo a Figure 3 11 Front view ACXC16F Table 3 13 ACXC16F components Number Component 1 1 0 ports 1 16 SFP 2 Serial connection RJ
30. CPU Devices Request Telegram ESC S Size CpuCnt ConCnt lt Cpuld ConId gt 1 lt Cpuld ConId gt CpuCnt lt Conld Cpuld gt 1 lt Conld Cpuld gt ConCnt Description Set a connection for all defined CON devices and CPU devices For each defined CPU device add the Conld or O if the CPU device is disconnected For each defined CON device add the Cpuld or O if the CON device is disconnected CpuCnt Number of CPU devices ConCnt Number of CON devices lt Cpuld Conld gt List of IDs CpulD ConID lt Cpuld Conld gt List of IDs ConID CpulD Example Set a connection for all defined CON devices and CPU devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 Conld 2 3028 1020 ConId 3 3040 ConId 1 3017 CpulId 1 1012 Cpuld 3 ConId 2 3028 Cpuld 2 0 0x1B 0x5B 0x53 0x15 0x00 0x03 0x00 0x02 0x00 OxF4 0x03 OxC9 0x0B OxF5 0x03 0xD4 0x0B OxFC 0x03 Ox0E 0x0B 0xC9 Ox0B OxF4 0x03 0xD4 0x0B 0x00 0x00 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 57 ACX048 API manual Chapter 6 Operation 6 2 14 Set Extended Connection Request Telegram ESC b Size Cpuld ConId Mode Description Set CON device input connection to CPU device output and CPU device input connection to CON device output Data of CON device USB audio is transmitted to a CPU device
31. General Description Get system time Table 7 3 Get system time Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification 0x28 S 1 Command 0x53 Example Get system time Ox1B 0x28 0x53 724 746 5500 blackbox com Page 73 ACX048 API manual Chapter 7 Specifications Response Telegram ESC S Size Seconds Minutes Hours Day Date Month Year LL General Description Return system time Table 7 4 Get system time Type Bytes Description Hex Coding ESC 1 Control character Ox1B 1 Server identification 0x28 1 Command 0x53 Size 2 Total length of telegram 12 bytes Ox0C 0x00 Seconds 1 Seconds 0 59 0x00 0x59 Minutes 1 Minutes 0 59 0x00 0x59 Hours 1 Hours 0 23 0x00 0x23 Day 1 Day 1 7 Monday 1 0x01 0x07 Date 1 Date 1 31 0x01 0x31 Month 1 Month 1 12 0x01 0x12 Year 1 Year 2000 e g 2012 0x12 Example Return system time Saturday 15 27 48 28 01 2012 Ox1B 0x29 0x53 0Ox0C 0x00 0x48 0x27 0x15 0x06 0x28 0x01 0x12 NOTE The system is encoded in the BCD format Page 74 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 Switch Commands 7 2 1 Switch Off All Ports Request Telegram General Description Switch off all ports Table 7 5 Switch off all ports Type Bytes Description Hex Coding ESC 1 Control character Ox1B 1 Server identification Ox5B 8 1 Command 0x4
32. Id Description Get real CPU device of a virtual CPU device VCpuld ID of virtual CPU device Example Get real CPU device of a virtual CPU device VCpuId 2018 Ox1B 0x5B 0x56 0x07 0x00 OxE2 0x07 Response Telegram ESC V Size VCpuld RCpuld Description Return real CPU device of a virtual CPU device VCpuld ID of virtual CPU device RCpuld ID of real CPU device Example Return real CPU device RCpuId 1012 of a virtual CPU device VCpuld 2018 0x1B 0x5D 0x56 0x09 0x00 OxE2 0x07 OxF4 0x03 or lt NAK gt Page 64 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 3 4 Set Real CPU Device to a Virtual CPU Device Request Telegram ESC W Size VCpuld RCpuld Description Set real CPU device to a virtual CPU device VCpuld ID of virtual CPU device RCpuld ID of real CPU device Example Example Set real CPU device RCpuId 1012 toa virtual CPU device VCpuld 2018 Ox1B 0x5B 0x57 0x09 0x00 OxE2 0x07 OxF4 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 65 ACX048 API manual Chapter 6 Operation 6 3 5 Get Virtual CON Devices Request Telegram ESC X Size ConCnt RConId 1 RConId ConCnt Description Get virtual CON devices of a real CON devices For ConCnt 0 all real CON devices with assignments to virtual CON devices will be
33. ON device connected to CPU device CpuId 1012 Ox1B 0x5B 0x4C 0x07 0x00 OxF4 0x03 Response Telegram ESC L Size Cpuld Conld General Description Return CON device input connected to CPU device output 724 746 5500 blackbox com Page 81 ACX048 API manual Chapter 7 Specifications Table 7 13 Return CON device input connected to CPU device output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5D L 1 Command 0x4C Size 2 Total length of telegram 9 Bytes 0x09 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 OxC9 Ox0B Return CON device ConId 3017 connected to CPU device CpuId 1012 Ox1B 0x5D 0x4C 0x09 0x00 OxF4 0x03 0xC9 Ox0OB or lt NAK gt 7 2 7 Set CON Device Connection to CPU Device Request Telegram ESC M Size Cpuld Conld General Description Set CON device input connection to CPU device output Input data of CON device USB audio will be transmitted to CPU device Table 7 14 Set CON device input connected to CPU device output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B M 1 Command 0x4D Size 2 Total length of telegram 9 bytes 0x09 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld p ID of CON device e g 3017 OxC9 0x0B Page 82 724 746 5500 blackbox com ACX048 API manual
34. PU units CON units by interconnect cables or connected directly to the video devices where used as a video matrix The CPU units are connected directly to the sources computer CPU by the provided cables Monitor s keyboard and mouse are connected to the CON units The communication between the DKM FX matrix and the CPU units CON units takes place over the respective interconnect cables Page 12 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview Figure 3 1 shows the system overview Table 3 2 describes its components 2 3 4 Figure 3 1 System Overview Table 3 2 System components Number Component 1 Source computer CPU 2 CPU units 3 Interconnect cable 4 DKM FX matrix 5 CON units 6 Console monitor keyboard mouse 3 4 System Overview External Control A DKM FX matrix can be connected to an external serial control via the CPU board and its connectors The CPU board provides the possibility for both serial and TCP IP connections The serial connection to an external serial control is established by using a serial cable with DB9 connectors or a DB9 to RJ 45 adapter cable DKM FX Compact The TCP IP connection is established by using a CATx network cable 724 746 5500 blackbox com Page 13 ACX048 API manual Chapter 3 Overview Figure 3 2 shows the system overview external control Table 3 3 describes its components m 1
35. RCpuld gt CpuCnt Description Set real CPU devices to virtual CPU devices CpuCnt Number of CPU devices lt VCpuld RCpuld gt List of Pairs of VCpuld and RCpuld Example Set real CPU devices to virtual CPU devices VCpuld 1 2018 RCpuld 1 1012 VCpuld 2 2030 RCpuld 2 1013 VCpuld 3 2035 RCpuld 3 1020 0x1B 0x5B 0x61 0x13 0x00 0x03 0x00 OxE2 0x07 OxF4 0x03 OxEE 0x07 OxF5 0x03 OxF3 0x07 OxFC 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 69 ACX048 API manual Chapter 6 Operation 6 4 Best Practice This chapter provides an overview of the most commonly used switching commands and how they can be operated by using proven code examples of the external serial control 6 4 1 Full Access Establishing a KVM Connection Set CON device ConID 3017 connection to CPU device CpuId 1012 Ox1B 0x5B 0x50 0x09 0x00 OxF4 0x03 0xC9 0x0B Disconnect 0x1B 0x5B 0x50 0x09 0x00 OxF4 0x03 0x00 0x00 6 4 2 Video Access Establishing a Video Only Connection Set CPU device CpuId 1012 connection to CON device ConId 3017 0x1B 0x5B 0x49 0x09 0x00 0xC9 Ox0B OxF4 0x03 Disconnect 0x1B 0x5B 0x49 0x09 0x00 0xC9 Ox0B 0x00 0x00 6 4 3 Private Access Establishing an Exclusive KVM Session Set CON device connection to CPU device and CPU device connection to CON device Cpuld 1012 and Conld 3017
36. SB audio will be transmitted to CPU device Data of CPU device video USB audio will be transmitted to CON device Cpuld ID of CPU device Conld ID of CON device Example Set CON device ConID 3017 connection to CPU device CpuId 1012 0x1B 0x5B 0x50 0x09 0x00 OxF4 0x03 0xC9 0x0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 53 ACX048 API manual Chapter 6 Operation 6 2 11 Set Connection of CON Devices to CPU Devices Multiple Bidirectional Connections Full Access Request Telegram ESC Q Size Cnt lt Cpuld ConId gt 1 lt Cpuld Conld gt Cnt Description Set connection of CON devices input to CPU devices output and CPU devices input to CON devices output Data of CON device USB audio will be transmitted to CPU device Data of CPU device video USB audio will be transmitted to CON device Cnt Size of list lt Cpuld Conld gt List of IDs CpulD ConID Example Set connection of CON devices to CPU devices bidirectional Cpuld 1 1012 Conld 1 3017 Cpuld 2 1013 Conld 2 3028 Cpuld 3 1020 Conld 3 3040 Ox1B 0x5B 0x51 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 0x0B OxF5 0x03 0xD4 0x0B OxFC 0x03 0x0E 0Ox0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 54 724 746 5500 blackbox com ACX048 API manual
37. Set connections of CPU devices input to CON devices output Data of CPU video USB audio will be transmitted to CON device Table 7 11 Set connections of CPU devices to CON devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5D K 1 Command Ox4A eg for Conn 3 Size 2 Total length of telegram 7 Bytes data 0x13 0x00 ConCnt 2 Number of CON devices e g 3 0x03 0x00 Conld 2 ID of CON device e g 3017 0xC9 Ox0B Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Example Set connections of CPU devices to CON devices ConId 1 3017 Cpuld 1 1012 ConId 2 3028 Cpuld 21 3013 ConId 3 3040 CpulId 3 1020 Ox1B 0x5B 0x4B 0x13 0x00 0x03 0x00 OxC9 Ox0B OxF4 0x03 OxD4 Ox0B OxF5 0x03 Ox0E Ox0B OxFC 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 80 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 6 Get CON Device Connected to CPU Device Request Telegram ESC L Size Cpuld General Description Get CON device input connected to CPU device output Table 7 12 Get CON device connected to CPU device Type Bytes Description Hex Coding ESC l Control character 0x1B 1 Server identification 0X5B L 1 Command 0x4C Size 2 Total length of telegram 7 bytes 0x07 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Example Get C
38. U devices Table 7 35 Set real CPU devices to virtual CPU devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B a 1 Command 0x61 e g for CpuCnt 3 Size 2 Total length of telegram 7 bytes data 0x13 0x00 CpuCnt 2 Number of CPU device e g 3 0x03 0x00 VCpuld 2 ID of virtual CPU device e g 2018 OxE2 0x07 RCpuld 2 ID of real CPU device e g 1025 0x16 0x04 Example Set real CPU devices to virtual CPU devices VCpuld 1 2018 RCpuld 1 1012 VCpuld 2 2030 RCpuld 2 1013 VCpuld 3 2035 RCpuld 3 1020 Ox1B 0x5B 0x61 0x13 0x00 0x03 0x00 OxXE2 0x07 OxF4 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 110 724 746 5500 blackbox com ACX048 API manual 7 4 Connector Pinouts Chapter 7 Specifications Table 7 36 DB9 connector Picture Pin 1 AAA 5 2 Gee E 5 Signal Color Not connected 6 CTS 1 RTS 8 DSR E Signal DTR TXD RxD Not connected GND Table 7 37 RJ 45 connector Pin Signal Color 1 D1 5 D1 6 D2 7 Signal Not connected D2 Not connected Not connected Not connected 8 Table 7 38 RJ 45 connector serial Pin Signal Color Picture Biznisa 1 Picture Biss 1 1 DC D 5 DSR 6 RTS 7 Signal RxD TxD CTS DTR GND 8 ACX048 API manual 724 746 5500 blackbox com Page 111 Chapter 8 Troublesh
39. able 7 1 Telegram structure Type Bytes Description Control character 1 Always ESC 0x1B Server identification 1 Identification of service Command 1 A special command Size 2 Optional if telegram size is greater than 3 Data n Optional n bytes of data Byte Order Little Endian Example 1012 gt OxF4 0x03 not 0x03 OxF4 Special characters ACK 0x06 NAK 0x15 Request ESC lt Server identification gt lt Command gt lt Size gt lt Data gt Optional elements Response lt ACK gt lt ECHO gt or ESC lt Server identification gt lt Command gt lt Size gt lt Data gt Optional elements lt ECHO gt reports the matrix sequences solicited by a command and thus the new switching status of the matrix The echo can be used to update user appli cations and to operate several matrices in parallel Page 72 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Table 7 2 Sequence of a data communication DKM FX Matrix Control CPU Sending a command Acquiring a command processing a command blocking of further commands a Errors occurred lt NAK gt b No errors lt ACK gt c Optional lt ECHO gt d Optional Reply telegram with data a Repeat telegram b Next command c Receive and process the reply telegram NOTE The serial interface can be blocked while the OSD is open 7 1 System Requests Get System Time Request Telegram
40. al CPU devices e g 2018 OxE2 0x07 Example Get real CPU devices of virtual CPU devices VCpuld 2018 2030 2035 Ox1B Ox5B Ox5A Ox0D 0x00 0x03 0x00 OxE2 0x07 OxEE 0x07 OxF3 0x07 Response Telegram ESC Z Size CpuCnt lt VCpuld RCpuld gt 1 lt VCpuld RCpuld gt CpuCnt General Description Return real CPU devices of virtual CPU devices as pairs Page 108 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Table 7 34 Return real CPU devices of virtual CPU devices as pairs Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification 0X5D Z 1 Command Ox5A e g for CpuCnt 3 Size 2 Total length of telegram 7 bytes data 0x13 0x00 CpuCnt 2 Number of CPU devices e g 3 0x03 0x00 VCpuld 2 ID of virtual CPU device e g 2018 OxE2 0x07 RCpuld 2 ID of real CPU device e g 1012 OxF4 0x03 Example Return real CPU devices of virtual CPU devices as pairs VCpuld 1 2018 RCpuld 1 1012 VCpuld 2 2030 RCpuld 2 1013 VCpuld 3 2035 RCpuId 3 1020 Ox1B Ox5D Ox5A 0x13 0x00 0x03 0x00 OxE2 0x07 OxF4 0x03 OXEE 0x07 OxF5 0x03 OxF3 0x07 OxFC 0x03 724 746 5500 blackbox com Page 109 ACX048 API manual Chapter 7 Specifications 7 3 8 Set Real CPU Devices Request Telegram ESC a Size CpuCnt lt VCpuld RCpuld gt 1 lt VCpuld RCpuld gt CpuCnt General Description Set real CPU devices to virtual CP
41. andard DDC The Display Data Channel DDC is a serial communication interface between monitor and source computer CPU It allows a data exchange via monitor cable and an automatic installation and configuration of a monitor driver by the operating system Dual Access A system to operate a source computer CPU from two consoles Dual Head A system with two video connections Dual Link A DVI D interface for resolutions up to 2560x2048 by signal transmission of up to 330 Mpixel s 24 bit DVI Digital video standard introduced by the Digital Display Working Group http www ddwg org Single Link and Dual Link standard are distinguished The signals have TMDS level Page 114 724 746 5500 blackbox com ACX048 API manual Chapter 10 Glossary DVI I A combined signal digital and analog that allows running a VGA monitor at a DVI I port in contrast to DVI D see DVI EGA The Enhanced Graphics Adapter EGA is an old analog graphic standard introduced by IBM in 1984 A D Sub 9 connector is used for connection Fiber Single mode or multimode fiber cables KVM Keyboard video and mouse Mini XLR Industrial standard for electrical plug connections 3 pole for the transmission of digital audio and control signals Multimode 62 51 multimode fiber cable or 50u multimode fiber cable OSD The on screen display is used to display information or to operate a device Quad Head A system with four video connections
42. base of the devices 1 3 Cautions and Notes The following conventions are used in this manual WARNING or CAUTION This indicates an important operating instruction that should be followed to avoid any potential damage to hardware or property loss of data or personal injury NOTE This indicates important information to help you make the best use of this product Page 10 724 746 5500 blackbox com ACX048 API manual Chapter 2 Safety Instructions 2 Safety Instructions For reliable and safe long term operation of your DKM FX follow these guidelines Installation e Only use this device according to this User Manual Otherwise the safety can be affected e Only use in dry indoor environments e The DKM FX and the power supply units can get warm Don t put them in an enclosed space without any airflow e Do not obscure ventilation holes e Only use power supplies originally supplied with the product or manufacturer approved replacements Do not use a power supply if it appears to be defective or has a damaged case e Connect all power supplies to grounded outlets In each case make sure that the ground connection is maintained from the outlet socket to the power supply s AC power input e Do not connect the link interface to any other equipment particularly network or telecommunications equipment e Only connect devices to the serial interface that are sufficiently secured against short circuits and false vol
43. ce Cpuld ID of CPU device Example Set CPU device CpuId 1012 connection to CON device ConId 3017 Ox1B 0x5B 0x49 0x09 0x00 OxC9 0x0B OxF4 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 46 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 4 Get CPU Devices Connected to CON Devices Request Telegram ESC J Size ConCnt ConId 1 gt ConId ConCnt Description Get CPU devices input connected to CON device output For ConCnt 0 all CON devices will be returned ConCnt Number of CON devices Conld List of ConID Example Return CPU devices connected to CON devices ConId 3017 3028 3040 Ox1B 0x5B 0x4A 0x0D 0x00 0x03 0x00 0xC9 Ox0B 0xD4 0x0B OxEO 0x0B Response ESC J Size ConCnt lt ConId Cpuld gt 1 lt Conld Cpuld gt ConCnt Description Get CPU devices input connected to CON devices output Returns a list of pairs of Conld Cpuld ConCnt Number of CON devices lt Conld Cpuld gt List of IDs ConID CpulD Example Get CPU devices connected to CON devices Cpuld 1 1012 Conld 1 3017 Cpuld 2 1013 Conld 2 3028 Cpuld 3 1020 ConId 3 3040 Ox1B 0x5D 0x4A 0x13 0x00 0x03 0x00 0xC9 Ox0B 0xF4 0x03 OxD4 0x0B OxF5 0x03 0x0E Ox0B OxFC 0x03 724 746 5500 blackbox com Page 47 ACX048 API manual Chapter 6 Operation 6 2
44. e el aparato el ctrico sea operado 2 Las instrucciones de seguridad y operaci n deber n ser guardadas para referencia futura 3 Todas las advertencias en el aparato el ctrico y en sus instrucciones de operaci n deben ser respetadas 4 Todas las instrucciones de operaci n y uso deben ser seguidas 724 746 5500 blackbox com Page 3 ACX048 API manual NOM Statement 10 Ti 12 13 14 15 Page 4 724 746 5500 blackbox com Todas las instrucciones de operaci n y uso deben ser seguidas El aparato el ctrico no deber ser usado cerca del agua por ejemplo cerca de la tina de ba o lavabo s tano mojado o cerca de una alberca etc El aparato el ctrico debe ser usado nicamente con carritos o pedestales que sean recomendados por el fabricante El aparato el ctrico debe ser montado a la pared o al techo s lo como sea recomendado por el fabricante Servicio El usuario no debe intentar dar servicio al equipo el ctrico m s all lo descrito en las instrucciones de operaci n Todo otro servicio deber ser referido a personal de servicio calificado El aparato el ctrico debe ser situado de tal manera que su posici n no interfiera su uso La colocaci n del aparato el ctrico sobre una cama sof alfombra o superficie similar puede bloquea la ventilaci n no se debe colocar en libreros o gabinetes que impidan el flujo de aire por los orificios de ventilaci n El equipo el ct
45. ecifications 7 3 4 Set Real CPU to a Virtual CPU Request Telegram ESC W Size VCpuld RCpuld General Description Set real CPU device to a virtual CPU device Table 7 29 Set real CPU device to a virtual CPU device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B W 1 Command 0x57 Size 2 Total length of telegram 9 bytes 0x09 0x00 VCpuld 2 ID of virtual CPU device e g 2018 OxE2 0x07 RCpuld 2 ID of real CPU device e g 1012 OxF4 0x03 Set real CPU device RCpuId 1012 to a virtual CPU device VCpuId 2018 Ox1B 0x5B 0x57 0x09 0x00 OxXE2 0x07 OxF4 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 104 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 3 5 Get Virtual CON Devices Request Telegram ESC X Size ConCnt RConId 1 RConId ConCnt General Description Get virtual CON devices of a real CON device For ConCnt 0 all real CON devices with assignments to virtual CON devices will be returned Table 7 30 Get virtual CON devices of a real CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B x 1 Command 0x58 e g for ConCnt 3 Size 2 Total length of telegram 7 bytes data OxOD 0x00 Conld 2 Number of CON device e g 3 0x03 0x00 RConld 2 1D of real CON device e g 3017
46. es Table 7 32 Set virtual CON devices to real CON devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B Y 1 Command 0x59 Size 2 Total length of telegram 7 bytes data e g for ConCnt 3 0x13 0x00 ConCnt 2 Number of CON device e g 3 0x03 0x00 RConld 2 1D of real CON device e g 3017 0xC9 Ox0B VConld 2 1D of virtual CON device e g 4034 0xC2 OxOF Example Set virtual CON devices to real CON devices RConId 1 3017 VConId 1 4034 RConId 2 3028 VConId 2 4042 RConId 3 3040 VConId 3 4045 Ox1B 0x5B 0x59 0x13 0x00 OxC9 Ox0B 0xC2 Ox0F 0xD4 0x0B OxCA Ox0F OxXEO Ox0B OxCD Ox0F Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 107 ACX048 API manual Chapter 7 Specifications 7 3 7 Get Real CPU Device Request Telegram ESC Z Size CpuCnt VCpuld 1 VCpuld CpuCnt General Description Get real CPU devices of virtual CPU devices For CpuCnt 0 all virtual CPU devices with assignments to virtual CPU devices will be returned Table 7 33 Get real CPU devices of virtual CPU devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B Z 1 Command Ox5A e g for ConCnt 3 Size 2 Total length of telegram 7 bytes data OxOD 0x00 CpuCnt 2 Number of CPU devices e g 3 0x03 0x00 VCpuld 2 ID of virtu
47. esempe o o E El aparato ha sido tirado o su cubierta ha sido da ada 724 746 5500 blackbox com Page 5 ACX048 API manual Table of Contents Table of Contents Vs sADOUTTHIS Mii a 10 O 10 V2 e EE 10 1 3 Cautions and Notes oooconocccccnoncccnoonnconononcconnocononnnncnonnnnononnnccninnanos 10 2 Safety INStrUCTIONS oo eee ceec ccc eceee ete eeeeeeeeseeecaeeeeeseseceeeeeteseeesseetieeeesetetaees 11 3 OVEPVIOW rinda 12 eae e e 5s tenscey vets ap cathcanbaetedeadeapucsatiasiesatenathaatdanecsesaneatarai esarcae 12 3 2 ACCESS OPUOMS ura ida 12 3 3 Syster OVE EW sal 12 3 4 System Overview External Control iconos 13 35 Product RANGE tetona asadas lla dede 14 3 6 Device VIEWS ooooooocccooccccooonnconononcnnononcnnonnnnononnnnonnnnnnn conan cn conoci ninnnnss 15 3 6 1 ServSwitch DKM FX 48 Port ACX048 srn 15 3 6 2 ServSwitch DKM FX 80 Port ACXO80 oo cece ee eee eee 16 3 6 3 ServSwitch DKM FX 160 Port ACX160 eee eee e eee 17 3 6 4 ServSwitch DKM FX 288 Port ACX288 oo eee 18 3 6 5 ServSwitch DKM FX Compact 8 Port ACXC8 c eee 19 3 6 6 ServSwitch DKM FX Compact 8 Port Fiber ACXC8F 20 3 6 7 ServSwitch DKM FX Compact 16 Port ACXC16 21 3 6 8 ServSwitch DKM FX Compact 16 Port Fiber ACXC16F 22 3 6 9 ServSwitch DKM FX Compact 32 Port ACXC32 23 3 6 10 ServSwitch DKM FX Compact 32 Port Fiber ACXC32F 24 3 6 11 ServSwitch DKM FX Compact 48
48. gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 101 ACX048 API manual Chapter 7 Specifications 7 3 3 Get Real CPU Device Request Telegram ESC V Size VCpuld General Description Get real CPU device of a virtual CPU device Table 7 27 Get real CPU device of a virtual CPU device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B v 1 Command 0x56 Size 2 Total length of telegram 7 bytes 0x07 0x00 VCpuld 2 ID of virtual CPU device e g 2018 OxE2 0x07 Example Get real CPU device of a virtual CPU device VCpuId 2018 Ox1B 0x5B 0x56 0x07 0x00 OxE2 0x07 Response Telegram ESC V Size VCpuld RCpuld General Description Return real CPU device of a virtual CPU device Page 102 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Table 7 28 Get real CPU device of a virtual CPU device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5D v 1 Command 0x56 Size 2 Total length of telegram 9 bytes 0x09 0x00 VCpuld 2 ID of virtual CPU device e g 2018 0xE2 0x07 RCpuld 2 ID of real CPU device e g 1012 OxF4 0x03 Return real CPU device RCpuId 1012 of a virtual CPU device VCpuId 2018 Ox1B 0x5D 0x56 0x09 0x00 OxE2 0x07 OxF4 0x03 or lt NAK gt 724 746 5500 blackbox com Page 103 ACX048 API manual Chapter 7 Sp
49. gure 3 21 Front view ACXC64 Table 3 23 ACXC64 components Number Component 1 1 0 ports 1 16 CATx 2 1 0 ports 49 64 CATx 3 1 0 ports 17 32 CATx 4 1 0 ports 33 48 CATx 5 Serial connection RJ 45 6 Network connection RJ 45 Figure 3 22 Back view ACXC64 Table 3 24 ACXC64 back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding 724 746 5500 blackbox com Page 27 ACX048 API manual Chapter 3 Overview 3 6 14 ServSwitch DKM FX Compact 64 Port Fiber ACXC64F A e a aaaea AAA PA AAA Esp E o A A le eS Figure 3 23 Front view ACXC64F Table 3 25 ACXC64F components Number Component 1 1 0 ports 1 16 SFP 2 1 0 ports 49 64 SFP 3 1 0 ports 17 32 SFP 4 1 0 ports 33 48 SFP 5 Serial connection RJ 45 6 Network connection RJ 45 Figure 3 24 Back view ACXC64F Table 3 26 ACXC64F back panel components Number Component 1 Power supply unit 1 2 Power supply unit 2 3 Grounding Page 28 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 15 ServSwitch DKM FX Compact 80 Port ACXC80 AAAA ARA HI Te ARA AAA AAA APA AAA AAA 3 E E O JE LG Ng LL GA UU gt 5 67 4 Figure 3 25 Front view ACXC80 Table 3 27 ACXC80 components
50. he Service has to be activat ed See Chapter 2 6 4 Network Status and Chapter 4 4 5 Network in the DKM FX and DKM FX Compact manual for more information Java code example Create socket connection Socket socket new Socket 192 168 100 108 5555 final InputStream is socket getInputStream Switch off all ports Command ESC A final OutputStream os socket getOutputStream os write 0x1B ESC os write 0x5B os write 0x41 A os flush if is read 0x06 acknowledged is close os close socket close 724 746 5500 blackbox com Page 41 ACX048 API manual Chapter 5 Configuration Serial connection To establish the serial communication to the DKM FX set the format for serial data transmission to the following parameters 115 2K 8 1 NO 115 2 KBAUD 8 data bits 1 stop bit no parity 5 4 Telegram Structure 5 4 1 Request ESC lt Server identification gt lt Command gt lt Size gt lt Data gt Optional elements 5 4 2 Response lt ACK gt lt ECHO gt or ESC lt Server identification gt lt Command gt lt Size gt lt Data gt Optional elements lt ACK gt Acknowledge lt NAK gt Negative Acknowledge lt ECHO gt reports the matrix sequences solicited by a command and thus the new switching status of the matrix The echo can be used to update user applications and to operate several matrices in parallel See Chapter 4 4 1 Sys
51. ice Connection to CON Device 46 6 2 4 Get CPU Devices Connected to CON Devices 47 6 2 5 Set Connections of CPU Devices to CON Devices 48 6 2 6 Get CON Device Connected to CPU Device 49 6 2 7 Set CON Device Connection to CPU Device 50 6 2 8 Get CON Devices Connected to CPU Devices cooccccno 51 6 2 9 Set Connection of CON Devices to CPU Devices 52 6 2 10 Set CON Device Connection to CPU Device Single Bidirectional Connection KVM Full Access 53 6 2 11 Set Connection of CON Devices to CPU Devices Multiple Bidirectional Connections Full Access 54 6 212 Get All CONNER S paniens 55 6 2 13 Set Connection for All CON Devices and CPU Devices 57 6 2 14 Set Extended Connection ooooocccocccccconcccnonnncnononoconinoncconnnonos 58 62 15 Ger EPU LSC aaa olaaa 59 62 16 Get CON stand 60 62 17 Get User TSt yraa aeia aadd 61 6 3 ASSIQNIMENS sra 62 6 3 1 Get Virtual CON Device ccccooccccononnccnonnncnonnnncncnnnccononnncnannnanos 62 6 3 2 Set Virtual CON Device to a Real CON Device i s 63 6 3 3 Get Real CPU Devi erisir rca 64 6 3 4 Set Real CPU Devices to a Virtual CPU Device ooooccccnnn 65 6 3 5 Get Virtual CON DeVICOS ic ccccsiciecsiseeseessssseesisesnevscasseceucenes 66 6 3 6 Set Virtual CON Devices to Real CON Devices i 67 724 746 5500 blackbox com Page 7 ACX048 API manual Table of Contents 6 3 7 Get Real CPW Dev
52. ices issiima aiina darias 68 6 3 8 Set Real CPU Devices ooooococccocccccconccononnncononanonononcconinnncininannss 69 GA Best PraCUC estadio tic lb liebe 70 6 4 1 Full Access Establishing a KVM Connection 70 6 4 2 Video Access Establishing a Video Only Connection 70 6 4 3 Private Access Establishing an Exclusive KVM Session 70 6 4 4 USB 2 0 Access Establishing a USB 2 0 Data Connection 70 7 Specifications c ccc cecececcecceeeseesceeeeeseeecseesesecaeeeeeesseceeeetseseeeetesaeeseeesseees 72 71 SYSTEM REQUESTS caca ca caia dae 73 7 2 SWEA COMMANA Sepe E a e Eaei 75 7 21 Switch Off All Ports oooncnnnconncconococoncninnc conc nano conan cnnncccanc nn 75 7 2 2 Get CPU Device Connected to CON Device 76 7 2 3 Set CPU Device Connection to CON Device ccc 77 7 2 4 Get CPU Devices Connected to CON Devices coocccon 78 7 2 5 Set Connections of CPU Devices to CON Devices 80 7 2 6 Get CON Device Connected to CPU Device 81 7 2 7 Set CON Device Connection to CPU Device oooococinncccccnnc 82 7 2 8 Get CON Devices Connected to CPU Devices 83 7 2 9 Set Connection of CON Devices to CPU Devices 85 7 2 10 Set CON Device Connection to CPU Device Bidirectional 86 7 2 11 Set Connection of CON Devices to CPU Devices Bidirectional nvidia dai i 87 7 2 12 Get All CONNECTIONS oeiee 88 7 2 13 Set Connection for All CON Devices and CPU Devices 90
53. ly supplied by a DNS server default Function not active Input of the IP address in the form 192 168 1 1 if DHCP is not active Input of the subnet mask in the form 255 255 255 0 if DHCP is not active Input of the IP address in the form 192 168 1 1 if DHCP is not active LAN interface at the DKM FX activated for access via Java tool TCP IP port 5555 Function not active FTP server for transmission of configuration files activated Function not active NOTE To activate the modified network parameters restart the API CAUTION Consult your system administrator before modifying the network parameters Otherwise unexpected network results and failures can occur OSD Select Configuration gt Network in the main menu NOTE The serial interface can be blocked while the OSD is open ACX048 API manual 724 746 5500 blackbox com Page 39 Chapter 5 Configuration Figure 5 5 Menu Configuration Network You can select between the following buttons Table 5 4 Button functions Number Component Cancel Reject changes Save Save changes Java Tool Select System gt Network in the task area t tpm 2 a6 X88 se 2s Bae i mig pi Figure 5 6 Menu System Network Page 40 724 746 5500 blackbox com ACX048 API manual Chapter 5 Configuration 5 3 Communication Setup TCP IP socket connection To control the DKM FX via TCP IP socket connection t
54. onld 2 ID of CON device e g 3017 0xC9 Ox0B Example Return CPU devices connected to CON devices ConId 3017 3028 3040 Ox1B Ox5B 0x4A Ox0D 0x00 0x03 0x00 OxC9 Ox0B OxD4 Ox0B OxEO Ox0B Page 78 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Response Telegramn ESC J Size ConCnt lt Conld Cpuld gt 1 lt ConId Cpuld gt ConCnt General Description Get CPU devices input connected to CON devices output Returns a list of pairs of Conld Cpuld Table 7 10 Get CPU devices input connected to CON devices output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5D J 1 Command Ox4A A eg Tor Concita 3 Size 2 Total length of telegram 7 Bytes data 0x13 0x00 ConCnt 2 Number of CON devices e g 3 0x03 0x00 Conld 2 ID of CON device e g 3017 OxC9 Ox0B Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Example Get CPU devices connected to CON devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 CpulId 3 1020 ConId 3 3040 Ox1B 0x5D 0x4A 0x13 0x00 0x03 0x00 OxC9 Ox0B OxF4 0x03 OxD4 Ox0B OxF5 0x03 Ox0E Ox0B OxFC 0x03 724 746 5500 blackbox com Page 79 ACX048 API manual Chapter 7 Specifications 7 2 5 Set Connections of CPU Devices to CON Devices Request Telegram ESC K Size ConCnt lt ConId Cpuld gt 1 lt ConId Cpuld gt ConCnt General Description
55. ooting 8 Troubleshooting In Chapters 8 9 support for problems with the DKM FX API is provided If you have problems with the involved devices especially the DKM matrix refer to the respective device manuals 8 1 Network Error Diagnosis Network settings are not accepted after editing Possible Reason Restart of the matrix not yet completed Measure Do a restart 8 2 Failure at the Matrix Diagnosis Serial control impossible or only possible with restrictions Possible Reason Different Baud rate of CPU and matrix Measure Adapt Baud rate in the CPU Diagnosis Serial control via RJ 45 port not possible Possible Reason Wrong network cable Measure Use a crossed network cable Page 112 724 746 5500 blackbox com ACX048 API manual Chapter 9 Technical Support 9 Technical Support Before contacting technical support please ensure you have read this manual and then installed and set up your DKM FX as recommended Contact Black Box Technical Support at 724 746 5500 or info blackbox com Support Checklist To efficiently handle your request it is necessary to provide us with complete information for support and problem cases Keep the following information available before you call e Company name phone number and e mail e Type and serial number of the device see bottom of device e Date and number of sales receipt name of dealer if necessary e Issue date of the existing manual e Nature circums
56. r graphics standard with a typical resolution of 640x480 pixels and up to 262 144 colors It can be seen as a follower of the graphics standards MDA CGA and EGA API Specific Glossary ACK Since packet transfer is not reliable a technique known as positive acknowledgment with retransmission is used to guarantee reliability of packet transfers API An application programming interface API is a specification intended to be used as an interface by software components to communicate with each other An API may include specifications for routines data structures object classes and variables Echo The response of the DKM FX matrix to an external command optional NACK A transmission control character sent by a station as a negative response to the station with which the connection has been set up Serial In telecommunication and computer science serial communication is the process of sending data one bit at a time sequentially over a communication channel or computer bus TCP IP The Internet protocol suite is the set of communication protocols used for the Internet and similar networks and generally the most popular protocol stack for wide area networks Page 116 724 746 5500 blackbox com ACX048 API manual NOTES 724 746 5500 blackbox com Page 117 ACX048 API manual NOTES Page 118 724 746 5500 blackbox com ACX048 API manual NOTES 724 746 5500 blackbox com Page 119 ACX048 API manual
57. rico deber ser situado fuera del alcance de fuentes de calor como radiadores registros de calor estufas u otros aparatos incluyendo amplificadores que producen calor El aparato el ctrico deber ser connectado a una fuente de poder s lo del tipo descrito en el instructivo de operaci n o como se indique en el aparato Precauci n debe ser tomada de tal manera que la tierra fisica y la polarizaci n del equipo no sea eliminada Los cables de la fuente de poder deben ser guiados de tal manera que no sean pisados ni pellizcados por objetos colocados sobre o contra ellos poniendo particular atenci n a los contactos y recept culos donde salen del aparato El equipo el ctrico debe ser limpiado nicamente de acuerdo a las recomendaciones del fabricante En caso de existir una antena externa deber ser localizada lejos de las lineas de energia ACX048 API manual NOM Statement 16 El cable de corriente deber ser desconectado del cuando el equipo no sea usado por un largo periodo de tiempo 17 Cuidado debe ser tomado de tal manera que objectos liquidos no sean derramados sobre la cubierta u orificios de ventilaci n 18 Servicio por personal calificado deber ser provisto cuando A El cable de poder o el contacto ha sido da ado u B Objectos han ca do o l quido ha sido derramado dentro del aparato o C El aparato ha sido expuesto a la lluvia o D El aparato parece no operar normalmente o muestra un cambio en su d
58. rts 49 64 SFP 3 1 0 ports 17 32 CATx 1 0 ports 33 48 CATx Serial connection RJ 45 Network connection RJ 45 Figure 3 30 Back view ACXC48F16 Table 3 32 ACXC48F16 back panel components Number 1 2 3 Component Power supply unit 1 Power supply unit 2 Grounding 724 746 5500 blackbox com Chapter 3 Overview 3 6 18 ServSwitch DKM FX Compact 48 CATx Ports 32 Fiber Ports ACXC48F32 e T o EEE CARA PARA NAAA CARD AA AAA NAAA ARA ARA AARAA ARO A 3 LIO E E JE EE LE AAL d i ge ge bak ah ake AE tH Figure 3 31 Front view ACXC48F32 Table 3 33 ACXC48F32 components Number Component 1 1 0 ports 1 16 CATx 2 1 0 ports 49 64 SFP 3 1 0 ports 17 32 CATx 4 1 0 ports 65 80 SFP 1 0 ports 33 48 CATx Serial connection RJ 45 Network connection RJ 45 a OO o 2 8 Figure 3 32 Back view ACXC48F32 Table 3 34 ACXC48F32 back panel components Number 1 2 3 Component Power supply unit 1 Power supply unit 2 Grounding 724 746 5500 blackbox com Chapter 3 Overview 3 7 Status LEDs The ServSwitch DKM FX and DKM FX Compact LED indicators on the CPU board are shown in Figure 3 33 and described in Table 3 35 Figure 3 33 CPU board front view 724 746 5500 blackbox com Page 33 ACX048 API manual Chapter 3 Overview Table 3 35 Status LEDs on the CPU board Number LED Sta
59. t generates uses and can radiate radio frequency energy and if not installed and used properly that is in strict accordance with the manufacturer s instructions may cause interference to radio communication It has been tested and found to comply with the limits for a Class A computing device in accordance with the specifications in Subpart B of Part 15 of FCC rules which are designed to provide reasonable protection against such interference when the equipment is operated in a commercial environment Operation of this equipment in a residential area is likely to cause interference in which case the user at his own expense will be required to take whatever measures may be necessary to correct the interference Changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operate the equipment This digital apparatus does not exceed the Class A limits for radio noise emission from digital apparatus set out in the Radio Interference Regulation of Industry Canada Le pr sent appareil num rique n met pas de bruits radio lectriques d passant les limites applicables aux appareils num riques de la classe A prescrites dans le Reglement sur le brouillage radio lectrique publi par Industrie Canada Normas Oficiales Mexicanas NOM Electrical Safety Statement INSTRUCCIONES DE SEGURIDAD Todas las instrucciones de seguridad y operaci n deber n ser le das antes de qu
60. t view ACXO80 Table 3 6 ACX080 components Number Component 1 Slot for fan tray 2 Slot for Power Supply Unit 1 3 Slot for I O Boards 1 10 4 Slot for Power Supply Unit 2 5 Slot for CPU board 6 Slot for air filter 7 Slot for Fan Tray 2 Page 16 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview 3 6 3 ServSwitch DKM FX 160 Port ACX160 Figure 3 5 Front view ACX160 Table 3 7 ACX160 components Number Component 1 Slot for Power Supply Unit 1 2 Slot for Fan Tray 1 3 Slot for Power Supply Unit 2 4 Slot for Fan Tray 2 5 Slot for I O Boards 1 36 6 Slot for Power Supply Unit 3 7 Slot for CPU board 8 Grounding 724 746 5500 blackbox com Page 17 ACX048 API manual Chapter 3 Overview 3 6 4 ServSwitch DKM FX 288 Port ACX288 TET TET Figure 3 6 Front view ACX288 Page 18 724 746 5500 blackbox com ACX048 API manual Chapter 3 Overview Table 3 8 ACX288 components Number Component 1 Slot for Power Supply Unit 1 2 Slot for Fan Tray 1 3 Slot for Power Supply Unit 2 4 Slot for Fan Tray 2 5 Slot for 1 O Boards 1 36 6 Slot for Power Supply Unit 3 7 Slot for CPU board 8 Grounding NOTE The ServSwitch DKM FX Compact models are described next 3 6 5 ServSwitch DKM FX Compact 8 Port CATx ACXC8 1 23 4 5 Figure 3 7 Front view ACXC8 Table 3 9
61. tages at the serial interface e To disconnect the switch from the power supply remove the power cord cables of all power supply units that are in use or set the power switch if available to the OFF position e Take any required ESD precautions e To disconnect the device completely from the electric circuit remove all power cables Repair e Do not attempt to open or repair a power supply unit e Do not attempt to open or repair the DKM FX or DKM Compact There are no user serviceable parts inside e Contact Black Box Technical Support at 724 746 5500 or info blackbox com if there is a fault 724 746 5500 blackbox com Page 11 ACX048 API manual Chapter 3 Overview 3 Overview 3 1 Description The DKM FX API is used to control the matrix externally by serial commands via serial RS 232 or network TCP IP connection The DKM FX API provides the full scope of switching functionality It does not support the configuration of a DKM FX system 3 2 Access Options You have the following options to access the DKM FX for external serial control TO PSSS opto Access option Symbol Serial interface TCP IP Interface Cw TCP IP NOTE Both serial interface and TCP IP interface use the same commands for the operation of the DKM FX matrix 3 3 System Overview A DKM FX matrix consists of a DKM FX matrix and for KVM applications of one or more CPU units CON units The matrix is connected to the C
62. tances and duration of the problem e Involved components such as graphics source CPU OS graphics card monitor USB HID USB 2 0 devices interconnect cable including manufacturer and model number e Results from any testing you have done 724 746 5500 blackbox com Page 113 ACX048 API manual Chapter 10 Glossary 10 Glossary The following terms are commonly used in this guide or in video and KVM technology AES EBU Digital audio standard that is officially known as AES3 and that is used for carrying digital audio signals between devices CATx Any CAT5e CAT6 CAT7 cable CGA The Color Graphics Adapter CGA is an old analog graphic standard with up to 16 displayable colors and a maximum resolution of 640x400 pixels Component Video The Component Video YPbPr is a high quality video standard that consists of three independently and separately transmittable video signals the luminance signal and two color difference signals Composite Video The Composite Video is also called CVBS and it is part of the PAL TV standard CON Unit Component of a DKM FX or Media Extender to connect to the con sole monitor s keyboard and mouse optionally also with USB 2 0 devices Console Keyboard mouse and monitor CPU Unit Component of a DKM FX or Media Extender to connect to a source computer CPU CVBS The analog color video baseband signal CVBS is also called Composite Video and it is part of the PAL TV st
63. tem Data in the DKM FX manual to get more Information about Echo Mode NOTE Use the lt ECHO gt reports to verify that the switch commands have been executed as requested Update the external switch status according to the lt ECHO gt reports rather than according to your commands 5 5 Constraints e Maximum buffer size for data transfer is 8192 bytes e 12 sockets for TCP IP communication over Port 5555 are available Ensure that there will be at least one socket left for the communication with the Java tool e Wait for a response before sending another request to the matrix Page 42 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 Operation The DKM FX API can be addressed in two different ways 1 Telegrams via serial connection 2 Telegrams via TCP IP socket connection Both connections accept the same telegrams Available telegrams support system requests switch commands and assignments 6 1 System Requests Get System Time Request Telegram Description Get system time Example Get system time Ox1B 0x28 0x53 Response Telegram ESC S Size Seconds Minutes Hours Day Date Month Year Description Return system time Seconds Seconds 0 59 Minutes Minutes 0 59 Hours Hours 0 23 Day Days 1 7 Monday 1 Date Date 1 31 Month Month 1 12 Year Year 2000 724 746 5500 blackbox com Page 43 ACX048 API manual Chapter 6 Operation
64. ter Ox1B 1 Server identification OX5B N 1 Command Ox4E F e g for CpuCnt 3 Size 2 Total length of telegram 7 Bytes data 0x13 0x00 CpuCnt 2 Number of CPU devices e g 3 0x03 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 0xC9 Ox0B Example Return CON devices connected to CPU devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 CpulId 3 1020 ConId 3 3040 Ox1B Ox5D Ox4E 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 Ox0B OxF5 0x03 0xD4 Ox0B OxFC 0x03 Ox0E Ox0B Page 84 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 9 Set Connection of CON Devices to CPU Devices Request Telegram ESC O Size CpuCnt lt Cpuld ConId gt 1 lt Cpuld ConId gt CpuCnt General Description Set connection CON devices input to CPU devices output Data of CON device USB Audio will be transmitted to CPU device Table 7 17 Set connection CON devices input to CPU devices output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B o 1 Command Ox4F i e g for Cpucnt 3 Size 2 Total length of telegram 7 Bytes data 0x13 0x00 CpuCnt 2 Number of CPU devices e g 3 0x03 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conid 2 ID of CON device e g 3017 0xC9 0x0B Example Set connection of CON devices to CPU devices CpuId 1 1012 ConId 1 3017 Cp
65. tus Description White CPU board is in registration process Blue flashing Registration at the matrix is started 1 Status 1 Red flashing Registration is in progess Green flashing Operating condition Green CPU board de registered r TCP IP Red Operating condition ee Off No connection TCP IP Green flashing Active data traffic 3 Status 2 Off No active data traffic White CPU board is in registration process 4 Status2 Red flashing Registration at the matrix is started Off Operating condition NOTE Because of variations in the LED type white may also appear as light purple or light blue Page 34 724 746 5500 blackbox com ACX048 API manual Chapter 3 Installation 4 Installation 4 1 How to Get Documentation This API manual can be downloaded from the Black Box Web site To download from the Web site 1 Go to www blackbox com 2 Enter the part number in the search box Hello Sign In or Register 0 tems Account Cart S SUPPORT ABOUT Talk with an Expert 3 Click on the Resources tab on the product page and select the document you wish to download If you have questions contact Black Box Technical Support at 724 746 5500 or info blackbox com 4 2 System Setup NOTE If you are a first time user we recommend that you set up the system in the same room as a test setup This will allow you to identify and solve any cabling problems and experiment with your system more conveniently Setup of the e
66. uId 2 1013 ConId 2 3028 CpuId 3 1020 ConId 3 3040 Ox1B 0x5B 0x4F 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 0X0B OxF5 0x03 0xD4 Ox0B OxFC 0x03 Ox0E Ox0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 724 746 5500 blackbox com Page 85 ACX048 API manual Chapter 7 Specifications 7 2 10 Set CON Device Connection to CPU Device Bidirectional Request Telegram ESC P Size Cpuld Conld General Description Set CON device input connection to CPU device output and CPU device input connection to CON device output Data of CON device USB audio will be transmitted to CPU device Data of CPU device video USB audio will be transmitted to CON device Table 7 18 Set CON device input connection to CPU device output and CPU device input connection to CON device output Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B P 1 Command 0x50 Size 2 Total length of telegram 9 bytes 0x09 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 0xC9 Ox0B Example Set CON device ConID 3017 connection to CPU device CpuId 1012 Ox1B Ox5B 0x50 0x09 0x00 OxF4 0x03 0xC9 Ox0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 86 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications
67. urn list of CONs 0x1B Ox5D 0x68 0x00 0x00 0x43 0x31 0x00 0x00 Table 7 27 Get CON List response Description Control character Server identification Command Total length of telegram Number of CONs ID of first CON in next list ID of CON device Name of CON 0x21 0x00 Ox4F 0x4E 0x00 0x00 0x01 0x00 Hex Coding 0x1B 0X5D 0x68 e g 33 0x21 0x00 e g 1 0x01 0x00 e g O 0x00 0x00 no further CON e g 3000 0xB8 Ox0B 0x00 0x00 e g CON_Video1 0x43 Ox4F Ox4E Ox5F 0x56 0x69 0x64 0x65 Ox5F 0x31 0x00 0x00 0xB8 0x0B OxSF 0x56 0x69 0x64 0x65 0x6F 0x00 0x00 0x00 0x00 0x00 0x00 Page 96 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 2 17 Get User List Request Telegram ESC i Size First General Description Get list of all users First Index of the user from whom the list scan will start Table 7 28 Get User List Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B i 1 Command 0x69 Size 2 Total length of telegram 7 bytes 0x07 0x00 e g 1 0x01 0x00 First 2 Index of first user 0 all 0x00 0x00 Example Get all users Ox1B 0x5B 0x69 0x07 0x00 0x00 0x00 Response Telegram ESC i Size Count Next List 1 List Count General Description Count Number of items in the user list Next Index of the next user if the list of
68. users exceeds the telegram size Contains O if there are no more users 724 746 5500 blackbox com Page 97 ACX048 API manual Chapter 7 Specifications Table 7 29 Get User List response Type Bytes Description Hex Coding ESC 1 Control character Ox1B 1 Server identification OX5D i 1 Command 0x69 Size 2 Total length of telegram e g 33 0x21 0x00 Count 2 Number of users e g 1 0x01 0x00 Next 2 ID of first user in next list e g 0 0x000x00 no further user e g 1 0x01 0x00 Id 4 ID of user 0x00 0x00 e g admin 0x61 0x64 Name 20 Name of user Ox6D 0x69 Ox6E Example Return list of users Ox1B 0x5D 0x69 0x21 0x00 0x01 0x00 0x00 0x00 0x01 0x00 0x00 0x00 0x61 0x64 0x6D 0x69 0x6E 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 T Page 98 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications 7 3 Assignments 7 3 1 Get Virtual CON Device Request Telegram ESC T Size RConId General Description Get virtual CON device of a real CON device Table 7 24 Get virtual CON device of a real CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B T 1 Command 0x54 Size 2 Total length of telegram 7 bytes 0x07 0x00 RConld 2 ID of real CON device e g 3017 0xC9 0x0B Example Get virtual CON device of a real CON device RConId 3017 Ox1B 0x5B 0x54 0x07 0x00 OxC9 Ox0B
69. vice Connection to CON Device Request Telegram ESC I Size ConId Cpuld General Description Set CPU device connection input to CON device output Input data of CPU device video USB audio will be transmitted to CON device Table 7 8 Set CPU device connection to CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B 1 Command 0x49 Size 2 Total length of telegram 9 bytes 0x09 0x00 ConlD 2 ID of Con Device e g 3017 OxC9 Ox0B Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 724 746 5500 blackbox com Page 77 ACX048 API manual Chapter 7 Specifications Example Set CPU device Cpuld 1012 connection to CON device ConId 3017 Ox1B 0x5B 0x49 0x09 0x00 OxC9 Ox0B OxF4 0x03 Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements 7 2 4 Get CPU Devices Connected to CON Devices Request Telegram ESC J Size ConCnt Conld 1 Conld ConCnt General Description Get CPU devices input connected to CON device output For ConCnt 0 all CON devices will be returned Table 7 9 Get CPU devices connected to CON device Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B J 1 Command Ox4A A e g for ConCnt 3 Size 2 Total length of telegram 7 Bytes data OxOD 0x00 ConCnt 2 Number of CON devices e g 3 0x03 0x00 C
70. vices connected to CPU devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 Cpuld 3 1020 ConId 3 3040 Ox1B 0x5D 0x4E 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 Ox0B OxF5 0x03 0xD4 0x0B OxFC 0x03 Ox0E 0x0B 724 746 5500 blackbox com Page 51 ACX048 API manual Chapter 6 Operation 6 2 9 Set Connection of CON Devices to CPU Devices Request Telegram ESC O Size CpuCnt lt Cpuld Conld gt 1 lt Cpuld Conld gt CpuCnt Description Set connection CON devices input to CPU devices output Data of CON device USB audio will be transmitted to CPU device CpuCnt Number of CPU devices lt Cpuld Conld gt List of IDs CpulD ConID Example Set connection of CON devices to CPU devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 Cpuld 3 1020 Conld 3 3040 0x1B 0x5B 0x4F 0x13 0x00 0x03 0x00 OxF4 0x03 0xC9 0x0B OxF5 0x03 0xD4 0x0B OxFC 0x03 0x0E 0Ox0B Response lt ACK gt lt ECHO gt or lt NAK gt Optional elements Page 52 724 746 5500 blackbox com ACX048 API manual Chapter 6 Operation 6 2 10 Set CON Device Connection to CPU Device Single Bidirectional Connection KVM Full Access Request Telegram ESC P Size Cpuld Conld Description Set CON device input connection to CPU device output and CPU device input connection to CON device output Data of CON device U
71. x52 0x15 0x00 0x03 0x00 0x02 0x00 OxF4 0x03 OxC9 Ox0B OxF5 0x03 0xD4 Ox0B OxFC 0x03 Ox0E Ox0B 0xC9 Ox0OB OxF4 0x03 OxD4 Ox0B 0x00 0x00 724 746 5500 blackbox com Page 89 ACX048 API manual Chapter 7 Specifications 7 2 13 Set Connection for All CON Devices and CPU Devices Request Telegram ESC S Size CpuCnt ConCnt lt Cpuld ConId gt 1 lt Cpuld ConId gt CpuCnt lt ConId Cpuld gt 1 lt ConId Cpuld gt ConCnt General Description Set a connection for all defined CON devices and CPU devices For each defined CPU device add the Conld or O if the CPU device is disconnected For each defined CON device add the Cpuld or 0 if the CON device is disconnected Table 7 22 Set a connection for all defined CON devices and CPU devices Type Bytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B S 1 Command 0x53 e g for Size 2 Total length of telegram 9 bytes data a 0x15 0x00 CpuCnt 2 Number of CPUs 2g 3 0x03 0x00 ConCnt 2 Number of CONs eg 2 0x02 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 OxC9 Ox0B Page 90 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Example Set a connection for all defined CON devices and CPU devices Cpuld 1 1012 ConId 1 3017 Cpuld 2 1013 ConId 2 3028 Cpuld 3 1020 ConId 3 3040 ConId 1 3017 CpuId 1 1012 ConId 2 3
72. xternal control 1 Install the CPU and I O boards 2 Connect the keyboard mouse and monitor to the CPU board of the DKM FX 3 Connect the matrix to the power supply 4 Open OSD via hotkey and log in with administrator rights in the main menu 5 Configure initially as requested 6 Connect the external control either via RS 232 or TCP IP to the matrix 724 746 5500 blackbox com Page 35 ACX048 API manual Chapter 5 Configuration 5 Configuration 5 1 General Remarks The DKM FX API provides all commands that are necessary to switch the DKM FX matrix 5 2 DKM FX Configuration To operate the DKM FX or DKM FX Compact matrix it has to be configured appropriately In the following section all relevant chapters from the DKM FX and DKM FX Compact manual main manual are described For a detailed explanation refer to the the main manual 5 2 1 System Data The DKM FX API relevant system configuration is set in this menu You can access the menu via OSD or Java Figure 5 1 OSD and Java icons You can select between the following DKM FX API relevant settings Table 5 1 API relevant settings Field Selection Description Send all performed switching commands in the matrix as an echo via serial interface Enable activated COM NOTE This function should be enabled when using a media control via serial Echo interface deactivated Function not active default Send all performed switching commands in the matrix
73. ytes Description Hex Coding ESC 1 Control character 0x1B 1 Server identification OX5B R 1 Command 0x52 Example Get all CPU device CON device connections Ox1B Ox5B 0x52 Response Telegram ESC R Size CpuCnt ConCnt lt Cpuld Conld gt 1 lt Cpuld Conld gt CpuCnt lt ConId Cpuld gt 1 lt ConId Cpuld gt ConCnt General Description Return all CPU device CON device connections in pairs For each defined CPU device the Conld of the connected CON device will be added or O if the CPU device is disconnected For each defined CON device the Cpuld of the connected CPU device will be added or 0 if the CON device is disconnected Page 88 724 746 5500 blackbox com ACX048 API manual Chapter 7 Specifications Table 7 21 Return all CPU device CON device connections in pairs Type Bytes Description Hex Coding ESC 1 Control character 0x1B i 1 Server identification OX5D R 1 Command 0x52 e g for Size 2 Total length of telegram 9 bytes data E E gt 0x15 0x00 CpuCnt 2 Number of CPU device eg 3 0x03 0x00 ConCnt 2 Number of CON device ee 2 0x02 0x00 Cpuld 2 ID of CPU device e g 1012 OxF4 0x03 Conld 2 ID of CON device e g 3017 OxC9 Ox0B Example Return all CPU device CON device connections in pairs Cpuld 1 1012 Conld 1 3017 Cpuld 2 1013 ConId 2 3028 Cpuld 3 1020 ConId 3 3040 ConId 1 3017 CpuId 1 1012 ConId 2 3028 CpuId 2 0 Ox1B Ox5D 0

Application Programming Interface (API) Manual

Contents

Download Pdf Manuals

Related Search

Related Contents