Manual Display
Khomp - Todos os direitos reservados
Última atualização: 2018-07-17 18:00:50
Índice
1 Introdução
1.1 Sobre o display
2 Display
2.1 Instalador
2.2 Instalação no Windows
2.2.1 Drivers API K3L
2.3 Instalação no Linux
2.3.1 Drivers API K3L
2.3.2 Asterisk Channel Driver
2.3.3 FreeSWITCH Endpoint
3 Configuração do display
3.1 DefaultScreen
3.2 RefreshTimeout
3.3 Screens
3.3.1 Message
3.3.2 Network
3.3.3 Resource
3.3.4 Process
3.3.5 Custom
4 Observação
Introdução
Este manual apresenta as informações necessárias para a utilização do display que acompanha os produtos da família
"EBS Server" e os appliances "UMG Server Modular" e "UMG Server Modular PRO", descrevendo as suas principais
características, bem como o seu processo de instalação e configuração.
Sobre o display
Nos equipamentos eletrônicos, a principal função do display é permitir a monitoração de informações importantes do
próprio equipamento ou do sistema no qual está inserido. Essa monitoração é realizada, normalmente, através de
mensagens de texto que são exibidas no display, com o intuito de apresentar o "status" de uma determinada informação.
O display suporta a exibição de mensagens com uma ou duas linhas, sendo que cada linha pode ter no máximo 16
caracteres. O display possui também "backlight", o que possibilita a visualização das informações em ambientes que
não possuem iluminação. Associados ao display, existem ainda dois botões que são utilizados para selecionar a
mensagem a ser exibida.
Display
Para que seja possível sua utilização é necessário executar um dos procedimentos descritos a seguir respeitando o
sistema operacional instalado no equipamento. Sendo compatível sua utilização a partir das versões do driver Khomp:
K3L-3.3.7 (Windows e Linux)
channel_4.3_012 (Linux)
mod_khomp_2.2_009 (Linux)
Instalador
O arquivo com o programa de instalação está presente no site da Khomp para download ([Link]).
Khomp Ind. e Com. Ltda. 1996-2019 :: Rua Joe Collaco, 253 :: Florianopolis/SC :: Brasil :: +55 48 3722-2900
O arquivo pode ser acessado seguindo as indicações a seguir:
Clique em "Suporte Técnico", em seguida clique em "Área Restrita".
NOTA: É necessário efetuar login com senha para ter acesso.
Clique em "Downloads", selecione uma das três opções que seja compatível com seu sistema operacional:
1. Selecione "Drivers API K3L" para Windowns e Linux, clique em "Confirmar" (espere carregar a página Web).
Escolha o arquivo compatível com a versão de seu sistema operacional e clique em "Download".
2. Selecione "Asterisk Channel Driver" para Linux-Asterisk, clique em "Confirmar" (espere carregar a página Web).
Escolha o arquivo compatível com a versão de seu sistema operacional e clique em "Download".
3. Selecione "FreeSWITCH Endpoint" para Linux-FreeSWITCH, clique em "Confirmar" (espere carregar a página Web).
Escolha o arquivo compatível com a versão de seu sistema operacional e clique em "Download".
Instalação no Windows
Drivers API K3L
Para instalar o driver, é só executar o arquivo da API K3L que foi adquirido.
ATENÇÃO: Instalador do display está disponível somente a partir da versão 3.3.7 da
API.
Para instalar o display em ambiente Windows é necessário executar o instalador "[Link]" (xxx é substituído
pela versão do arquivo escolhido), que está localizado na pasta de drivers da Khomp, normalmente "C:\Khomp\Drivers".
Além dos drivers do display, o instalador também instala o serviço responsável pelo controle do display, que no Windows
chama-se "Khomp Lcd Manager".
Enquanto o serviço estiver rodando, o display deve exibir as informações contidas no seu arquivo de configuração
"[Link]", localizado no diretório de configurações da Khomp.
Quando o serviço não estiver rodando, o display não irá apresentar nenhum tipo de informação.
Instalação no Linux
A instalação do display em ambientes Linux exige a execução de alguns passos preliminares.
Drivers API K3L
ATENÇÃO: Instalador do display está disponível somente a partir da versão 3.3.7 da
API.
1. Vá até onde está o arquivo com o programa de instalação via terminal Linux.
Khomp Ind. e Com. Ltda. 1996-2019 :: Rua Joe Collaco, 253 :: Florianopolis/SC :: Brasil :: +55 48 3722-2900
2. Instalar o pacote com o parâmetro -lcd.
Por exemplo: "bash k3l_xxx_Client_.[Link] -lcd" (onde xxx é referente ao arquivo escolhido compatível ao sistema
operacional).
3. Instale o pacote normalmente com o comando: "bash bash k3l_xxx_Client_.[Link]".
4. Vá até o diretório onde houve a instalação /opt/khomp/lcd/. Por exemplo: "cd /opt/khomp/lcd/" .
5. Instale o script com o comando: "bash klcdmanager_install_xxx-[Link]" .
Asterisk Channel Driver
1. Vá até onde está o arquivo com o programa de instalação via terminal Linux.
2. Descompacte o arquivo com o comando a seguir, através da opção "-u". Por exemplo: "bash channel_xxx.sh -u" (onde
xxx é referente ao arquivo escolhido compatível ao sistema operacional).
3. Entre no diretório descompactado (com mesmo nome da indicação xxx do arquivo de instalação) e em seguida entre
no diretório "lcd-progs".
4. Nesse local (lcd-progs) é onde encontram-se os instaladores do display. Os instaladores estão separados em
subdiretórios de acordo com a versão de "glibc" e "gcc" em que foram compilados.
Por exemplo, um subdiretório denominado "2.5-4.1" significa que o instalador é compatível com a versão 2.5 (ou superior)
da "glibc" e também com a versão 4.1 (ou superior) do "gcc".
NOTA: Recomenda-se utilizar o instalador com as versões de "glibc" e "gcc" mais
próximas das versões instaladas no sistema operacional.
5. Entre no diretório escolhido com o comando "cd 2.5-4.1" .
6. Basta apenas executá-lo: "bash klcdmanager_install_xxx-[Link]" (onde xxx é substituído pelo valor do arquivo presente
neste diretório).
Além dos drivers do display, o instalador também instala o serviço ("klcdmanager") responsável pelo controle do display.
Enquanto o serviço estiver rodando, o display deve exibir as informações contidas no seu arquivo de configuração
"[Link]", localizado no diretório de configurações da Khomp.
Quando o serviço não estiver rodando, o display não irá apresentar nenhum tipo de informação.
FreeSWITCH Endpoint
1. Vá até onde está o arquivo com o programa de instalação via terminal Linux.
2. Descompacte o arquivo com o comando: "gzip -d mod_khomp_xxx.[Link]" (onde xxx é referente ao arquivo escolhido
compatível ao sistema operacional).
3. Instale o pacote com o parâmetro -lcd:
Exemplo: "bash mod_khomp_xxx.sh -lcd" (onde xxx é referente ao arquivo escolhido compatível ao sistema operacional)
4. Instale o pacote normalmente, com o comando "bash mod_khomp_xxx.sh" (onde xxx é referente ao arquivo escolhido
compatível ao sistema operacional).
5. Após a instalação, ir ao diretório: /opt/khomp/lcd/ .
Exemplo: "cd /opt/khomp/lcd/" .
Khomp Ind. e Com. Ltda. 1996-2019 :: Rua Joe Collaco, 253 :: Florianopolis/SC :: Brasil :: +55 48 3722-2900
6. Instalar o script, com o comando "bash klcdmanager_install_xxx-[Link]".
Configuração do display
É possível configurar várias mensagens para o display, a escolha da mensagem desejada pode ser feita através dos dois
botões que estão próximos ao display. É importante destacar que é necessário ter ao menos uma mensagem configurada
para que o display funcione como o esperado. Na configuração do display cada mensagem a ser exibida é denominada
de screen (em português, tela), a seguir são apresentados um exemplo de configuração do display e também a descrição
do seu conteúdo.
Lcd:
DefaultScreen: 0
RefreshTimeout: 2000
Screens:
-
Type: Message
Line1: " EBS SERVER "
-
Type: Message
Line1: " WRITE YOUR "
Line2: " MESSAGE HERE "
-
Type: Network
Name1: "IP[0]"
Label1: "Server IP:"
-
Type: Resource
Name1: "CPU"
Label1: "Process: "
Name2: "MEM"
Label2: "Memory : "
-
Type: Process
Name1: "kibs"
Label1: "Khomp Bootloader"
-
Type: Process
Name1: "k3lserver"
Label1: "Khomp API: "
Name2: "asterisk"
Label2: "Asterisk : "
-
Type: Custom
Command1: "echo 1234567890123456"
Label1: "Custom sys call:"
-
Type: Custom
Command1: "echo ABCDEFG"
Label1: "Custom1: "
Command2: "echo 1234567"
Label2: "Custom2: "
A configuração do display é realizada por meio de definições de parâmetros, essas definições seguem o formato
"parâmetro: valor". Os parâmetros configuráveis do display são: "DefaultScreen", "RefreshTimeout" e "Screens".
DefaultScreen
Determina qual tela de informação será exibida quando o serviço for iniciado ou quando forem adicionadas/removidas
algumas das configurações.
RefreshTimeout
Define o tempo (em milissegundos) que o serviço espera para verificar o "status" da informação selecionada, define
também o tempo de espera para recargar o arquivo de configuração.
Screens
É uma lista das telas configuradas para o display, cada tela pode ser configurada de uma determinada maneira, de
Khomp Ind. e Com. Ltda. 1996-2019 :: Rua Joe Collaco, 253 :: Florianopolis/SC :: Brasil :: +55 48 3722-2900
É uma lista das telas configuradas para o display, cada tela pode ser configurada de uma determinada maneira, de
acordo com o tipo de informação a ser apresentada e/ou monitorada. A seguir é apresentada uma descrição de cada um
dos cinco tipos suportados: "Message", "Network", "Resource", "Process" e "Custom".
Message
Exibe uma mensagem puramente textual no display, essa mensagem pode ter uma ou duas linhas, que são definidas em
"Line1" e "Line2". Cada linha pode ter no máximo 16 caracteres que devem seguir o parão ASCII.
Network
Apresenta no display um determinado IP que está configurado no servidor, o IP é indexado da seguinte forma, "IP[0]" irá
mostrar o primeiro IP configurado, já "IP[1]" irá mostrar o segundo, e assim sucessivamente.
Resource
Mostra a porcentagem de utilização do processador e da memória do servidor, através da identificação "CPU" e "MEM",
respectivamente.
Process
Mostra os "status" de determinados processos, os nomes dos processos são definidos em "Name1" e "Name2". Se os
processos estiverem sendo executados pelo sistema operacional, a palavra "UP" é exibida no display, caso contrário é
exibida a palavra "DOWN".
Custom
Exibe no display o resultado de um "script" ou de uma chamada do sistema. É importante ressaltar que serão
apresentados no máximo os 16 primeiros caracteres retornados pelo script ou chamada.
Observação
Caso exista algum erro na configuração do display, o serviço pode mostrar no display mensagens como "ERROR",
"Verify your lcd config file" e "No config for this screen".
Caso o serviço encontre algum problema na comunicação com a placa de rede do servidor, mensagens como "Listing
network IP fail" e "Network IP not found" também poderão ser apresentadas.
É importante destacar que essas e outras mensagens de erro sempre serão escritas no arquivo de "Log"
"[Link]".
Khomp Ind. e Com. Ltda. 1996-2019 :: Rua Joe Collaco, 253 :: Florianopolis/SC :: Brasil :: +55 48 3722-2900