.. include:: glb_defs.txt .. _`SS2S - Servidor de comunicação para o protocolo SCP-HI`: SS2S - Servidor de comunicação para o protocolo SCP-HI ######################################################### O módulo SS2S é um servidor de comunicação desenvolvido para o protocolo de aplicação SCP-HI. Pode rodar como uma aplicação iconizada ou um serviço do windows. Possui suporte para gerenciamento de múltiplos drivers de comunicação (até 32) podendo operar via rede ethernet (com protocolos de transporte TCP/IP ou UDP) ou utilizando canais seriais (RS232-C ou RS485). Ícone de interface ******************** O SS2S possui um ícone que foi idealizado para fornecer várias informações de configuração e status operacionais. Quando ativado como uma aplicação windows, o servidor roda em background com um ícone apresentado no taskbar. A figura a seguir define o símbolo utilizado para representar o SS2S e identifica os módulos funcionais representados na figura. .. figure:: _img/ss2s_icone.jpg :align: center Fig. Ícone do SS2S +--------------+----------------------------------------------------------------+ |Módulo |Descrição | +--------------+----------------------------------------------------------------+ |Drivers |Responsável por implementar os mecanismos de acesso de I/O aos | | |equipamentos e toda gerência de Tag´s registrados. | +--------------+----------------------------------------------------------------+ |Clientes |Qualquer aplicação na rede que utiliza o SS2S. | +--------------+----------------------------------------------------------------+ |Servidor local|Responsável por aceitar conexões de clientes e prover o link | | |entre o mesmo e os drivers disponáveis. | +--------------+----------------------------------------------------------------+ Operação do SS2S como serviço ****************************** O servidor SS2S pode operar como serviço para executar sem a necessidade de um usuário logado. Com esta configuração, o SS2S pode ser executado em um servidor, podendo este ser acessado através de outro computador. O nome do serviço é **SS2S** e, para acessá-lo, deve-se entrar em **Painel de Controle -> Ferramentas Administrativas -> Serviços**. Se o SS2S estiver instalado no computador, a configuração do serviço poderá ser acessada conforme demonstrado na figura a seguir: .. figure:: _img/serv_ss2s.jpg :align: center Fig. Operação como serviço do SS2S Para que a operação do SS2S como serviço seja automática (disparando sua execução na inicialização do sistema operacional), deve-se entrar nas propriedades deste item clicando sobre o item SS2S com o botão direito do mouse. Na tela que será aberta, deve-se escolher no Tipo de inicialização, a opção Automática conforme apresentado na figura a seguir: .. figure:: _img/ss2s_autom.jpg :align: center Fig. Inicialização do SS2S automática Após estes passos, o tipo de inicialização deverá ser alterado para "Automático" e, na próxima inicialização do computador, o SS2S já deverá iniciar automaticamente. .. _`Parâmetros de linha de comando`: SS2S - Parâmetros de linha de comando *************************************** O SS2S possui um conjunto de parâmetros que podem ser informados para a aplicação na sua ativação. Estes parâmetros são denominados "Parâmetros de linha de comando". Estes parâmetros podem ser passados para o SS2S de 2 formas básicas como descrito a seguir. Ativação do SS2S via prompt de comando ========================================== Para passar parâmetros para o SS2S via prompt de comandos abra uma caixa de comando, digitando a palavra **cmd.exe** na caixa de diálogo apresentada no menu principal do windows |N|. Uma vez ativado o prompt de comando, utilizando o comando **CD** vá para o diretório onde está localizado o aplicativo a ser executado. Uma vez no diretório do aplicativo ative o mesmo especificando o seu nome seguido dos parâmetros de linha de comando desejados conforme apresentado no exemplo a seguir: :: app.exe parm1 parm2 ... .. rst-class:: tbobs ===== =========================================================================== |obs| Dependendo do tipo de comando a ser executado será necessário que o prompt de comandos seja aberto com privilégio de administrador. Veja a seção :ref:`Registro do SS2S no sistema operacional ` para mais informações. ===== =========================================================================== Ativação do SS2S via link =========================== Para passar parâmetros para o SS2S via link, crie um link do aplicativo no desktop utilizando o comando de **copiar** e **colar como link**. Uma vez criado o link para o aplicativo, clique com o botão direito do mouse no menu apresentado e selecione a opção **Propriedades**. Na aba **Atalho**, identifique o campo **Destino**, acrescentando no final do mesmo os parâmetros desejados conforme ilustrado na figura a seguir. .. figure:: _img/cmd_parms_link.jpg :align: center Fig. Definindo parâmetros de linha de comando em um link Feche o diálogo através do botão OK e em seguida ative a aplicação pelo link criado. As próximas sessões apresentam os parâmetros que podem ser utilizados com o SS2S com sua respectiva funcionalidade. Múltiplos parâmetros podem ser especificados na linha de comando quando necessário. .. _`Registro do SS2S no sistema operacional [ -r ]`: Registro do SS2S no sistema operacional [ -r ] =================================================== Este parâmetro especifica para a aplicação criar uma entrada no registro do windows informando sua localização no computador. Esta chave é criada em "HKEY_LOCAL_MACHINE\\Software\\Company\\Application\\V.M\\" onde: =============================== ================================================================== Path parcial Descrição ------------------------------- ------------------------------------------------------------------ HKEY_LOCAL_MACHINE\\Software\\ Entrada de registro padrão do Windows. Company\\ Especifica o nome do desenvolvedor da aplicação. Application\\ Especifica o nome do pacote de software. V.M\\ Especifica a versão "V" e revisão maior "M" do pacote de software. =============================== ================================================================== Nesta chave é salvo o path completo do arquivo executável principal do pacote. Para executar este comando, abra um prompt de comando do windows. No caso do Windows Server 2003, 2008 e Windows 7, o prompt de comando deve ser aberto com privilégio de administrador conforme indicado na figura a seguir. .. figure:: _img/cmd_parms_prompt.jpg :align: center Fig. Ativação do prompt como administrador Uma vez aberta a tela de comandos, vá para o diretório onde está instalado o arquivo SS2S.exe e digite: :: SS2S -r Após a execução deste comando o SS2S é fechado. O resultado do processo de registro é salvo no arquivo de log de ScpServerII.log. Para verificar o resultado, após executar o comando abra o arquivo ScpServerII.log e vá para o final do arquivo onde deverá estar registrado o resultado do tratamento do comando. Remoção do registro do SS2S do sistema operacional [ -u ] ============================================================== Este parâmetro especifica para a aplicação remover a entrada no registro do windows que identifica a localização da aplicação no computador. Esta chave é criada em "HKEY_LOCAL_MACHINE\\Software\\Company\\Application\\V.M\\" através do parâmetro -r. Para executar este comando, abra um prompt de comando do windows. No caso do Windows Server 2003, 2008 e Windows 7, o prompt de comando deve ser aberto com privilégio de administrador conforme indicado na figura a seguir. .. figure:: _img/cmd_parms_prompt.jpg :align: center Fig. Ativação do prompt como administrador Uma vez aberta a tela de comandos, vá para o diretório onde está instalado o arquivo SS2S.exe e digite: :: SS2S -u Após a execução deste comando o SS2S é fechado. O resultado do processo de remoção do registro é salvo no arquivo de log de ScpServerII.log. Para verificar o resultado, após executar o comando abra o arquivo ScpServerII.log e vá para o final do arquivo onde deverá estar registrado o resultado do tratamento do comando. Especificando o arquivo de projeto a ser utilizado [ "-o" ] ============================================================== Por default, quando o SS2S é ativado este procura no arquivo de configuração (ss2.sxf) pelo diretório de projetos e carrega o projeto (arquivo .s2p) especificado durante o último processo de carga da aplicação realizada através do monitor SS2M. Existe também a possibilidade de ativar o SS2S especificando o arquivo de projeto (.S2P) a ser utilizado. Neste caso o parâmetro "-o" deve ser utilizado na linha de comando juntamente com o path relativo ao diretório de instalação do SS2S. Para utilizar este recurso abra um prompt de comando, vá para o diretório onde está instalado o arquivo SS2S.exe e digite por exemplo: :: SS2S -o projects\demo.s2p # para ativar o SS2S e carregar o projeto demo.s2p localizado na pasta projects # Note que no exemplo a pasta Projects esta localizada no diretório de instalação do SS2S. .. rst-class:: tbobs ===== =============================================================================== |obs| O SS2S salva o nome do projeto corrente no instante que o mesmo é fechado para que na próxima ativação este projeto possa ser automaticamente carregado. Quando um projeto é carregado via linha de comando através do parâmetro "-o", este recurso de salvar o projeto corrente é desativado. Desta forma, para persistir o nome do projeto carregado no SS2S utilize o comando de carga do projeto no Monitor do ScpServerII (SS2M). ===== =============================================================================== Definindo a porta de escuta do servidor [ -p ] ================================================= Para especificar a porta de escuta utilizada pelo SS2S para acesso pelos clientes utilize o parâmetro "-p" seguido do valor da porta a ser utilizada para esta funcionalidade. Quando especificado deve-se fornecer logo após o parâmetro, o valor da porta (em decimal) na faixa de 1 a 65535. Para utilizar este recurso abra um prompt de comando, vá para o diretório onde está instalado o arquivo SS2S.exe e digite por exemplo: :: SS2S -p 2700 # para ativar o SS2S escutando na porta 2700 .. rst-class:: tbobs ===== ============================================================================== |obs| O valor da porta especificado é automaticamente salvo no arquivo de contexto do SS2S de forma que nas próximas vezes que o mesmo for ativado (mesmo sem parâmetros de linha de comando) este valor será utilizado. A definição deste parâmetro também é possível de ser realizada através do Monitor do ScpServerII (SS2M). ===== ==============================================================================