Receitas

Os setpoints que uma execução escreve: um conjunto instantâneo aplicado no Início, ou um perfil temporizado de Degrau, Rampa e Patamar, cada um com o bloco de finalização que toda execução escreve ao terminar.

Uma receita escreve os canais graváveis do modelo. Uma receita instantânea é um conjunto de setpoints aplicado uma vez, quando uma execução começa; uma receita temporizada é um perfil ordenado de segmentos de Degrau, Rampa e Patamar, conduzido pelo relógio da própria execução. As duas podem terminar num bloco de finalização, o estado seguro escrito sempre que a execução termina. Toda escrita passa pelo único funil de escrita registrado em diário e é gravada no arquivo da execução como executada. As receitas vivem em Process > Modelos > modelo > Preparação > Receitas e exigem a permissão Editar receitas e avaliações.

A pasta Receitas

Selecionar a linha Receitas abre a página da pasta ("Valores de setpoint que um procedimento aplica quando uma execução começa, escritos pelo funil único e gravados como executados.") com um cartão por receita, por nome; clicar num cartão o abre, e o X o remove. Sem nenhuma, a página diz "Nenhuma receita ainda. Acrescente uma."

A página da receita

O cabeçalho carrega o nome, a frase "Valores de setpoint que um procedimento aplica quando uma execução começa, escritos pelo funil único e gravados como executados." e uma pílula com o tipo. Todo campo salva sozinho, e toda edição redesenha a prévia do perfil.

Definição

Valores

Setpoints e alvos são digitados como texto e convertidos para o tipo do canal quando são aplicados, na cultura invariante:

Um literal que não cabe no tipo do canal nunca é escrito: a escrita é gravada como falha no arquivo da execução e tratada pela regra de falha. Toda grade de linhas de canal desta página oferece a uma linha apenas os canais graváveis que as outras linhas da mesma grade não tomaram, então um canal é escrito uma vez por conjunto e uma vez por segmento; quando todo canal gravável está tomado, o botão que acrescenta uma linha fica cinza com "Todo canal gravável já tem um setpoint aqui." (ou "… um alvo neste segmento."), e sem nenhum canal gravável, com "Este modelo ainda não tem canais graváveis."

Uma receita instantânea

Dois cartões independentes, cada um encabeçado por um botão Setpoint que acrescenta uma linha no primeiro canal gravável livre, com o valor 0:

As duas grades compartilham as mesmas colunas:

Uma receita temporizada

A forma temporizada desenha primeiro o perfil, depois os segmentos ao lado daquele escolhido neles, e depois o bloco de finalização.

Perfil temporizado

O gráfico é a própria receita: uma série por canal numérico que os segmentos miram, rotulada <nome> [<unidade>], desenhada como a curva por partes que os segmentos constroem (um Degrau salta e se mantém, uma Rampa inclina a partir do valor que chega nela, um Patamar ou um segmento sem alvo se mantém), sobre o tempo acumulado em segundos. Um alvo num canal que não é numérico não é desenhado. O gráfico carrega a barra de ferramentas que todo gráfico tem e pode ser aberto numa janela própria (veja Gráficos); a página do procedimento desenha o mesmo perfil sob o estágio Aplicar dela.

Segmentos

A lista é encabeçada por Segmentos, e o botão Segmento dela acrescenta um Degrau de 60000 ms sem alvos e o escolhe. Clicar numa linha a abre na coluna Alvos do segmento; sem nada escolhido, a coluna diz "Selecione um segmento para editá-lo inteiro num lugar só, com os alvos até os quais ele conduz."

A coluna, encabeçada por Segmento <n> · <Tipo>, repete os três campos com uma legenda e o efeito do valor em vigor sob cada um:

Sob eles, ALVOS guarda os alvos do segmento, com um botão Alvo no cabeçalho da coluna que acrescenta uma linha no primeiro canal gravável que o segmento ainda não conduz, em 0. Num Patamar a grade é substituída pela frase "Um patamar segura os valores que o perfil já alcançou, então ele não conduz alvo próprio." e o botão fica cinza, dizendo "Um patamar segura os valores já alcançados. Mude o tipo para conduzir um alvo aqui."; os alvos que um Patamar carrega de um tipo anterior continuam guardados e são ignorados pela execução, pela prévia do perfil e pela folha de percurso do mesmo jeito:

Em caso de falha

A regra de falha se aplica a uma receita temporizada quando uma escrita é recusada ou um valor de que ela precisa está ilegível:

Finalização (estado seguro)

O mesmo cartão da receita instantânea, "Escritos sempre que a execução termina: conclusão, parada ou aborto.", com o botão Setpoint e a grade próprios dele.

Onde uma receita é usada

O que uma execução faz com ela

No Início, a execução toma posse de toda origem que a receita escreve, pela duração inteira dela, então um Início cuja receita escreve uma origem que outra execução detém é recusado pelo nome, e toda escrita vinda de outro lugar (um campo de dashboard, um script, um cliente OPC UA) nessas origens é recusada enquanto a execução as detém. Um conjunto instantâneo é escrito uma vez, no Início; um perfil temporizado é percorrido segmento a segmento no relógio da execução, e um procedimento Temporizado sem receita ainda ganha esse relógio, para que todo membro da janela comece, se repita e termine junto. Pausar congela o relógio e Retomar o solta; o datalog continua gravando durante uma pausa. Toda escrita vai para o diário com a execução como origem e é gravada no arquivo da execução como executada, então quem lê depois vê o que foi realmente escrito e quando.

O bloco de finalização é escrito sempre que a execução termina: conclusão, Parar ou Abortar. Ele não é escrito quando a própria aplicação é fechada no meio da execução: a execução não está terminando, e ela é retomada pausada no segmento e no ciclo persistidos dela, na inicialização seguinte.

Remover receita

Remover receita fica no grupo de perigo da barra de detalhe com a receita selecionada, no menu de clique direito dela, e como o X no cartão da página da pasta. Ele pergunta antes ("Excluir receita", "Isto remove a receita do modelo."). Todo procedimento que a aplicava esvazia a referência de Receita dele e vira uma execução sem receita. Ele exige Editar receitas e avaliações e fica cinza sob a trava de engenharia e o runtime parado.

O que uma receita não faz

• Ela não lê nada e não julga nada: limites são uma avaliação.
• Ela não escreve valores por unidade. Toda unidade recebe os mesmos literais nas origens vinculadas dela.
• Ela nunca repete uma escrita recusada; a regra de falha é a resposta inteira.
• Uma receita temporizada não pode ser disparada como comando único; só um procedimento roda um perfil.
• A prévia do perfil desenha apenas canais numéricos; um alvo Bool ou String é escrito, mas nunca desenhado.