.. include:: glb_defs.txt

.. |ico| image:: ../shared_img/_cmd/d9.png

.. _`Log de Variáveis`:

Log de Variáveis
###################

.. rst-class:: tbst

+----------------+----------------------------+
|Caminho         |Supervisão/Log de Variáveis |
+----------------+----------------------------+
|Tecla de  Atalho|Nenhum                      |
+----------------+----------------------------+
|Botão           ||ico|                       |
+----------------+----------------------------+

.. only:: hitec

 +--------------------------------------------------+
 |:ref:`compatibilidade de firmware`                |
 +-------------------+------------------------------+
 |Geração de Firmware|GI, GII, GII-DUO, G3, G3S, G3R|
 +-------------------+------------------------------+


Este painel permite especificar blocos de variáveis a serem lidos e salvos em
disco para posterior análise. 

A tela de :ref:`Log de Variáveis` possui o seguinte formato:

.. image:: _img/superv_dump_variav_control.png
      :width: 60%
      :align: center


O arquivo gerado é do tipo **.CSV** (comma separeted
variable) e formata cada variável em uma linha do seguinte modo:


.. rst-class:: tbiv

 ===  ======  ===  ===
  T    nnnn    S    V
 ===  ======  ===  ===

Onde:

.. rst-class:: tbiv
  
  ======  ===   ========================================================================
   T       :    Tipo de variável obtida, podendo ser R, M, D ou L.
   nnnn    :    Número da variável obtida (sempre formatado em 4 dígitos).
   S       :    Separador de campos (caractere indicado no campo 
                **Separador de Lista** da tela). Valor da variável obtida
   V       :    (o formato depende do tipo de variável especificado). O contatos 
                retornam o valor 0 (falso) ou 1 (verdadeiro).
  ======  ===   ========================================================================
   
   
Exemplo:

.. rst-class:: tbiv
  
  =====================   ==========================================================
   M0005, 123             Leitura da memória inteira 5 com valor obtido de 123 com 
                          o separador de vírgula
  =====================   ==========================================================
  

Inicialmente, no campo **Habilitação das Variáveis**, clique nos tipos de
variáveis a serem obtidas, selecionando o endereço inicial e a quantidade a
partir deste endereço. Opcionalmente, para as variáveis do tipo *Memórias
Inteiras*, *Memórias Reais* e *Memórias Longas*, é possível especificar se os valores armazenados
serão salvos em formato decimal ou hexadecimal. 

Uma vez definidos os blocos de memória, clique no campo intitulado  **Arquivo**
e selecione na tela apresentada, um local e nome para o arquivo a ser salvo.
O nome completo do arquivo especificado será apresentado no campo.
No campo **Separador** especifique o caractere utilizado no arquivo como
separador dos valores obtidos.

No campo **Precisão** para memórias D especifique o número de casas decimais a serem
utilizadas para salvar os valores reais.

No campo **Opções do Arquivo** especifique se o arquivo a ser gerado é novo (elimina o
arquivo se o mesmo já existe no computador) ou se os valores obtidos serão
adicionados ao arquivo já existente.

Pressione o botão **Cria Arquivo de Log** para produzir o arquivo configurado.

O arquivo gerado pode ser visualizado pressionando-se o botão **Visualiza Log**

.. tip::

   Os arquivos gerados neste formato podem ser lidos por planilhas
   (ex. Microsoft Excel) diretamente em forma de tabela. Caso os valores
   lidos estejam em uma única coluna, altere o tipo de separador em função
   da configuração utilizada na sua planilha.


.. raw:: pdf

    PageBreak