ADDER Secure KVM Switch API Manual de usuario

Manual de usuario
Secure KVM Switch API
Adder Technology Limited
Número de peza : MAN-000022
Versión 1.0

Enderezo rexistrado: Adder Technology Limited Saxon Way, Bar Hill, Cambridge CB23 8SL, Reino Unido
Adder Corporation 24 Henry Graf Road Newburyport, MA 01950 USA
Adder Technology (Asia Pacífico) Pte. Ltd., 8 Burn Road #04-10 Trivex, Singapur 369977
© Adder Technology Limited 22 de febreiro

Introdución

Esta guía explica como usar RS-232 para controlar de forma remota un conmutador KVM Adder Secure (AVS-2114, AVS-2214, AVS-4114, AVS-4214), Flexi-switch (AVS-4128) e variosviewer (AVS-1124).
Para controlar un interruptor mediante RS232, o usuario debe conectar un dispositivo de control ao porto RCU do interruptor. O dispositivo de control pode ser un PC ou calquera dispositivo personalizado con capacidade RS-232.
O control remoto significa realizar accións que os usuarios só poderían facer mediante o panel frontal, incluíndo:

• Cambio de canle
• Retención de audio
• Selección de canles para mostrar nos monitores esquerdo e dereito (só AVS-4128
• Cambio do control KM entre as canles esquerda e dereita (só AVS-4128)
• Selección de esquemas predefinidos e actualización de parámetros da xanela (só AVS-1124)

Instalación

Este procedemento mostra como conectar un interruptor a un dispositivo de control remoto. Requirirase un cable RS232 axeitado cun conector RJ12 para conectar no porto RCU co pinout que se mostra a continuación:

Pinout para o porto RDU:

• Pin 1: 5V
• Pin 2: non conectado
• Pin 3: non conectado
• Pin 4: GND
• Pin 5: RX
• Pin 6: TX

Poucos ordenadores modernos teñen un porto RS232, polo que pode ser necesario utilizar un adaptador USB ou Ethernet.

Operación

Configuración Example Usando a utilidade de consola serie de código aberto PuTTY. Este procedemento demóstrase como cambiar de canle a través de RS-232 usando un PC Windows con mando a distancia.
Pre-configuración

1. Instala PuTTY no ordenador remoto.
2. Conecte un cable serie desde o porto USB do PC ao porto RCU do interruptor.
3. Executa a utilidade PuTTY.
4. Configure os axustes de serie, terminal e sesión, segundo as figuras 1 a 3
   

Nota: Neste punto, o dispositivo comeza a enviar eventos Keep-Alive, cada cinco segundos.
Os eventos Keep-Alive son transmitidos polo interruptor periodicamente para comunicar a configuración actual. Por example, para cambiar un KVM á canle 4, o usuario escribe: #AFP_ALIVE F7 Despois, cada cinco segundos, o dispositivo envía o seguinte evento de mantemento activo: 00@alive fffffff7 como se mostra na Figura 4.Pódese cambiar o intervalo de tempo dos eventos de mantemento activo mediante o comando #ANATA seguido dun operando de período de tempo en unidades de 0.1 segundos Así:

• #ANATA 1 dá un intervalo de 0.1 segundos
• #ANATA 30 dá un intervalo de 3 segundos

Conmutadores KVM
Para cambiar de canle, introduza o comando #AFP-ALIVE seguido dun operando de número de canle. Por example, para cambiar á canle 3, introduza:
#AFP_ALIVE FB

Canle #	Operando
1	FE
2	FD
3	FB
4	F7
5	EF
6	DF
7	BF
8	7F

Figura 5: Operandos da canle de conmutación KVM

Para alternar o botón de retención de audio, introduza o comando #AUDFREEZE 1
Flexi-Switch
Para cambiar de canle, introduza o comando #AFP-ALIVE seguido dun operando do lado esquerdo/dereito e do número de canle. Por example, para cambiar á canle 3 no monitor esquerdo, introduza:

Lado Esquerdo		Lado dereito
Canle #	Operando	Canle #	Operando
1	FFFE	1	JEFF
2	FFFD	2	PDF
3	FFFB	3	FBFF
4	FFF7	4	F7FF
5	FFEF	5	JEFF
6	FFDF	6	DFFF
7	FFBF	7	BFFF
8	FF7F	8	7FFF

Figura 6: Operandos de canle de interruptor flexible
Outros comandos:

• Alterna o botón de retención de audio: #AUDFREEZE 1
• Alterna o foco KM entre os lados esquerdo e dereito
• Esquerda: #AFP_ALIVE FEFFFF
• Dereita: #AFP_ALIVE FDFFFF

Multi-Viewer

Estrutura de comandos A estrutura de comandos componse dos seguintes 4 campos:

Onde: 

• Hai un espazo entre cada campo
• O preámbulo é #ANATL ou #ANATR, onde:
  o #ANATL é igual á secuencia de teclas CTRL esquerda | CTRL esquerda
  o #ANATR é igual á secuencia de teclas CTRL dereita | CTRL dereita
• Os comandos requiren 0, 1 ou 2 operandos
• Éxito do comando: tras a execución exitosa do comando, o dispositivo devolve a saída: comando + Aceptar
• Fallo do comando: en caso de falla, o dispositivo devolve a saída: comando + Mensaxe de erro
• Para iniciar unha nova conexión en serie, introduza #ANATF 1

Lista de comandos
O comando é unha tradución da tecla de acceso rápido do teclado listada nun apéndice do Multi-Viewer Manual de usuario (MAN-000007).
Exampas traducións son:

Descrición	Tecla rápida	Comando API
Cargar preselección #3	Ctrl esquerda | Ctrl esquerda | F3	#ANATL F3
Cambia á canle #4	Ctrl esquerda | Ctrl esquerda | 4	#ANATL 4
Maximiza a canle activa a pantalla completa	Ctrl esquerda | Ctrl esquerda | F	#ANATL F

Figura 7: Example ordes
É probable que os comandos máis comúns sexan cargar un predefinido e colocar e cambiar o tamaño das fiestras na pantalla. O formato xeral do comando para mover e redimensionar unha xanela é: #ANATL F11 FIN
Onde:
é de 1 a 4
é:

1. Localización X da parte superior esquerda da ventá (0 a 100 %)
2. Localización Y da parte superior esquerda da ventá (0 a 100 %)
3. Extensión da xanela X como porcentaxetage do ancho total de X
4. Extensión da xanela Y como porcentaxetage da altura total Y
5. Desfase X (a localización da xanela en comparación co tamaño completo da imaxe cando é grande).
6. Desfase Y (a localización da xanela en comparación co tamaño completo da imaxe cando é grande).
7. Escala X como porcentaxetage
8. Escala Y como porcentaxetage

é un número de 4 díxitos en incrementos do 0.01 %
Nota que onde se usan monitores dobres no modo de extensión, o porcenttages relación co tamaño total da pantalla. Por example, para configurar a xanela para que a canle 1 ocupe o cuarto cuadrante:

Descrición	Comando API
Establece a posición X superior esquerda da xanela na metade da pantalla	#ANATL F11 FIN 115000
Establece a posición X superior esquerda da xanela na metade da pantalla	#ANATL F11 FIN 125000
Establece a extensión da xanela X en media pantalla	#ANATL F11 FIN 135000
Establece a extensión Y da xanela a media pantalla	#ANATL F11 FIN 145000

Figura 8: Establecer a canle 1 no 4º cuadrante (monitor único)
Teña en conta que os comandos cambian lixeiramente cando se usan monitores dobres:

Descrición	Comando API
Establece a posición X superior esquerda da xanela na metade da pantalla	#ANATL F11 FINAL 1 1 5000
Establece a posición X superior esquerda da xanela na metade da pantalla	#ANATL F11 FINAL 1 2 5000
Establece a extensión da xanela X en media pantalla	#ANATL F11 FINAL 1 3 5000
Establece a extensión Y da xanela a media pantalla	#ANATL F11 FINAL 1 4 5000

Figura 9: Establece a canle 1 no 4º cuadrante do monitor esquerdo
Hai un comando que non se adhire ao patrón mencionado anteriormente, Audio Hold. Para alternar o botón de retención de audio, introduza o comando:
#AUDFREEZE 1
MAN-000022