SIDECC_R

Este bloco é responsavel por formatar e enviar um pacote HTTP via o canal de comunicação especificado, receber e processar a resposta. A requisição é um envio de dados para o servidor SIDECC_R, gerenciado pelo DAEE-SP para monitoração e controle de recursos hídricos conforme disposto na portaria DAEE no 6987 de 18 de dezembro de 2018.

Quando ativado o bloco formata uma solicitação HTTP com as seguintes informações:

  • USUARIO

  • MEDIDOR

  • VAZÃO

  • DATA/HORA

  • CHAVE

Estes dados se corretamente formatados e previamente cadastrados, são recebidos pelo servidor do SIDECC_R e salvos retornando um código indicando o resultado do processo.

Para operação correta, o canal de comunicação utilizado para acesso ao servidor do SIDECC-R deve ser previamente configurado para operação com protocolo ASCII, sem SOF, EOF com recurso de ponto a ponto estendido desabilitado.

Importante

O tamanho da cache do canal de comunicação utilizado para acesso ao servidor do SIDECC-R deve ser de no mínimo 700 bytes.

Bloco

                   SIDECC_R
           +----------------------+
  BOOL ----|START             DONE|---- BOOL
           |                      |
  REAL ----|FLOW            RESULT|---- INT
           |                      |
    DT ----|TS           HTTP_RESP|---- INT
           |                      |
STRING ----|COMM_SRC   SIDECC_RESP|---- INT
           |                      |
STRING ----|RESP_TMO              |
           |                      |
STRING ----|USER ---------------- |----
           |                      |
  UINT ----|METER --------------- |----
           |                      |
   INT ----|KEY ----------------- |----
           +----------------------+

Parâmetros

Nome

Classe

Tipo

Dim.

V. Ini.

Descrição

START

Entrada

BOOL

FALSE

Ativa o processo de transmissão de dados para o SIDEC-R

FLOW

Entrada

REAL

Vazao instantanea (m3/s ou l/s)

TS

Entrada

DT

Timestamp do valor a ser transmitido

USER

Entrada/Saída

STRING

:*

Nome do usuário cadastrado no SIDECC-R

METER

Entrada/Saída

STRING

:*

Identificação do medidor cadastrado no SIDECC-R

KEY

Entrada/Saída

STRING

:*

Chave de acesso obtida no cadastro no SIDECC-R

COMM_SRC

Entrada

UINT

2

Canal de comunicacao associado ao bloco para envio da requisicao

RESP_TMO

Entrada

INT

5000

Timeout em ms para resposta da requisicao enviada

DONE

Saída

BOOL

FALSE

Notifica o fim de processo de transmissão

RESULT

Saída

INT

0

Código de retorno do ultimo processo de comunicação

HTTP_RESP

Saída

INT

-1

Código da mensagem retornada pelo servidor PROTOCOL HTTP

SIDECC_RESP

Saída

INT

-1

Código da mensagem retornada pelo servidor SIDECC-R

START

Quando ativado inicia o processo de transferencia do dado de vazão para o servidor. Atua na borda de subida. A entrada deverá ser desativada e ativada novamente para que uma nova transação seja iniciada.

FLOW

Especifica o valor da vazão a ser enviada para o servidor do SIDECC_R. Este valor é enviado para o servidor formatado com 3 casas decimais confome especificação do DAEE.

TS

Especifica o timestamp em UTC, associado ao valor de vazão especificada. Ao ser enviado para o servidor SIDECC_R o timestamp é formatado no padrao ISO 8601, confome especificação do DAEE.

COMM_SRC

O canal de comunicação utilizado é especificado por um identificador (valor numérico) conforme indicado na tabela a seguir:

Nome

Ident.

Descrição

HILS.COM1_PORT_ID

0

Canal serial COM1

HILS.COM2_PORT_ID

1

Canal serial COM2

HILS.COM3_PORT_ID

2

Canal serial COM3

HILS.COM4_PORT_ID

3

Canal serial COM4

HILS.COM5_PORT_ID

4

Canal serial COM5

HILS.COM6_PORT_ID

5

Canal serial COM6

HILS.COM7_PORT_ID

6

Canal serial COM7

HILS.COM8_PORT_ID

7

Canal serial COM8

HILS.SOCK0_PORT_ID

8

Controlador Ethernet 1: Socket 0

HILS.SOCK1_PORT_ID

9

Controlador Ethernet 1: Socket 1

HILS.SOCK2_PORT_ID

10

Controlador Ethernet 1: Socket 2

HILS.SOCK3_PORT_ID

11

Controlador Ethernet 1: Socket 3

HILS.SOCK4_PORT_ID

12

Controlador Ethernet 1: Socket 4

HILS.SOCK5_PORT_ID

13

Controlador Ethernet 1: Socket 5

HILS.SOCK6_PORT_ID

14

Controlador Ethernet 1: Socket 6

HILS.SOCK7_PORT_ID

15

Controlador Ethernet 1: Socket 7

HILS.ETH2_SOCK0_PORT_ID

16

Controlador Ethernet 2: Socket 0

HILS.ETH2_SOCK1_PORT_ID

17

Controlador Ethernet 2: Socket 1

HILS.ETH2_SOCK2_PORT_ID

18

Controlador Ethernet 2: Socket 2

HILS.ETH2_SOCK3_PORT_ID

19

Controlador Ethernet 2: Socket 3

HILS.ETH2_SOCK4_PORT_ID

20

Controlador Ethernet 2: Socket 4

HILS.ETH2_SOCK5_PORT_ID

21

Controlador Ethernet 2: Socket 5

HILS.ETH2_SOCK6_PORT_ID

22

Controlador Ethernet 2: Socket 6

HILS.ETH2_SOCK7_PORT_ID

23

Controlador Ethernet 2: Socket 7

Este texto pode ser utilizado como parâmetro pois esta definido no tipo COMM_CHAN_ID disponível na biblioteca HI_STD.

Cada equipamento possui um sub-conjunto dos recursos de comunicação indicados na tabela acima. Para identificar quais recursos estão disponíveis em um dado equipamento, consulte o manual do mesmo.

RESP_TMO

Define um valor de timeout em milisegundos a ser aguardado para conclusão do processo. Caso o tempo de processamento do bloco ultrapassar este valor o processo é cancelado e retornado o código de erro 6 = GL_CMD_TMO.

USER

Especifica o nome do usuário associado a conta do SIDECC. Este valor é definido no processo de registro do equipamento no sistema SIDECC.

METER

Especifica o nro do meditor utilizado na leitura da vazão. Este valor é definido no processo de registro do equipamento no sistema SIDECC.

KEY

Especifica a chave associada o registro o sistema no SIDECC. Este valor é gerado pelo sistema SIDECC_R durante o processo de registro do equipamento.

DONE

Após a ativação do bloco pela entrada START, esta saída será ativada no final do processamento do bloco. Quando ativa, o resultado do processo pode ser obtido na saída RESULT.

Quando a entrada START for desativada, esta saída se manterá inativa.

RESULT

Esta saída fornece o resultado de um processo de envio de dados pelo bloco. Após a ativação do bloco pela entrada START, a conclusão do processo é sinalizada pela ativação da saída DONE. A partir deste instante o resultado do processo estará disponível para avaliação na saída RESULT. O valor zero indica sucesso no processo. Valores diferentes de zero indicam falha no processo.

Quando a entrada START for desativada, esta saída será alterada para o valor zero.

A tabela a seguir apresenta alguns códigos de erro com as prováveis causas

Código

ID

Provavel causa do problema

6

GL_CMD_INV

Canal de comunicação associado nao esta configurado como ASCII

36

RE_INV_CFG

Canal de comunicação com cache de dados menor que 700 bytes

70

CO_COMM_ERR

Canal do modem configurado com ponto a ponto estendido.

Para mais informações sobre os códigos de retorno consulte RET_CODE - Códigos de retorno do firmware G5.

HTTP_RESP

Esta saída apresenta o resultado do processo de requisição HTTP realizado. O valor 200 indica que a requisição HTTP enviada pelo equipamento foi processada com sucesso pelo servidor SIDECC-R. Note que a requisição HTTP trata com sucesso não significa que o dado foi processado corretamente pelo servidor. Esta informação pode ser obtida na saída SIDECC_RESP. Se este valor for diferente de 200 indica falha na transação HTTP e portanto o dado enviado não foi processado pelo servidor SIDECC-R. Nesta situação a saída SIDECC_RESP irá retornar -1.

SIDECC_RESP

Esta saída apresenta o resultado final do processo de envio dos dados. Se o valor retornado for >= 0 indica o código de retorno especificado pelo servidor SIDECC-R ou seja os dados enviados chegaram até o servidor e foram processados. O retorno igual a 0 indica sucesso no envio de dados. A tabela abaixo apresenta os possíveis códigos de erro retornados pelo servidor segundo 0 “COMUNICADO DE ORIENTAÇAO PARA TRANSMISSÃO REMOTA (COT-R) COT-R BMT GERAL/2023”.

Código

Descrição

000

TRANSMISSÃO BEM SUCEDIDA

001

SERVIÇO DE ENVIO INATIVO

002

USUÁRIO OU CHAVE INVÁLIDO

003

MEDIDOR INVÁLIDO

004

DATA/HORA INVÁLIDA

005

MINUTO/SEGUNDO INVÁLIDO

006

ERRO REGISTRANDO O VALOR, TENTE MAIS TARDE

007

OUTRO VALOR GRAVADO NO MESMO MOMENTO

008

VAZÃO INFORMADA INVÁLIDA

500

ERRO PROCESSANDO REQUISIÇÃO TENTE NOVAMENTE MAIS TARDE

999

ERRO NO PROCESSAMENTO DA REQUISIÇÃO

Quando este valor for -1 indica que houve erro no processo de conexão do modem, erro que pode ser obtido na saída RESULT ou erro na transação HTTP, erro que pode ser obtido na saída HTTP_RESP.

Ou seja, esta valor será diferente de -1 apenas se a saída RESULT for ZERO e a saída HTTP_RESP for igual a 200 (HTTP RESPONSE CODE OK).