FAQ da aplicação web

Abrir a aplicação

Onde abro a aplicação? Há duas formas: em webapp.rbgrid.io (Chrome ou Edge, ligando-se ao endereço do hub), ou no endereço do próprio hub, depois de ter instalado a aplicação nele. → Opening the app

O endereço do hub abre, mas não há aplicação (só uma página mínima). A aplicação web não faz parte do ficheiro de firmware. Instale no hub, uma vez, o rbgrid-ui_<version>.zip da versão, ou abra a aplicação em webapp.rbgrid.io em vez disso. → Opening the app

webapp.rbgrid.io diz que nenhum hub responde.

  • O seu computador tem de estar na mesma rede que o hub.
  • Verifique o endereço: é o endereço do hub na sua rede doméstica, não 192.168.4.1.
  • Quando o Chrome ou o Edge perguntarem se o site pode aceder a dispositivos na sua rede local, tem de permitir. Se não o fez, permita-o nas definições de site do navegador (Local network access) e ligue-se de novo.
  • Firefox e Safari ainda não foram testados: use Chrome ou Edge.

Preciso de internet para a aplicação? Em webapp.rbgrid.io, apenas para carregar a página. A aplicação instalada no hub funciona só com a sua rede doméstica. O hub usa a internet apenas para acertar o relógio; sem internet, acerte o relógio pelo navegador (Use this device's time). → Time

Os meus dados passam pelos servidores da RobotDyn? Não. Nas duas formas, a aplicação comunica diretamente com o hub, na sua rede. Em webapp.rbgrid.io, só a própria página é carregada do nosso site.

O que é o demo.rbgrid.io? Uma demonstração com sites de exemplo, para poder explorar sem um hub. Não consegue ligar-se ao seu hub.

Configuração

Posso deixar o assistente a meio? Sim. Nada fica bloqueado: salte os passos opcionais e volte mais tarde a partir de System → Setup wizard. Done lista o que falta. → Setup wizard

O assistente diz "Almost done". O que falta? O passo Done lista-o: um nome de site (que não seja "Default"), um relógio sincronizado, a sua própria tarifa e pelo menos um ponto. Cada linha tem um botão Fix.

A hora diz "not synchronized". O hub acerta o relógio pela internet (NTP). Verifique se o hub está na sua rede Wi-Fi doméstica, com internet, e escolha Sync with NTP. Sem internet, escolha Use this device's time: a partir do firmware v1.1.6, isso conta como sincronização. Num hub na v1.1.5 ou anterior, verifique primeiro uma coisa — se tiver guardado o fuso horário na aplicação, esse firmware removeu os servidores NTP no reinício seguinte e o hub nunca mais sincronizou. Atualize o hub e abra Settings → Time uma vez. → Time

Porque é que "today" e as zonas tarifárias aparecem deslocadas? O fuso horário do hub é diferente do do local onde está. Defina-o em Settings → Time. A visão geral mostra uma nota quando o fuso do hub e o do seu navegador diferem em 30 minutos ou mais.

Alterei uma definição, mas nada aconteceu. Settings tem uma barra no topo: Unsaved changes: n. Escolha Apply. Algumas definições só se aplicam após um reinício: nesse caso, o botão diz Save and restart. Alguns painéis (Security, Browser access, Hub access point, MQTT broker) gravam com o seu próprio botão. → Settings

Mudei a minha rede Wi-Fi doméstica. Como movo o hub? Em Settings, no cartão Connection: pesquise, escolha a rede, introduza a palavra-passe e escolha Save and reboot. Se o hub receber um novo endereço, abra a aplicação nele.

Tarifa e dinheiro

Porque é que o dinheiro mostra "factory example"? Ainda não foi definida nenhuma tarifa. Defina a sua no assistente (hub novo) ou em Tariffs. → Tariffs

Usei o passo de tarifa do assistente e os meus impostos e zonas desapareceram. A tarifa rápida do assistente reconstrói sempre o plano completo. Quando o hub tem um plano mais completo, próprio seu, pergunta primeiro Replace the hub's tariff?. Use-a num hub novo; para alterar um plano existente, use Tariffs.

Os encargos fixos (mensais) são contados? Não. Os custos e as previsões baseiam-se em energia: preços por kWh, impostos e taxas por kWh, e IVA.

O que significa "≈" ao lado de um montante? É a estimativa da própria aplicação às suas tarifas atuais, por exemplo o custo por hora da potência neste momento, ou uma previsão mensal. → The Overview

Se alterar a tarifa, os custos passados mudam? Não. O hub guarda o custo de cada período às tarifas então em vigor. Uma nova tarifa aplica-se a partir do momento em que a guardar.

O hub pode usar o preço horário ou de mercado do meu fornecedor? Sim, a partir da v1.2.0. O próprio hub obtém o preço do dia seguinte para a sua zona e aplica-o a cada período de 15 minutos; o seu plano tarifário continua como alternativa e fornece os encargos. O Home Assistant pode enviar preços em vez disso, se o seu fornecedor não for um dos que o hub conhece. → Where your price comes from

De repente, todos os custos parecem muito altos, e o preço em si parece correto. Um preço tudo incluído está a ser tratado como preço spot, por isso os impostos e o IVA do seu plano são somados a um preço que já os continha. Para um fornecedor de rede, o hub define a classe e você lê-a na lista de fornecedores (· all-in); para o Home Assistant, cabe-lhe a si defini-la, em What Home Assistant sends. → Dynamic prices

Um período custou menos do que zero. Isto é um erro? Não — o preço de mercado era negativo e o seu contrato repercute esse valor, por isso o hub registou um custo negativo. Se o seu contrato não repercute preços negativos, defina um Lowest buy price.

O meu fornecedor falhou e o hub continuou. O que me foi cobrado por essas horas? O que vinha a seguir na cadeia: o fornecedor de reserva, ou a taxa da zona do seu plano tarifário. O preço aplicado em cada período de 15 minutos e a sua origem são guardados durante 40 dias na página Prices, e a própria falha surge como uma linha FAIL price: no Hub log. → Events

Pontos e módulos

O que é um "ponto"? Uma linha medida, com um nome e uma função: a entrada da rede, um circuito, um aparelho, solar. Os pontos vêm dos canais de corrente dos seus módulos rbAmp. → Points

Quantos módulos e pontos o hub aceita? Até 8 módulos rbAmp (firmware do hub v1.1.2 e posteriores). O hub mantém histórico para até 12 pontos; mais pontos mostram apenas valores em tempo real.

Posso renomear um ponto? Sim, no firmware do hub v1.1.4 e posteriores. Na v1.1.3 e anteriores, em revisões do chip ESP32 anteriores à v3, um ponto renomeado podia desaparecer após o reinício seguinte, juntamente com o seu histórico: atualize primeiro o hub. → Points

Acrescentei um ponto, mas não tem histórico. Reinicie o hub: um ponto recém-associado só começa a guardar histórico após um reinício. Se as 12 posições de histórico estiverem todas ocupadas, o ponto mostra apenas valores em tempo real.

Como acrescento um segundo módulo? Points → Add a module, e depois siga o diálogo. Os módulos novos chegam todos ao mesmo endereço de fábrica, por isso a aplicação começa por retirar um módulo desse endereço por si. Ligue um módulo novo de cada vez, com o hub desligado. → Sensors and modules

O que acontece quando desassocio ou elimino um ponto? Ambas as ações fazem o mesmo: o ponto deixa de ser medido e sai da visão geral, e o seu histórico guardado no hub é apagado para sempre. Transfira-o primeiro em History (CSV), se puder vir a precisar dele. O canal do sensor fica livre e pode ser associado como um novo ponto.

A pesquisa não encontra o meu módulo novo.

  • Ligue os módulos novos um de cada vez, com o hub desligado: todos os módulos novos chegam ao mesmo endereço de fábrica, 0x50.
  • Se já houver um módulo em 0x50, o diálogo move-o primeiro para um endereço livre. Faça isso antes de ligar o novo.
  • A bus line is held low ou the module bus is stuck: um módulo pode estar sem alimentação, configurado noutro modo ou mal ligado. Ao retirar um módulo, desligue o cabo inteiro, não apenas a alimentação. → Sensors and modules

O que significa "Unmetered"? A diferença entre o que a entrada da rede mede e a soma das suas linhas medidas. Não é um dispositivo: é tudo o que nenhum ponto mede.

A entrada mostra exportação, mas não tenho solar. É muito provável que um sensor de corrente na entrada esteja virado ao contrário. Desligue a alimentação e rode o sensor no condutor (seta voltada para a casa).

Um ponto diz "sensor reversed — not metered". Um módulo Basic conta o consumo apenas num sentido. O seu sensor está virado ao contrário, por isso a carga não é contada. Rode o sensor (seta voltada para a carga).

O que significam "clipping" e "sensor limit"? A corrente está no topo, ou perto dele, da gama do sensor. Acima desse valor, as leituras são cortadas e o ponto conta menos do que consome. Instale um sensor de calibre superior.

Posso medir três fases? Sim, com um rbAmp STD-U3I3 na entrada: defina Settings → Mains como Three phase, depois Points → Use as the three-phase input, e reinicie. → Scenario: one main meter

Home Assistant e MQTT

Como faço chegar os dados ao Home Assistant? Ligue o hub a um broker MQTT em Settings → Home Assistant. O Home Assistant encontra os sensores do hub por si próprio (descoberta MQTT). → MQTT broker

Que sensores vão para o painel Energy? Os sensores de energia dos pontos ("Energy In", "Energy Out"). Settings → Home Assistant mostra uma tabela com o que escolher.

Eliminei um ponto, mas o Home Assistant continua a mostrá-lo. O hub remove do Home Assistant as entidades de um ponto eliminado, desde que esteja ligado ao broker MQTT no momento em que o elimina. Se não estava, elimine o dispositivo restante no Home Assistant (Settings → Devices & services → MQTT).

A ligação MQTT é cifrada? Sim, com um broker mqtts://: a partir do firmware v1.1.7 com um certificado de uma autoridade pública, e a partir da v1.1.8 também com a sua própria autoridade — um broker doméstico com uma CA privada ou um certificado autoassinado, o que inclui o Mosquitto no Home Assistant. Em qualquer dos casos, mantenha o broker na sua própria rede, com os seus próprios utilizadores e regras de acesso. → MQTT broker

Segurança

Preciso de um API token? É opcional, mas recomendado. Sem ele, qualquer pessoa na sua rede que abra a aplicação pode alterar as definições e a tarifa do hub. → Settings

Defini um token, e outro navegador não consegue guardar nada. O token fica guardado por navegador. Introduza-o uma vez no outro navegador (Settings → Security).

A aplicação avisa sobre o ponto de acesso do hub ou sobre o API token. A rede Wi-Fi do próprio hub ainda usa a palavra-passe de configuração, ou não há nenhum API token definido, ou ambas as situações. Os botões do aviso levam a Access-point password e API token. O aviso só desaparece quando as duas coisas estiverem feitas: sem token, o hub não diz à aplicação se a palavra-passe foi alterada.

Esqueci-me do token. Não há forma de o repor a partir da aplicação: qualquer alteração, incluindo a reposição de fábrica, exige o token. A única forma de voltar atrás é um flash limpo por USB: apague a memória flash e escreva novamente os quatro ficheiros da versão (os passos "start clean" nas notas da versão). Isso apaga Wi-Fi, definições, pontos, tarifa e tokens; conte também com a perda do histórico. Guarde o seu API token num local seguro.

Atualizações

Como atualizo a aplicação? Em webapp.rbgrid.io está sempre na versão mais recente; não tem de fazer nada. Para a aplicação instalada no hub, instale o novo rbgrid-ui_<version>.zip da versão da mesma forma que da primeira vez. As suas definições e o histórico estão no hub e mantêm-se. → Opening the app

Uso preços dinâmicos e estou na v1.2.0 do firmware — devo atualizar? Sim. Na v1.2.0, os preços obtidos partilhavam a pequena área de definições do hub com a hora que estava a ser medida, por isso podiam enchê-la, e um reinício podia perder parte dessa hora (o Hub log mostra FAIL hour persist …). A v1.2.1 move os preços para o sistema de ficheiros e liberta o espaço no primeiro arranque. Nada mais muda. → Where your price comes from

Como atualizo o firmware do hub? Em Settings → Hub firmware, carregue o main_release.bin da nova versão (os outros três ficheiros servem apenas para o flash por USB). O Wi-Fi, as definições, os pontos, a tarifa, os tokens e o histórico mantêm-se, e os módulos continuam a contar durante a atualização. Se o novo firmware não arrancar, o hub volta sozinho ao anterior. Durante cerca de um minuto após uma atualização, o hub ainda está a confirmar a nova imagem, e uma segunda atualização iniciada nesse minuto é recusada: o painel mostra "Failed: The hub is still confirming the firmware installed less than a minute ago. Try again in about a minute." Espere um minuto e tente de novo (no firmware v1.1.5 e anteriores, a mesma tentativa falhava com um erro genérico). Depois instale o rbgrid-ui_<version>.zip correspondente da versão. Não reinicie o hub no primeiro minuto após uma atualização: o novo firmware ainda não está confirmado, e um reinício dentro desse minuto reverte-o para o anterior. → Settings