Controles da Machine de torra no Rostoc

Conectar uma Machine apenas lê dela. O Rostoc não altera nada na Machine até você enviar um valor do Roast Studio. A única exceção é uma Machine que precisa de um comando quando a torra começa e termina, como o modo de torra da HB PEAK; consulte Comandos no início e no fim da torra.

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 da 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
Telemetria	Lê valores em tempo real, como temperatura do grão ou temperatura de exaustão, da Machine.
Marcadores de alteração	Registra uma alteração de gás, fluxo de ar ou velocidade do tambor na Curve sem enviar nada à Machine.
Controles da Machine	Envia um valor ou ação do Roast Studio para uma Machine compatível e conectada.
Automação	Faria alterações sem que cada comando fosse inserido pelo operador. O Rostoc não automatiza os controles da Machine durante uma torra.

Um marcador de alteração é um valor digitado por você, portanto pode ser corrigido: clique nele no gráfico e escolha Change value ou Remove, durante a torra ou depois que o Batch for salvo. Um comando enviado à Machine permanece como foi enviado, porque a Machine recebeu esse valor. Consulte detalhes do Batch.

Uma Machine pode fornecer telemetria sem oferecer controle direto. O suporte a controles depende do modelo exato, da conexão e da definição do controle — 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 à Machine.

Comandos no início e no fim da torra

Algumas Machines esperam que o software ligue ou desligue algo quando cada torra começa e termina. A HB PEAK é uma delas: o modo de torra precisa ficar ligado durante toda a torra, porque os limites de segurança da própria Machine dependem dele. Para uma Machine assim, o Rostoc envia esse comando quando você inicia uma gravação e o comando oposto quando você a para ou a cancela. Nada mais é enviado por conta própria, e o controle do modo de torra não aparece no Roast Studio.

Se o comando não chegar à Machine, a gravação continua e uma mensagem The machine was not told informa o que o Rostoc não conseguiu ligar ou desligar. Verifique a Machine antes de continuar.

Onde os controles aparecem

Quando sua Machine ativa e sua conexão oferecem suporte a 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

O painel de controles. Cada controle deslizante é preenchido a partir da parte inferior com sua própria cor, com o valor atual e a unidade sob a faixa. A Machine selecionada e a conexão determinam quais controles e intervalos de valores estão disponíveis.

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

Botões compactos de controle da Machine no cabeçalho do Roast Studio

Controles compactos: cada botão 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 fiquem em 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 faixa, e o valor que aquela posição definiria aparecerá ao lado do ponteiro; ao soltar, o Rostoc enviará exatamente o valor mostrado. Um botão compacto do cabeçalho é ajustado com um arraste horizontal em qualquer ponto dele — o valor acompanha o arraste, e o comando é enviado uma vez, ao soltar.

Se os controles não aparecerem, você ainda poderá registrar alterações com os marcadores de alteração da Machine 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 tenta mantê-lo. Quando o arquivo de configurações importado de uma Machine define um controle deslizante de setpoint, o Rostoc oferece um controle de setpoint real no Roast Studio — a Sweet Coffee Italia Gemma é um exemplo.

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

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.
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 do intervalo configurado para um controle. O Rostoc mostra isso corretamente, em vez de fingir que o valor está em uma das extremidades da escala:

O controle deslizante oculta sua alça, em vez de colocá-la em uma posição que a Machine nunca informou. O número sob a faixa continua mostrando a leitura real, e arrastar pela faixa 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.
Um marcador de alteração de gás ou fluxo de ar digitado acima de 100 % é desenhado da mesma forma, na borda superior, com seu valor real, por exemplo Gas: 156. O Rostoc pede confirmação antes de registrar esse valor, e você pode corrigi-lo no gráfico depois.

Ativar e mostrar controles

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

Enable — um controle desativado não pode escrever 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 escrever na Machine até que você o ative — o interruptor pertence a você.

Se você alterar o tipo de conexão de uma Machine, o Rostoc removerá os controles que a nova conexão não pode executar e informará isso sob o tipo de conexão antes de você salvar. Voltar ao tipo de conexão original os restaura. Consulte Alterar o tipo de conexão.

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 a controle direto. Consulte o catálogo de Machines.
A Machine correta está ativa e conectada na tela Machines.
Os controles necessários estão configurados como Enable e Show nas configurações de Controls dessa Machine.
Nenhum outro aplicativo de computador ou cliente de controle remoto está escrevendo 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 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 do intervalo mostrado. Um controle deslizante envia ao ser solto, usando o valor exibido. Um botão do cabeçalho envia ao soltar o arraste ou um passo por vez ao pressionar as teclas de seta. Um editor numérico envia ao pressionar 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 respondeu como esperado.

O Rostoc envia um comando da Machine por vez. Um comando pendente impede temporariamente outra escrita. Se um comando for rejeitado ou falhar, o controle na tela volta à posição exibida anteriormente. Isso não significa que a Machine física foi revertida; inspecione a Machine e use seus 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 não tem atualmente um indicador de confirmação persistente, portanto sempre verifique o resultado na Machine:

Pending — o Rostoc está enviando o comando.
Acknowledged — a conexão da Machine aceitou a escrita. Isso nem sempre prova 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 prova que todos os mecanismos físicos se moveram como pretendido.
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 volta à posição exibida anteriormente; isso não significa que a Machine foi revertida fisicamente.

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

Se a Machine aceitar um comando, mas continuar informando o valor antigo, 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 o próprio visor, os indicadores e a resposta física da Machine.

Verificações de segurança integradas

Antes que uma escrita alcance a 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 do intervalo definido para o controle
a solicitação é atual e respeita o intervalo mínimo configurado para o controle, quando definido
nenhum outro comando da Machine está sendo escrito

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 livres 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 não houver retorno.
Se a Machine não responder como esperado, pare de enviar comandos e use seus controles físicos.
Teste os controles em uma configuração que não esteja em produção antes de depender deles 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 direcionados 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 não estiverem disponíveis

Primeiro, confirme se a Machine ativa está conectada. Depois, consulte a página da Machine no catálogo para verificar o suporte a 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 de acesso ou compatibilidade, fale conosco informando a marca e o modelo da Machine, o tipo de conexão e o controle que você deseja usar.