Controles da Machine de torra no Rostoc

Os controles da Machine permitem enviar alterações compatíveis do Roast Studio diretamente para sua Machine de torra. A disponibilidade depende da Machine compatível, da conexão e dos controles ativados nas configurações dessa Machine.

Os controles da Machine exigem o aplicativo desktop do Rostoc. Eles não estão disponíveis em web.rostoc.co.

O que os controles da Machine fazem

É útil separar quatro partes relacionadas da torra:

Capacidade	O que faz
Telemetry	Lê valores em tempo real, como temperatura do grão ou temperatura de exaustão, da Machine.
Change markers	Registra uma alteração de gás, fluxo de ar ou velocidade do tambor na Curve sem enviar nada para a Machine.
Machine controls	Envia um valor ou ação do Roast Studio para uma Machine compatível e conectada.
Automation	Faria alterações sem que cada comando fosse inserido pelo operador. O Rostoc atualmente não automatiza os controles da Machine.

Uma Machine pode fornecer telemetria sem oferecer controle direto. O suporte a controles depende do modelo exato, da conexão e da definição dos controles — não apenas da marca da Machine ou do status de suporte à telemetria.

A automação da torra é separada de tudo isso: ela marca eventos como Charge e First Crack na Curve. Ela nunca envia nada para a Machine.

Onde os controles aparecem

Quando sua Machine ativa e sua conexão oferecem suporte ao controle direto, o Roast Studio mostra os controles disponíveis para essa configuração. Dependendo da Machine, eles podem incluir:

gás ou calor
fluxo de ar ou ventilador
velocidade do tambor
temperatura ou outros setpoints
interruptores ou ações específicas da Machine

Controles deslizantes de gás, fluxo de ar e velocidade do tambor no painel de controles do Roast Studio

Painel de controles deslizantes. Cada controle é preenchido de baixo para cima com sua própria cor, com o valor atual e a unidade abaixo da trilha. A Machine selecionada e a conexão determinam quais controles e faixas de valores estão disponíveis.

O Roast Studio mostra esses controles de duas formas. Por padrão, eles aparecem como controles compactos no cabeçalho, mantendo a Curve totalmente visível:

Controles compactos da Machine no cabeçalho do Roast Studio

Controles compactos: cada controle mostra o valor atual; abra o painel para ver os controles deslizantes completos.

Expanda o painel de controles para trabalhar com controles deslizantes de altura completa lado a lado. O painel mantém os controles em colunas curtas, para que cinco ou seis controles ocupem três colunas ao lado da Curve, em vez de uma única linha longa:

Painel expandido de controles deslizantes da Machine no Roast Studio

O painel expandido reúne o controle deslizante e o valor de cada controle em um só lugar.

O valor de um controle deslizante acompanha o cursor. Aponte ou arraste pela trilha, e o valor que aquela posição definiria aparece ao lado do ponteiro; quando você solta, o Rostoc envia exatamente o valor mostrado. Um controle compacto no cabeçalho é ajustado com um arraste horizontal em qualquer ponto; o valor acompanha o arraste, e o comando é enviado uma vez, quando você solta.

Se os controles não aparecerem, ainda é possível registrar alterações usando os Machine change markers no Roast Studio. Esses marcadores documentam o que aconteceu durante o Batch, mas não operam a Machine.

Controles de setpoint

Algumas Machines são controladas por um setpoint de temperatura, em vez de uma saída direta: você define o alvo, e o próprio controlador da Machine trabalha para mantê-lo. Quando o arquivo de configurações importado de uma Machine define um controle deslizante de setpoint, o Rostoc disponibiliza um controle de setpoint real no Roast Studio — a Sweet Coffee Italia Gemma é um exemplo.

Um setpoint aparece na Curve de forma diferente de uma saída:

O setpoint informado pela Machine aparece no gráfico de temperatura como uma linha tracejada em degraus. Como um termostato, ele mantém o valor até que você o altere — um degrau, nunca uma inclinação — diferenciando-se das curvas sólidas de medição.
As alterações de setpoint não adicionam marcadores de eventos separados à Curve. A linha tracejada é o registro, e as temperaturas do grão e de exaustão mostram como a Machine a acompanhou.

Quando um valor está fora da escala

Uma Machine pode informar um valor fora da faixa configurada de um controle. O Rostoc mostra isso com precisão, em vez de fingir que o valor está em uma das extremidades da escala:

O controle deslizante oculta sua alça, em vez de posicioná-la em um ponto que a Machine nunca informou. O número abaixo da trilha ainda mostra a leitura real, e arrastar pela trilha continua funcionando normalmente.
Na Curve, um alvo fora da escala é desenhado na borda do gráfico com um pequeno marcador triangular identificado com o nome do controle e seu valor real — por exemplo, Limit: 600 na borda superior. A linha ainda mostra quando o alvo mudou; passe o cursor sobre o marcador ou a linha para ver os números exatos.

Ativar e mostrar controles

Cada controle tem dois interruptores nas configurações da sua Machine, em Machines → Configure → Controls:

Enable — um controle desativado não pode gravar na Machine.
Show — um controle oculto permanece configurado, mas não aparece no Roast Studio.

Enable all machine controls e Show all machine controls alteram todos os controles de uma vez. Esses interruptores são necessários, mas não suficientes: cada controle também tem um status de revisão, e somente controles revisados como executáveis para sua Machine e conexão exatas podem enviar comandos.

Quando você aceita configurações atualizadas para uma Machine e elas trazem novos controles, esses controles chegam desativados. Suas configurações de conexão e suas escolhas permanecem exatamente como estão, e nada novo pode gravar na Machine até que você o ative — o interruptor pertence a você.

Antes de usar o controle direto

Confirme todos os itens a seguir antes de enviar um comando:

O modelo exato e a conexão oferecem suporte ao controle direto. Consulte o catálogo de Machines.
A Machine correta está ativa e conectada na tela Machines.
Os controles necessários estão definidos como Enable e Show nas configurações de Controls dessa Machine.
Nenhum outro aplicativo de computador ou cliente de controle remoto está gravando pela mesma conexão da Machine.
Você consegue alcançar imediatamente os controles físicos da Machine e o botão de parada de emergência.

Trate o Rostoc como uma superfície de controle dentro do sistema de torra. Continue observando a Machine e seus próprios indicadores durante todo o Batch.

Enviar uma alteração de controle

Abra o Roast Studio com a Machine compatível ativa.
Selecione o controle que deseja alterar.
Insira ou ajuste o valor dentro da faixa mostrada. Um controle deslizante envia o valor quando você solta, usando o valor exibido. Um controle no cabeçalho envia quando você solta o arraste ou um passo por vez ao pressionar as teclas de seta. Um editor numérico envia quando você pressiona Enter. Interruptores e botões de ação enviam ao serem clicados.
Observe o controle na tela e a Machine física enquanto o comando é enviado.
Enquanto o Rostoc envia o comando, o controle fica temporariamente desativado. Se o Rostoc informar um erro, pare e verifique a Machine. Em todos os casos, confirme que a Machine responde conforme esperado.

O Rostoc envia um comando da Machine por vez. Um comando pendente impede temporariamente outra gravação. Se um comando for recusado ou falhar, o controle na tela retorna à posição exibida anteriormente. Isso não significa que a Machine física foi revertida; inspecione a Machine e use os controles físicos, se necessário.

Você também pode usar os atalhos de teclado dos controles da Machine para selecionar um controle, ajustar um valor numérico e enviá-lo sem tirar as mãos do teclado.

Entender os resultados dos comandos

O Rostoc acompanha internamente os seguintes estados de comando para diagnóstico. Um comando bem-sucedido atualmente não tem um selo de confirmação persistente; portanto, sempre confirme o resultado na Machine:

Pending — o Rostoc está enviando o comando.
Acknowledged — a conexão da Machine aceitou a gravação. Isso nem sempre comprova que o mecanismo físico alcançou a posição solicitada.
Confirmed — a telemetria disponível correspondeu ao valor solicitado dentro da tolerância configurada. Isso ainda não comprova que todos os mecanismos físicos se moveram conforme esperado.
Uncertain — o Rostoc não recebeu um retorno correspondente dentro do tempo esperado.
Failed ou rejected — o Rostoc não recebeu um resultado bem-sucedido e mostra um erro. O controle na tela retorna à posição exibida anteriormente; isso não significa que a Machine foi fisicamente revertida.

Independentemente do que a Machine faça com um comando, a alteração feita é registrada uma vez na Curve, no momento em que você a realiza:

Se a Machine aceitar um comando, mas continuar informando o valor anterior, sua alteração ainda aparecerá na Curve. O marcador registra o que você fez; a telemetria mostra o que a Machine realmente fez.
Para alguns controles, o único retorno disponível é a Machine repetir o comando. O Rostoc registra essa alteração uma vez, a partir do próprio comando, e não conta a repetição como uma segunda alteração separada.

Nem toda Machine fornece retorno de controle. Quando um controle só pode ser reconhecido, confirme o resultado usando a tela, os indicadores e a resposta física da própria Machine.

Verificações de segurança integradas

Antes que uma gravação chegue à Machine, o Rostoc verifica se:

o controle foi revisado e aprovado para execução
o controle está ativado nas configurações da Machine selecionada
o comando corresponde à Machine selecionada e à interface conectada
o valor solicitado está dentro da faixa definida para o controle
a solicitação é atual e respeita o intervalo mínimo configurado do controle, quando definido
outro comando da Machine não está sendo gravado

Essas verificações reduzem comandos acidentais ou inválidos. Elas não substituem os procedimentos operacionais do fabricante da Machine nem o julgamento do operador.

Operar com segurança

Mantenha os controles físicos da Machine e o botão de parada de emergência desobstruídos e acessíveis.
Não use o Rostoc e outro aplicativo de controle ao mesmo tempo.
Observe a Machine após cada comando, especialmente quando o retorno estiver indisponível.
Se a Machine não responder conforme esperado, pare de enviar comandos e use os controles físicos.
Teste os controles em uma configuração que não seja de produção antes de confiar neles durante um Batch.
Siga os limites, as orientações de manutenção e os procedimentos de emergência do fabricante da Machine.

Os controles da Machine são orientados pelo operador. O Rostoc não segue automaticamente um Plan ou uma Reference Curve e não faz alterações de controle por conta própria.

Se os controles estiverem indisponíveis

Primeiro, confirme se a Machine ativa está conectada. Depois, consulte a página da Machine no catálogo para verificar o suporte ao controle direto. Um modelo listado como compatível com dados em tempo real ainda pode ser somente leitura.

Se a Machine estiver desconectada ou um comando falhar, use a solução de problemas de conexão. Para dúvidas sobre acesso ou compatibilidade, fale conosco informando a marca e o modelo da Machine, o tipo de conexão e o controle que deseja usar.