.. include:: glb_defs.txt

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

Carregar Dados da Aplicação
#############################

+---------------+------------------------------------------+
|Caminho        |Ferramentas/Carregar de dados da aplicação|
+---------------+------------------------------------------+
|Tecla de Atalho|Nenhuma                                   |
+---------------+------------------------------------------+
|Botão          ||ico|                                     |
+---------------+------------------------------------------+

.. only:: hitec

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


Este comando permite que o usuário especifique um arquivo de inicialização de variáveis 
a ser enviado para o controlador conectado. Este arquivo permite que um conjunto de variáveis 
possa ser inicializado com valores predefinidos, obtidos de um arquivo. 

O Arquivo .MAC
****************

O arquivo .MAC é um arquivo do tipo texto (ASCII) que pode ser criado em um bloco de notas, 
com o intuito de permitir a inicialização de variáveis no controlador, com valores predefinidos. 
O arquivo .MAC pode ser criado utilizando-se qualquer editor de texto ASCII (por exemplo, o bloco 
de notas do windows). O arquivo gerado deve possuir a extensão .MAC. O valor de cada variável a 
ser inicializada no controlador é especificado no arquivo através do seguinte formato:

+-----------------------------------------------------------------------------------------------------------+
|Formato do arquivo .MAC                                                                                    |
+=====================+=====================================================================================+
|Item                 |Descrição                                                                            |
+---------------------+-------------------------------------------------------------------------------------+
|[OUTPUT_SESSION_n]   |Cria a sessão "n" para definição de um valor de uma variável. O valor de n           |
|                     |deve ser incremental iniciando com 0. Ou seja, o valor da primeira variável a ser    |
|                     |inicializada no arquivo deve estar na sessão [OUTPUT_SESSION_0], o segundo valor     |
|                     |na sessão [OUTPUT_SESSION_1] e assim sucessivamente.                                 |
+---------------------+-------------------------------------------------------------------------------------+
|!VarType=t           |Especifica o tipo de variável "t" a ser inicializada no controlador. Os valores      |
|                     |possíveis para este campo são: 0 = [R] contatos, 1 = [M] memórias inteiras (16 bits),|
|                     |2 = [D]  memórias reais e 3 = [L] memórias inteiras (32 bits). Outros valores para   |
|                     |este campo fazem com que a sessão seja ignorada.                                     |
+---------------------+-------------------------------------------------------------------------------------+
|!VarNumber=b         |Especifica o número (b) da variável a ser inicializada no controlador. A faixa de    |
|                     |valores deste campo é definida pelo tipo de variável especificada e é também função  |
|                     |do modelo de controlador utilizado.                                                  |
+---------------------+-------------------------------------------------------------------------------------+
|!SetValue=v          |Especifica o valor (v) a ser atribuído à variável especificada nesta sessão. Se o    |
|                     |tipo de variável for contato, o valor aceito é, 0 (falso) ou 1 (verdadeiro). Para    |
|                     |variáveis do tipo memória inteira (16 bits), o valor deve estar entre -32768 a 32767.|
|                     |Para variáveis do tipo memória inteira (32 bits), o valor deve estar entre           |
|                     |-2.147.483.648 a 2.147.483.647.                                                      |
+---------------------+-------------------------------------------------------------------------------------+


Comentários podem ser inseridos no arquivo, incluindo o caractere "#" no início da linha utilizada. Por exemplo,

::

  # ------------------------------------------------------------------------
  # Exemplo de uma sessão do arquivo .MAC
  # Obs: Inicie a linha com # para inserir comentários
  # ------------------------------------------------------------------------
  
  # Início de uma sessão
  
  [OUTPUT_SESSION_5]
  VarType=2
  VarNumber=320
  SetValue=98.72
  
  # Fim da sessão
  
  
 
Exemplos de Atribuições na Especificação do Arquivo .MAC 
-----------------------------------------------------------

:: 
  
  [OUTPUT_SESSION_0]
  
  VarType=1
  VarNumber=10
  SetValue=-7 
  
  [OUTPUT_SESSION_1]
  
  VarType=2
  VarNumber=20
  SetValue=1.5 
  
  [OUTPUT_SESSION_2]
  
  VarType=0
  VarNumber=5
  SetValue=1 


Como mencionado anteriormente, o arquivo gerado deve conter sessões sequenciais, 
iniciando com [OUTPUT_SESSION_0]. 
O número de sessões é limitado apenas pelo número de variáveis disponíveis no 
controlador. Ou seja, utilizando este 
recurso, é possível definir valores para todas as variáveis do controlador.

Carregando os Valores Especificados no Arquivo .MAC no Controlador
====================================================================

Para enviar os valores definidos no arquivo .MAC, selecione este comando. 
Ao ser executado, será apresentada a tela abaixo. 

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

Pressione o botão com a figura de uma pasta para selecionar o nome do arquivo 
.MAC desejado. Uma vez especificado, pressione o botão "Transfere dados para o Controlador". 
Será apresentada uma barra de progresso durante o processo de inicialização das 
variáveis especificadas no arquivo. 
Caso ocorra alguma falha no processo, será apresentada uma mensagem de Erro 
indicando o tipo de falha ocorrida.
Caso contrário, será indicado o final do processo de carrega com uma mensagem 
de sucesso.

.. raw:: pdf

    PageBreak