ATEN - VK CONTROL SYSTEM - Dicas técnicas*

Monitorando o fluxo de dados via TELNET durante a operação regular de uma central VK

Para comunicação com qualquer central ATEN VK, pode-se enviar comandos via porta serial, enviando os comandos diretamente, sem usar caracteres especiais.

Utilize um software como o HERCULES, por exemplo, e envie comandos assim:

Para comandos em Hexa, adicione ＼x0D＼x0A no final da string.

Para ASCII, adicione ＼r＼n no final da string.

As configurações de taxa de transmissão dependem do seu dispositivo de conexão.

Você também pode conectar-se à central VK via TELNET para verificar o feedback, conferindo em tempo real o que está acontecendo no fluxo de dados, enquanto usa ao mesmo tempo uma conexão serial, ethernet ou qualquer outra porta de controle da VK (rele, IR, etc). Veja abaixo como fazer isso:

Exemplo:

Depois que já estiver com todos os dispositivos a serem controlados conectados á central VK, conecte seu PC --> Rede LAN --> a uma central VK1100A ou VK2200(LAN)
Use um software de Telnet (PUTTY por exemplo) --> para obter conexão. Utilize o endereço IP da controladora VK e a porta de conexão "23".
Depois, use o seguinte login=password / senha=password
Digite "HELP" para obter mais informações sobre quais comandos de monitoramento estão à sua disposição.
Digite "STATUS" para monitorar comandos e feedback

Controlando uma central VK remotamente, fora da rede local, via Internet

O sistema de controle ATEN está focado na integração fácil e flexível, dando liberdade de que o usuário opere remotamente com o sistema.

Veja como fazer com que um dispositivo móvel (telefone celular por exemplo) do proprietário seja capaz de se conectar ao controlador VK que esteja dentro de um escritório ou residência, utilizando a internet. Entenda que este procedimento precisa de algum conhecimento técnico e experiência, basicamente de um profissional que possa realizar todos os ajustes de rede necessários.

PROCEDIMENTO:

Imagine que você tenha um projeto bem simples, com um botão de comando toggle para ativar e desativar um rele da própria controladora VK, para que você possa efetuar os testes:

Utilizando o celular na rede local do edifício, carregue a programação acima para seu celular (considerando que você já tenha o app de controle ATEN VK instalado no celular). Teste a programação e depois encerre o app.

Faça login no roteador e configure o 'Port Forwarding' para a porta 33333.

No exemplo abaixo, 192.168.1.60 é um IP local para a controladora VK:

A seguir, descubra o seu ip wlan. Você deverá solicitar ao seu ISP (Provedor de Serviços de Internet) para registrar um IP WAN fixo. E em sua rede, as portas 443 e 33333 deverão estar abertas para comunicação. ATENÇÃO: Entenda que é possível que seu provedor de internet cobre para fazer este serviço para você.

Quando o provedor informar que está tudo ok, já com as duas portas abertas (33333 e 443), você pode testar se estas portas estão de fato abertas, através do link https://testeportas.com.br/:

Com todas as configurações concluídas no provedor de internet, o próximo passo é configurar o ATEN Control APP no seu dispositivo móvel (celular, por exemplo).

No seu celular quando você está fora do edifício, usando rede internet 4G, não será possível acessar o endereço IP local da controladora VK. Então, no aplicativo de controle (ATEN CONTROL APP) você tem que configurar o IP de roteamento (ou seja, o IP da WLAN).

Estando dentro do edifício, ligue o WIFI em seu celular. Abra o APP VK e carregue a programação que você fez. Depois, clique sobre este ícone:

Em seguida, clique aqui:

Na tela que aparecer em seguida no app, indicaríamos por exemplo o seguinte:

DEVICE IP 192.168.1.60 (em nosso exemplo, este é o IP da controladora VK)

IP DO ROTEADOR 189.1.xxx.xxx:33333

Feito tudo isso, desligue o WIFI de seu celular deixando ativa apenas a rede de dados 4G.

Abra o app ATEN VK em seu celular e abra a configuração de controle que você havia feito.

Se você pressionar algumas vezes o botão de controle e o rele 1 da VK responder, significa que as configurações foram feitas com sucesso.

VK108US E ALIMENTAÇÃO COM FONTE EXTERNA

Além de alimentação via POE, o VK108US pode ser alimentado externamente apenas com fonte 5 volts (DC5V:1.25W:). Não pode ser alimentado com fonte com tensão acima de 5 volts!

Resolvendo a mensagem "FAILED TO LOAD THE PROJECT"

A mensagem mencionada pode surgir no software ATEN VK6000 ao tentarmos abrir projetos que foram criados em versões anteriores deste aplicativo, especialmente aqueles desenvolvidos com as centrais de automação descontinuadas ATEN VK1100 e VK2100. Essa incompatibilidade pode impedir que versões mais atuais do VK6000 consigam abrir esses arquivos.

Para resolver esse problema:

Primeiro desinstale o software VK6000 do seu computador.
Em seguida, instale a versão 2.5.245 e depois abra o projeto que estava apresentando problemas.
Ao abrir o projeto, apenas salve o mesmo novamente e encerre a execução do software VK6000.
Depois, instale a versão 3.4.333 do software VK6000. Execute o mesmo e abra o arquivo de projeto antigo.

RESOLVENDO VK6000 QUE NÃO ABRE OU QUE EXIBE MENSAGEM DE ERRO DE DATABASE

(Texto por Francisco Pereira - Nov-2025)

Se esta situação ocorrer, faça o seguinte:

Remova a instalação do software VK6000 de seu computador.
Faça uma cópia em outra pasta do arquivo MYLIB.VKD que fica nesta pasta: C:\Users\Public\Documents\ATEN\VK6000\Configurator\My Library (pode ser que você precise deste arquivo no futuro porque ele contém todos os arquivos de API que você tenha gerado manualmente atrav-s DATABASE MANAGER do VK6000)
Exclua completamente os arquivos e subpastas presentes neste caminho: C:\Users\Public\Documents\ATEN\VK6000\Configurator
Volte a instalar o software VK6000 e teste o mesmo.
Se você costuma gerar arquivos de API de controle usando o DATABASE MANAGER, dentro do VK6000, é sempre importante tirar backup destes arquivos, exportando os mesmos e guardando para uso futuro.

VAMOS EXPLICAR MELHOR:

A ATEN vem evoluindo com as centrais de controle VK e também com o software VK6000 que é utilizado para programar estas centrais.

No entanto, há um software chamado DATABASE MANAGER que opera em conjunto com o software VK6000. Ele sempre é instalado junto com o VK6000 e sempre está disponível quando abrimos o VK6000 para trabalhar com o mesmo.

O Database manager nos permite gerar drivers (apis) para algum equipamento diferente que não exista na base de dados padrão do VK6000. Por exemplo, se temos um projetor ou TV de uma marca e modelo específicos e queremos gerar um menu, uma paleta de comandos para serem enviados a partir de uma central VK, precisamos gerar esta API com auxílio do database manager.

Sendo assim, o database manager é muito útil e importante. Podemos criar nossos próprios drivers e depois exportar e compartilhar estes drivers com outras pessoas que também possuam centrais de automação ATEN.

Com o passar dos anos, a ATEN vem atualizando o VK6000 e também o database manager, juntamente com as novas centrais VK que foram lançadas. Então, eventualmente pode ocorrer que o software VK6000 apresente comportamento estranho, ou não abrindo, ou abrindo temporariamente com alguma mensagem de erro, dizendo por exemplo que MYLIB.VKD é inválido, ou informando que houve um erro crítico e que está salvando um projeto de backup.

Estas situações são bem ruins, porque impedem a gente de trabalhar com o software VK6000.

Veja só, a base de dados gerada pelo Database Manager fica armazenada em um pasta diferente da pasta onde o software fica instalado, sendo este o caminho para esta base de dados:

"C:\Users\Public\Documents\ATEN\VK6000\Configurator\My Library"

Assim, ao removermos uma versão anterior de software VK6000 em nosso computador, os arquivos DATABASE de API que foram gerados por nós não serão apagados, permanecendo disponíveis para uso futuro.

Porém, quando por alguma razão específica o arquivo MYlib.vkd se corrompe, a gente não consegue fazer mais nada. Algo que se pode tentar fazer para resolver a situação é remover a instalação do VK6000, apagar o arquivo MYLIB.VKD que fica nesta pasta e depois voltar a instalar o software vk6000, porém não é sempre que isso resolve a questão. Ao apagar o MYLIB.VKD, você estará apagando também todos os dados de APIs que você tiver registrados ali.

O que acontece é que após a versão 3.8 do VK6000, os arquivos gerados em database manager em versões superiores simplesmente NÃO SÃO COMPATÍVEIS com softwares das versões anteriores. Nem mesmo fazendo a exportação de maneira correta. Contudo, o que nós criamos em versões anteriores do software pode ser exportado com sucesso para versões posteriores.

Talvez a justificativa seja porque a partir da versão 3.8 do VK6000, o Database manager foi alterado:

Veja, se temos que gerar um driver que funcione em versões abaixo da 3.8 de VK6000 e também nas versões acima de 4.x, temos que criar o driver em uma versão abaixo de 3.8, exportar o driver e depois instalar na versão mais atual.

Outro detalhe é que não podemos ter duas versões diferentes de MYLIB instaladas num mesmo computador. Para usar uma certa versão de VK6000, pode ser que a gente tenha que remover MYLIB anterior.

Veja um exemplo prático desta questão:

Imagine que hoje estou usando um VK1100A e tenho a versão 4.0.395 do VK6000 instalada em meu computador (na data que escrevi este artigo, esta era a versão mais atual de VK6000).

Imagine que manualmente eu tenha criado um driver para controlar uma matriz de vídeo. Imagine que agora, eu tenho que passar este driver para uma unidade antiga VK1100K2. O VK6000 nas versões atuais não é compatível com o VK1100K2. Sendo assim, removo a versão 4.0.395 e simplesmente instalo a versão 3.4.333 (nenhuma versão acima desta é compatível com VK1100K2). Ao fazer este movimento, o arquivo MYLIB presente na pata MYLIBRAY (citada acima) NÃO É COMPATÍVEL com a versão versão 3.4.333. E aí eu teria problemas...

A confusão fica pior se a gente veio com o tempo atualizando o software VK6000 mas nunca tirou backups dos apis que haviam sido gerados. E pior ainda, se viemos criando drivers dentro do database manager a cada nova versão de VK6000 que estava instalada, o arquivo total MYLIB fica terrivelmente comprometido. É nessa hora que as coisas param totalmente de funcionar e o seu computador não conseguirá mais abrir o VK6000. Nesta situação mais crítica, teríamos que ter uma maneira de iniciar com um arquivo MYLIB totalmente limpo, nos obrigado posteriormente a importar os arquivos VKD que desejamos usar..

Uma boa prática é sempre manter cópias exportadas de cada arquivo de driver (api) que é gerado por nós, para evitar problemas futuros. Desta forma sempre teremos um repositório onde buscar dados de api para uso imediato e importar este arquivo VKD para a versão de VK6000 que estivermos utilizando. Estas cópias de VKD deveriam estar nomeadas de uma forma que ajudem a localizar para qual tipo de equipamento aquele vkd serve, a data em que foi gerado e qual versão de VK6000 foi utilizada para exportar aquele VKD.