Como ligar a sonnenBatterie (Gen. 8 ou superior, ligação por API REST) ao Reduxi Controller
Ligue a sonnenBatterie Gen. 8 ou superior ao Reduxi Controller através da API REST.
Descrição em texto desta imagem
Fotografia de uma sonnenBatterie, imagem do fabricante. Parede de betão cinzento-escuro numa divisão pouco iluminada. Na parede, à esquerda, está pendurado um módulo retangular cinzento com a frente nervurada ou perfurada, o inversor híbrido segundo a legenda. A seu lado, à direita, há um armário alto cinzento-claro com um anel luminoso azul-claro redondo perto do topo. Sem texto legível nos dispositivos.
- Documentação técnica
- Equipamento necessário
- Acesso local à sonnenBatterie
- Configuração do dispositivo na sonnenBatterie
- Iniciar sessão na interface web do Reduxi
- Adicionar a sonnenBatterie ao Reduxi
- Verificar as leituras e configurar as estratégias
- Lista de verificação
- Resumo
- Problemas frequentes
- Artigos relacionados
1 Documentação técnica
Páginas do fabricante da sonnenBatterie:
- sonnenBatterie 10 – Página do produto do fabricante
- Manuais de utilização da Sonnen – Manuais de utilização do fabricante
Tutoriais em vídeo:
2 Equipamento necessário
Prepare o seguinte:
- Reduxi Controller (instalado e online)
- sonnenBatterie Gen. 8 ou superior (API REST)
- Endereço IP local da sonnenBatterie
- Palavra-passe de instalador da sonnenBatterie (ver Ponto 4)
- Computador na mesma rede local que a sonnenBatterie
- Portátil ou tablet com acesso à internet para configurar o dispositivo no Reduxi
3 Acesso local à sonnenBatterie
Antes de começar, certifique-se de que tem o endereço IP local da sonnenBatterie e de que o computador está ligado à mesma rede local.
A sonnenBatterie recebe o seu endereço IP de:
- o router,
- um switch de rede,
- ou um servidor DHCP local.
Para encontrar o endereço IP ou o nome DNS da sonnenBatterie, utilize find-my.sonnen-batterie.com e siga as instruções da Sonnen.
Abra um navegador web e introduza o endereço IP local da sonnenBatterie para abrir a respetiva interface web. Exemplo: http://<IP>
4 Configuração do dispositivo na sonnenBatterie
4.1 Início de sessão como instalador
Depois de abrir o endereço IP no navegador, aparece um ecrã de início de sessão. Selecione Installer como tipo de início de sessão e introduza a palavra-passe de instalador.
Se precisar de acesso, contacte o instalador que colocou o sistema em funcionamento ou o suporte da Sonnen. O suporte da Sonnen pode verificar o pedido, desbloquear o acesso ou efetuar as alterações necessárias em seu nome.
Descrição em texto desta imagem
Captura de ecrã do ecrã de início de sessão da interface web da sonnenBatterie, janela larga com o logótipo sonnen na barra superior escura. Caixa de início de sessão centrada com o título Dashboard. Texto: Please choose a login. Lista pendente com o valor selecionado Installer. Etiqueta de campo Password, campo vazio. Botão azul-claro Login.
4.2 Dashboard
Após um início de sessão bem-sucedido, é apresentado o Menu / Dashboard.
Descrição em texto desta imagem
Captura de ecrã da interface web da sonnenBatterie, página Dashboard, com o logótipo sonnen na barra superior escura. Menu à esquerda: Dashboard (realçado a azul-claro), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Título da área principal: Dashboard. Diagrama de fluxo de energia com quatro caixas: production 3145 W (amarela, ícone de painel solar); consumption 1875 W (azul, ícone de casa); FeedIn 1273 W (cinzenta, ícone de poste); active power com estado idle, rSOC: 16% e uSOC: 9% (verde, ícone de bateria). Uma seta amarela vai da produção até à caixa da bateria, uma seta verde vai da caixa da bateria para cima, até ao consumo.
4.3 Ativar a API REST da sonnenBatterie
No dashboard, proceda do seguinte modo:
Descrição em texto desta imagem
Captura de ecrã da interface web da sonnenBatterie, página Software-Integration (logótipo sonnen na barra superior escura; número de série e versão de software indicados no canto superior direito em texto pequeno). Menu à esquerda: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (realçado por uma caixa vermelha). Separadores: JSON API (selecionado), WebSocket API, Generated Docs (texto pequeno). Dois interruptores, ambos ligados (azul) e cada um assinalado por uma caixa vermelha: Read API (texto por baixo: allows to request the current status of the sonnenBatterie, measurements and configuration values) e Write API (texto por baixo: send requests to change or discharge the sonnenBatterie and set configuration values). Uma caixa vermelha assinala a linha API Token: um valor de token (não mostrado aqui, ocultado) e um botão Create New. Abaixo: um exemplo de comando curl com um cabeçalho Auth-Token e um URL terminado em /api/v2/latestdata. Título Documentation com uma ligação para a documentação da JSON API da sonnenBatterie.
4.4 Definir o modo de funcionamento
Abra o menu Settings no lado esquerdo e selecione o modo de funcionamento Manual.
Descrição em texto desta imagem
Captura de ecrã da interface web da sonnenBatterie, página Settings (o canto superior direito mostra Software: 1.15.6, o resto está cortado). Menu à esquerda: Dashboard, System, Inverter, Settings (realçado a azul), Network, Software-Integration. Título da área principal: Settings. Secção: Operating Mode. Uma lista pendente está aberta com a entrada selecionada Manual (realçada a cinzento). As opções listadas são: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Por baixo da lista pendente vê-se um interruptor com a etiqueta Surplus fullcharge, desligado (cinzento).
5 Iniciar sessão na interface web do Reduxi
Pode abrir a interface web do Reduxi de duas formas:
Descrição em texto desta imagem
Captura de ecrã de três ecrãs da aplicação móvel Reduxi lado a lado, com caixas ciano e indicadores numéricos de 2 a 4. Ecrã da esquerda (dashboard, tema escuro): ícone de menu no canto superior esquerdo assinalado com uma caixa e o indicador 2; logótipo 'reduxi'; separadores 'Real time data' (ativo) e 'Statistics'; preço 5.79 € e temperatura 3.2 °C; diagrama de fluxo de energia com uma casa ao centro (-1.25 kW) e ícones com os valores 69.0 W, 1.3 kW, 1.1 kW (anel vermelho), -165.0 W com 97 % (anel vermelho) e valores de 0.0 W em baixo; separadores 'Power' e 'Energy'; navegação inferior: Dashboard, Diagnostics, Device control, Settings. Ecrã central (menu lateral): logótipo 'reduxi', 'Number of locations: 1233', título 'Reduxi device management', entradas '+ Add Reduxi location' e 'Reduxi devices' (assinalada com uma caixa e o indicador 3), depois 'My profile' e 'About app'. Ecrã da direita (página do dispositivo): Back; imagem de um controlador Reduxi preto com duas portas Ethernet; estado 'Connected'; cartão 'Update available': 'New update is available for your Reduxi device.' com o botão 'Download and install update'; cartão 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' com o botão 'Activate tunnel connection' (assinalado com uma caixa e o indicador 4); cartão 'Unit details' com o campo 'Unit ID'.
Descrição em texto desta imagem
Captura de ecrã composta por duas partes lado a lado. Parte da esquerda: ecrã da aplicação móvel Reduxi sobre fundo escuro. Em cima: botão Back; imagem de um controlador Reduxi preto com duas portas Ethernet e um bloco de terminais; estado 'Connected' com um ícone de Wi-Fi. Cartão 'Update available': 'New update is available for your Reduxi device.' com o botão 'Download and install update'. Cartão 'Connect to configurator' com um ícone de chave: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' e o botão 'Open configurator', assinalado com uma caixa ciano e o indicador numérico 5. Por baixo: cartão 'Unit details' com um campo 'Unit ID' (valor não visível). Parte da direita: Reduxi Configurator aberto num navegador, assinalado com uma moldura ciano e o indicador numérico 6. Cabeçalho: seta de voltar, 'Tunnel connection', ícone de recarregar. Barra lateral esquerda com ícones (raio, chip, símbolo de raio, gráfico de barras, roda dentada). Página 'Home' com um ícone de ligação verde. Aviso verde: 'New patch available. Click here to apply.' com um X de fechar. Hora 09:12:56. Diagrama de fluxo de energia com uma casa ao centro (1.700 kW) e ícones para a rede (0.000 kW), solar (1.700 kW), bateria (verde, 0.000 kW e 0.800 kW), um dispositivo à esquerda (0.900 kW), veículo elétrico e um carregador ou dispositivo em baixo. Etiqueta 'Energy manager' em baixo.
http://reduxi.local. O endereço IP do controlador encontra-se na lista de dispositivos do seu router ou na Reduxi app, em Reduxi devices.admin · Palavra-passe: admin (predefinição de fábrica)Descrição em texto desta imagem
Captura de ecrã da página de início de sessão do Reduxi Configurator numa janela do navegador Chrome. A barra de endereços mostra 'Not secure' e 'reduxi.local'; a barra de endereços está assinalada com uma caixa ciano e uma cópia ampliada da mesma (caixa ciano, texto 'Not secure reduxi.local') é mostrada à esquerda, ligada por uma linha ciano. Fundo da página: desenho a linhas cinzento-claras de uma casa com painéis solares (verdes), uma wallbox, um inversor, um automóvel e um carregador. Em cima à esquerda: logótipo 'reduxi configurator'. Caixa de início de sessão ao centro com o título 'Login', um seletor de idioma (bandeira de Inglaterra, 'English'), um campo de nome de utilizador e um campo de palavra-passe, e um botão escuro 'Login'.
Descrição em texto desta imagem
Captura de ecrã da interface web do Reduxi Configurator após o início de sessão, tema claro. Em cima à esquerda: logótipo 'reduxi configurator'. Barra de cabeçalho: 'Home' à esquerda, estado verde 'Connected' no canto superior direito. Barra lateral esquerda: secção 'Devices' expandida com uma lista de entradas, depois as secções recolhidas 'Manager', 'Configuration' e 'Settings'. Área principal: diagrama de fluxo de energia. Casa ao centro com anel, valor 24.20 kW. Ícone de rede em cima à esquerda, 24.20 kW (ponto vermelho na respetiva linha). Ícone solar em cima à direita, valor '-'. Ícone à esquerda (bateria ou dispositivo), 6.700 kW (ponto verde na respetiva linha). Ícones à direita (armazenamento em bateria e um dispositivo), valores '-'. Ícone de EV charger em baixo à esquerda, 31.00 kW. Outro ícone de dispositivo em baixo à direita. Etiqueta 'Energy manager' por baixo da casa.
6 Adicionar a sonnenBatterie ao Reduxi
Siga estes passos para adicionar um novo dispositivo ao Reduxi Controller.
6.1 Definições básicas
Inicie sessão no Reduxi Configurator (ver Ponto 5; ver também Como iniciar sessão no Reduxi Configurator através do navegador) e clique em + Add device.
Descrição em texto desta imagem
Captura de ecrã do menu esquerdo do Reduxi Configurator por baixo do logótipo reduxi Configurator. Entradas do menu: Devices (expandida, com um sinal de menos) que contém o botão '+ Add device' (com contorno); Strategies (sinal de mais); Utility Rate Plan; Settings (sinal de mais). O lado direito está em branco.
No primeiro passo, defina as definições básicas:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: um nome à sua escolha
Descrição em texto desta imagem
Captura de ecrã do formulário do Reduxi Configurator com o título Basic settings. Campos: Device type (lista pendente, valor em texto pequeno); Type (lista pendente, o valor parece ler Sonnen, texto pequeno); Name (campo de texto, o valor parece ler sonnen, texto pequeno). Por baixo, uma secção Include in Strategy com uma tabela: colunas Strategy, Measurement Device, Regulated Device; duas linhas, ambas com a etiqueta Energy manager, cada uma com um pequeno indicador nas colunas Measurement Device e Regulated Device. Botões: Back (em baixo à esquerda, branco), Next (em baixo à direita, preto). A imagem tem baixa resolução e a maior parte do texto é pequena.
Clique em Next.
6.2 Definições de comunicação
| Parâmetro | Valor |
|---|---|
| Ligação | TCP/IP |
| IP | Endereço IP da sonnenBatterie |
| Token da API | O token da API do Ponto 4, Ponto 4.3 |
| PV | Escolha o tipo de inversor: AC‑coupled (a bateria e o inversor são separados) ou Hybrid (a bateria e o inversor estão integrados num único sistema) |
Descrição em texto desta imagem
Captura de ecrã do formulário do Reduxi Configurator com o título Communication channel and device configuration. A imagem tem baixa resolução. Campos: Connection type (lista pendente); IP (campo de texto, vazio) com um botão preto Scan for IP; Port: 80; Reconnect IP recovery (interruptor, com a etiqueta Yes, ligado); API token (campo de texto, vazio); um segundo interruptor com um título curto e o texto Yes/No; Number of AC system units: 1; What is type of inverter (lista pendente): AC coupled system. Botões: Back (em baixo à esquerda), Test communication e Done (em baixo à direita, Done é preto).
6.3 Testar a comunicação
Clique em Test communication na parte inferior do assistente. Este botão lê a sonnenBatterie uma vez e não guarda nada. Se o teste for bem-sucedido, clique em Done: só o Done cria o dispositivo.
Descrição em texto desta imagem
Captura de ecrã da barra de botões inferior de uma página do Reduxi Configurator. À esquerda: botão 'Back'. À direita: botão 'Test communication' (assinalado com uma caixa ciano) e botão escuro 'Done'.
Descrição em texto desta imagem
Captura de ecrã da página 'Communication channel and device configuration' do Reduxi Configurator. Connection *: TCP/IP (lista pendente). IP *: 192.168.50.243, com o botão 'Scan for IP'. Port *: 502, com o botão 'Test port'. Modbus unit ID *: 1. Botões em baixo: Back (à esquerda), Test communication e Done (à direita). O botão Done está assinalado com uma caixa ciano.
O teste devolve um de dois resultados:
Descrição em texto desta imagem
Captura de ecrã da caixa de diálogo Test communication do Reduxi Configurator com um ícone de fechar (x) no canto superior direito. Caixa de resultado branca, texto verde: Successful readout from device. Valores: Battery active power: 5.0 W; Battery current: 0.0229 A; Battery export active energy: 0 Wh; Battery import active energy: 0 Wh; Battery min. active power: -9600.0 W; Battery min. state of charge: 10.0 %; Battery state of charge: 100.0 %; Battery voltage: 218.0 V; Grid active power: 1456.0 W; Grid export active energy: 0 Wh; Grid import active energy: 0 Wh; Load active power: 1454.0 W; Load import active energy: 0 Wh; Off-grid: false; PV active power: 0.0 W; PV export active energy: 0 Wh; State name: GRID_ON; Additional parameter - CAPACITY_MAX_WH: 19531.0; Additional parameter - FREQUENCY: 49.965. Botão: Close (escuro, canto inferior direito).
Descrição em texto desta imagem
Captura de ecrã de uma caixa de diálogo com o título Test communication (X de fechar no canto superior direito). Primeira caixa: Unable to communicate with device. Segunda caixa com texto vermelho: Unable to communicate with null on port 502. Check if service is enabled on device, port number is correct and device is reachable on the network. ping: null: Name or service not known. Botão: Close (escuro).
Se receber a mensagem “Unable to communicate with device”, verifique as definições (ver Ponto 8).
7 Verificar as leituras e configurar as estratégias
7.1 Last measurements
Depois de estabelecida a comunicação, verifique os valores medidos em Devices – o seu dispositivo Sonnen – Last measurements no Reduxi Configurator.
7.2 Reduxi Cloud
Como adicionar e ligar o controlador ao Reduxi Cloud: Reduxi Cloud
7.3 Estratégias
Para configurar estratégias e o AI Energy Manager, utilize a documentação abaixo.
8 Lista de verificação
Reveja esta lista de verificação para garantir uma configuração correta e um funcionamento fiável.
8.1 No Reduxi Controller
- Endereço IP: O endereço IP correto está introduzido para o dispositivo ligado.
- Token da API: Está introduzido um token da API válido.
- Tipo de sistema: Está selecionado o tipo de sistema correto: AC‑coupled ou Hybrid.
- Teste de comunicação: O teste de comunicação é concluído com sucesso.
- Acessibilidade: O endereço IP do dispositivo é acessível a partir do Reduxi Controller.
8.2 Na interface web da sonnenBatterie
- Permissões da API: Tanto a Read API como a Write API estão ativadas.
- Modo de funcionamento: O modo de funcionamento é Manual.
8.3 Estratégia
- Estratégia ativa: A estratégia selecionada está definida como Active.
- Otimização energética por IA: A otimização do AI Energy Manager está ativada na estratégia.
- Uma única estratégia ativa: Apenas uma estratégia está ativa de cada vez.
- Limites de importação/exportação: Os limites de importação e de exportação estão definidos e configurados.
✓ Resumo
Preparação (Pontos 1–3): Prepare o endereço IP local, a palavra-passe de instalador e um computador na mesma rede. Abra a interface web da sonnenBatterie.
sonnenBatterie (Ponto 4): Inicie sessão como Installer, ative Read API e Write API, copie ou crie o token da API e defina o modo de funcionamento como Manual.
Adicionar ao Reduxi (Pontos 5–6): Abra o Configurator e adicione o dispositivo com o tipo Sonnen. Introduza o endereço IP, o token da API e o tipo de inversor (AC‑coupled ou Hybrid). Execute Test communication.
Entrar em funcionamento (Pontos 7–8): Verifique as leituras, configure as estratégias e percorra a lista de verificação.
→ Problemas frequentes
| Problema | Solução |
|---|---|
| O Test communication mostra “Unable to communicate with device” | O sistema não está configurado corretamente. Verifique o endereço IP, o token da API, o tipo de sistema (AC‑coupled ou Hybrid) e se o endereço IP é acessível a partir do controlador (ver Ponto 8). |
| Não é possível iniciar sessão como instalador | A palavra-passe de instalador não está disponível para os utilizadores finais. Contacte o instalador que colocou o sistema em funcionamento ou o suporte da Sonnen (ver Ponto 4). |
| Não há nenhum token da API disponível | Abra Software Integration na interface web da sonnenBatterie e clique em Create new na parte inferior da página. |
| Os comandos do Reduxi não têm efeito na bateria | Verifique se o modo de funcionamento é Manual, se Read API e Write API estão ativadas, se a estratégia está Active e se só há uma estratégia ativa (ver Ponto 8). |
| Open configurator não abre ou fica vazio | O túnel ainda não está ativo. Aguarde cerca de 30 segundos e verifique se o controlador está online. |
O início de sessão com admin é rejeitado |
A palavra-passe foi alterada durante a instalação. Pergunte ao instalador. A palavra-passe da conta Reduxi não funciona aqui. |
reduxi.local não carrega |
O seu dispositivo não está na mesma rede que o controlador. Utilize o endereço IP ou a ligação por túnel. |
| O teste de comunicação falha, o dispositivo aparece offline | Verifique a acessibilidade, o endereço IP / porta / unit ID e se o protocolo está ativado no dispositivo. |