Prévia do material em texto
ALFA INSTRUMENTOS ELETRÔNICOS LTDA PuTTY: terminal serial para o transmissor 2710 Manual do Usuário Daniel Franzini Revisão do documento Última alteração 12 28/02/2013 16:30:00 Este documento contém o manual do usuário do PuTTY como terminal serial para o transmissor 2710. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 1 Sumá rio 1 Introdução ............................................................................................................................. 2 1.1 Audiência ....................................................................................................................... 2 2 Manual do usuário ................................................................................................................. 3 2.1 Requisitos....................................................................................................................... 3 2.2 Instalação ....................................................................................................................... 3 2.3 Interface ......................................................................................................................... 3 2.4 Configurações ................................................................................................................ 6 2.4.1 Salvando as configurações ..................................................................................... 6 2.4.2 Restaurando as configurações ............................................................................... 7 2.5 Iniciando uma sessão ..................................................................................................... 8 2.6 Transferência de arquivos de texto ............................................................................... 9 2.6.1 Exemplo completo com o módulo EZ-Swap do transmissor 2710 ...................... 10 3 Referências .......................................................................................................................... 13 PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 2 1 Introdução Este documento é o manual do usuário para o software PuTTY para ser o terminal serial do transmissor 2710. 1.1 Audiência Este documento deve ser lido por engenheiros e técnicos que precisarem utilizar o PuTTY com o canal de serviço do transmissor 2710 (via RS232). PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 3 2 Manual do usuário Esta versão do PuTTY apresenta poucas funcionalidades muito simples, já que deve ser utilizada apenas como terminal serial para o transmissor 2710 e não como um terminal remoto completo. 2.1 Requisitos Esta versão do PuTTY necessita do seguinte para ser executada: Sistema Operacional Windows XP, Vista ou 7 (32bits ou 64bits); 1Gb de RAM ou mais; 10Mb de espaço livre em disco ou mais; Um diretório qualquer do disco rígido onde o usuário que vai executar o PuTTY tenha permissão de escrita (e.g. Desktop). 2.2 Instalação O PuTTY foi projetado para ter um procedimento mínimo de instalação. Após realizar o download e descompactar o arquivo zip, basta rodar o executável. Não é feita qualquer alteração no registro nem acesso a recursos que possam necessitar de permissões de administrador. O software não funcionará se não estiver presente na mesma pasta do executável o arquivo putty.ini, que contém os parâmetros de configuração. 2.3 Interface A interface do PuTTY está contida em duas telas básicas, apresentadas nas figuras a seguir. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 4 Figura 1 - Interface para configuração do PuTTY. Na Figura 1, estão os seguintes elementos: 1. Configuração da porta serial: nesta caixa deve ser digitada a string que descreve a porta serial que será utilizada para comunicação com o transmissor 2710. Exemplos: COM1, COM3; 2. Velocidade de comunicação (baud rate): nesta caixa deve ser digitado o baud rate da comunicação com o transmissor 2710; 3. Tipo de conexão: nesta caixa de seleção deve ser escolhido o tipo de conexão (serial, TCP/IP Raw, SSH, Telnet, etc). Esta versão customizada do PuTTY implementa somente o tipo serial; 4. Gerenciamento das configurações: aqui existem controles para carregar (LOAD), salvar (SAVE) e apagar (DELETE) as configurações armazenadas no arquivo INI. O PuTTY possui muitos parâmetros que podem ser configurados e armazenados mas esta versão permite que sejam alterados apenas os parâmetros relativos a comunicação serial. A configuração padrão fornecida foi testada durante o desenvolvimento com o transmissor 2710 e funciona para ele. Portanto, não deve ser alterada; PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 5 5. Controle em árvore que permite selecionar os diversos grupos de parâmetros a serem configurados: como esta versão só permite configurar parâmetros relativos a comunicação serial, este é o único grupo disponível; 6. Botão About: mostra informações sobre o sistema, data de compilação, aviso de copyright e botões para exibir o texto original da licença do PuTTY para acessar o site da Alfa Instrumentos; 7. Configurações que descrevem o comportamento do PuTTY quando o terminal é fechado: esta opção permite ao PuTTY decidir se fecha complementamente o programa ou volta para a tela inicial quando o terminal é fechado. Recomenda-se deixar esta opção na configuração padrão fornecida; 8. Botões de ação: o botão Open inicia uma sessão de terminal com as configurações que estiverem carregadas e o botão Cancel sai do sistema. Figura 2 - Sessão de terminal do PuTTY. A Figura 2 mostra uma sessão iniciada do terminal do PuTTY. A partir deste ponto, o PuTTY está pronto para atuar como terminal serial para o transmissor 2710 recebendo comandos diretamente do teclado, como no HyperTerminal. Está fora do escopo deste manual a configuração e operação do transmissor 2710 via canal de serviço. Para maiores informações consulte o manual do usuário do transmissor 2710. Nesta tela, também deve ser observado o ícone , localizado no canto superior esquerdo. Ele tem a função de permitir acesso as funcionalidades implementadas no PuTTY durante uma sessão do terminal. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 6 2.4 Configurações O PuTTY oferece uma série de parâmetros que podem ser configurados para cada um dos backends. Nesta versão, como está disponibilizado apenas o backend serial, apenas configurações relacionadas com este tipo de comunicação estão disponibilizadas. Para acessar as configurações da serial, clique no item “Serial” do controle em árvore (marcado com número 5 na Figura 1). A tela de configuração dos parâmetros da serial está mostrada na Figura 3. Aqui pode ser configurada a porta que será usada na comunicação (Serial line), a velocidade da comunicação (Speed), o número de bits de dados (Data bits) por frame, o número de bits de parada (Stop bits) por frame, a paridade (Parity) e o controle de fluxo (Flow control). Figura 3 - Configuração da comunicação serial. Após alterar os parâmetros é necessário SALVAR as alterações para que sejam carregadas na próxima vez que o PuTTY for executado. 2.4.1 Salvando as configurações Esta versão do PuTTY suporta o armazenamento das configurações em arquivo INI e não no registro do Windows como o PuTTY original. Esta decisão foi tomada para facilitar a instalação e distribuição já que não necessita de autorização do Administrador da rede para PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 7 acessar o registro. Para salvar uma configuração qualquer que esteja mostrada na interface, siga os seguintes passos (vide Figura4): 1. Selecione a sessão “Default Settings” dando um clique sobre ela; 2. Clique no botão “Save”; 3. Para salvar em uma nova sessão digite o nome que deseja dar a ela na caixa “Saved sessions” e clique em “Save”. Figura 4 - Salvando configurações do PuTTY. 2.4.2 Restaurando as configurações O PuTTY suporta a restauração das configurações a partir do arquivo INI. Para restaurar as configurações siga os seguintes passos (vide Figura 5): Selecione a sessão “Default Settings” ou outra que queira carregar dando um clique sobre ela; Clique no botão “Load”. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 8 Figura 5 - Carregando as configurações do PuTTY. 2.5 Iniciando uma sessão Depois que sessão está configurada, basta clicar no botão “Open” (vide Figura 6) para iniciar uma sessão. O terminal será aberto e a comunicação será feita através da porta serial escolhida e com um conjunto de parâmetros (tamanho de fonte, tamanho do terminal, tipo de emulação e intepretação de algumas teclas) que é adequado para o transmissor 2710. Apesar de essas configurações estarem num arquivo INI, que é um formato em texto plano, elas não devem ser alteradas em hipótese alguma. O correto funcionamento desta versão do PuTTY só é garantido se essas configurações estiverem rigorosamente idênticas às fornecidas. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 9 Figura 6 - Iniciando uma sessão do terminal. 2.6 Transferência de arquivos de texto A transferência de arquivos de texto é utilizada para receber os arquivos gerados pelo módulo EZ-Swap do transmissor 2710. Para ativá-la, com uma sessão de terminal aberta no PuTTY, clique no ícone no canto superior esquerdo da tela e depois acesse a opção “Text transfer” (vide Figura 7). PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 10 Figura 7 - Sessão de terminal do PuTTY com o menu para acessar a transferência de texto. O menu “Text transfer” apresenta as opções para iniciar a captura de texto (Start Capturing Text), parar a captura de texto (Stop Capturing Text), iniciar o envio de texto (Start Sending Text) e parar o envio de texto (Stop Sending Text). Dependendo do estado atual da sessão alguns dos menus poderão estar desabilitados. 2.6.1 Exemplo completo com o módulo EZ-Swap do transmissor 2710 Para ilustrar o uso da implementação de transferência de texto do PuTTY, será demonstrado como utilizar o módulo EZ-Swap com ele. Inicialmente, configure o PuTTY e inicie uma sessão de terminal. Para acessar o módulo EZ-Swap, é necessário nível de permissão de USER. Está fora do escopo deste manual como obter os diferentes níveis de permissão no firmware do transmissor 2710. Para obter essas informações consulte o manual do usuário ou o procedimento de calibração do transmissor 2710. Para realizar o procedimento de EZ-Swap utilizando o PuTTY siga os passos a seguir. 1. Configure o PuTTY com os parâmetros corretos da comunicação serial. É recomendado utilizar 115200bps, 8 bits de dados por frame, 1 stop bit por frame, sem paridade e sem controle de fluxo; 2. Obtenha nível de permissão de USER (senha: alfa123); 3. Pressione a tecla [5] para acessar o menu do EZ-Swap; 4. Pressione a tecla [3] para gerar um arquivo de EZ-Swap; 5. De um duplo clique no nome do arquivo (destacado em vermelho na Figura 8). Com isso esta parte da tela fica com o fundo preto e o PuTTY automaticamente PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 11 copia essa string para a área de transferência, numa operação equivalente à combinação de teclas CTRL + C. Figura 8 - EZ-Swap com o PuTTY. 6. Acesse o menu do terminal clicando no ícone no canto superior esquerdo; 7. Acesse a opção “Text Transfer” depois “Start Capturing Text”. Aparece uma caixa de diálogo para selecionar o nome do arquivo; 8. Coloque o cursor na caixa de texto com o nome do arquivo; 9. Pressione as teclas CTRL +V para colar o nome gerado pelo firmware do transmissor; 10. Clique em “Salvar”; 11. O PuTTY volta para sessão de terminal; 12. Pressione [ENTER]; 13. Quando for informado, pare a captura de texto acessando o ícone do menu no canto superior esquerdo, escolhendo a opção “Text Transfer” depois “Stop Capturing Text”; 14. Pressione [ENTER] no terminal; 15. Pressione [ESC] seguidas vezes até retornar a tela inicial; 16. O EZ-File foi gerado, agora é necessário verificá-lo; 17. Pressione a tecla [5] para acessar o menu do EZ-Swap; 18. Pressione a tecla [1] para acessar o menu de verificação do arquivo de EZ- Swap; PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 12 19. Se preferir, use a tecla [1] para ligar ou desligar a impressão de logs durante a checagem; 20. Pressione a tecla [3] para prosseguir para a checagem do arquivo; 21. Leia as instruções da tela; 22. Pressione [ENTER]; 23. Acesse o menu no canto superior esquerdo, entre na opção “Text Transfer” e depois “Start Sending Text”. Aparece uma caixa para seleção de arquivo; 24. Escolha o arquivo gerado no passo 5; 25. Ao final da checagem, não devem ser exibidos erros (ERR) nem warnings (WRN). Após este passo, a verificação do EZ-File está concluído. PuTTY: terminal serial para o transmissor 2710 Manual do Usuário 13 3 Referências http://www.chiark.greenend.org.uk/~sgtatham/putty/ http://www.chiark.greenend.org.uk/~sgtatham/putty/