Como ligar a sonnenBatterie ao Reduxi Controller
Ligue a sua sonnenBatterie ao Reduxi Controller e deixe que as estratégias Reduxi a carreguem e descarreguem aos melhores preços. Este guia abrange a ligação por JSON API e indica onde se aplica o guia da REST API para a Gen. 8 ou superior.
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.
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 com a JSON API em Software Integration
- Endereço IP local da sonnenBatterie
- 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
Ligue a sonnenBatterie à rede local por LAN. O Reduxi Controller tem de estar na mesma rede.
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
Inicie sessão na interface web da sonnenBatterie (ver ponto 3). Precisa do token da API e do endereço IP para o Reduxi Controller (ver ponto 6).
4.1 Abrir Software Integration
Descrição em texto desta imagem
Captura de ecrã da interface web da sonnenBatterie num browser, página Software-Integration, separador JSON API. A barra de endereço mostra um endereço IP local seguido do caminho dash/software-integration/json-api; o endereço IP está assinalado com uma caixa vermelha e uma seta com a etiqueta SonnenBatterie IP. Menu esquerdo: Dashboard, System, Inverter, Settings, Network e Software-Integration (realçado). Separadores: JSON API (ativo), Webhook API e sonnenKNX Module. Dois interruptores estão ativados: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) e Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Por baixo, o campo API Token com um valor de token, assinalado com uma caixa vermelha e a etiqueta API Token, e um botão Create New. Uma linha de exemplo repete o token e o endereço IP com as mesmas marcações. Em baixo: ligação sonnenBatterie JSON API v2 documentation.
4.2 Ativar Read API e Write API
Ative Read API e Write API. Ambos são necessários: o Reduxi lê as medições com a Read API e envia comandos de carga e descarga com a Write API.
Descrição em texto desta imagem
Captura de ecrã recortada do separador JSON API com os separadores JSON API, Webhook API e sonnenKNX Module. O interruptor Read API está ativado. Por baixo, um aviso azul-claro indica This functionality is disabled while VPP is active, seguido de um interruptor Write API acinzentado na posição desativada com o texto Send requests to charge/discharge the sonnenBatterie and set configuration values. Um retângulo azul realça o aviso e o interruptor Write API.
4.3 Definir o modo de funcionamento
Abra o menu Settings, no lado esquerdo, e defina o modo de funcionamento como Manual. Só assim o Reduxi Controller pode assumir o controlo da bateria.
Descrição em texto desta imagem
Captura de ecrã da página Settings da sonnenBatterie (software 1.15.6). Menu esquerdo: Dashboard, System, Inverter, Settings (realçado), Network e Software-Integration. O cartão Operating Mode contém uma lista pendente que mostra Manual; a lista aberta por baixo oferece Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) e Time-Of-Use. Por baixo do cartão vê-se um interruptor com a etiqueta Surplus fullcharge.
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 a sonnenBatterie como novo dispositivo no Reduxi Controller.
6.1 Definições básicas
Inicie sessão no Reduxi Configurator (ver ponto 5; ver também How to log in to Reduxi Configurator via browser) 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:
- Tipo de dispositivo: Hybrid Inverter
- Tipo: 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
Introduza os parâmetros de ligação entre o Reduxi Controller e a sonnenBatterie. Utilize o endereço IP e o token da API do ponto 4.
| Parâmetro | Valor |
|---|---|
| Ligação | TCP/IP |
| IP | Endereço IP da sonnenBatterie |
| Porta | 80 |
| Token da API | O token da API do separador JSON API (ponto 4, ponto 4.1) |
| Potência nominal | Selecione a potência nominal que corresponde à sua sonnenBatterie |
| PV | Selecione Yes se estiver instalado um contador FV, caso contrário No |
Descrição em texto desta imagem
Captura de ecrã do formulário Communication channel and device configuration do Reduxi Configurator. Campos de cima para baixo: Connection (TCP/IP), IP (vazio, com uma seta azul-clara a apontar para o campo), Port (80), API token (vazio, com uma seta azul-clara; ajuda: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) e PV (Yes; ajuda: Is PV meter installed?). Botões em baixo: Back, Test communication e Next.
6.3 Testar a comunicação
Clique em Test communication na parte inferior do assistente. Este teste lê a sonnenBatterie uma vez e não guarda nada. Se o teste for bem-sucedido, clique em Next.
O teste devolve um de dois resultados:
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 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).
6.4 Definições avançadas
As definições avançadas são opcionais e dependem das necessidades do local. Quando terminar, clique em Done: só o botão Done cria o dispositivo.
Descrição em texto desta imagem
Captura de ecrã do assistente do Reduxi Configurator, passo 3 de 3 Advanced settings; a barra de progresso mostra Basic settings, Communication channel e Advanced settings. Interruptores Yes/No, todos em No: set data saving interval (default 1 min), set reading delay (default 1000 ms), set writing delay (default 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (default No), invert direction for energy import and export (default No), exclude device from summary (default No). Três listas pendentes L1, L2 e L3 is connected to main feed estão definidas como L1, L2 e L3. Botões: Back à esquerda e Done à direita.
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 Control type
Abra Devices – o seu dispositivo Sonnen no Reduxi Configurator e defina o control type como AUTO. Os comandos da estratégia passam então a ter efeito na bateria.
7.3 Reduxi Cloud
Como adicionar e ligar o controlador ao Reduxi Cloud: Reduxi Cloud
Depois de adicionado o dispositivo, também pode monitorizá-lo e controlá-lo na aplicação Reduxi.
7.4 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 e porta: Estão introduzidos o endereço IP da sonnenBatterie e a porta
80. - Token da API: Está introduzido um token da API válido.
- Potência nominal e PV: A potência nominal e a seleção de PV correspondem ao sistema.
- Teste de comunicação: O teste de comunicação é concluído com sucesso.
- Control type: O control type do dispositivo está definido como AUTO.
- 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.
- VPP: A bateria está desligada da VPP.
- 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 e um computador na mesma rede. Abra a interface web da sonnenBatterie.
sonnenBatterie (ponto 4): Abra Software-Integration, separador JSON API. Ative Read API e Write API (desligue primeiro a bateria da VPP), 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, a porta 80, o token da API, a potência nominal e o PV. Execute o Test communication e clique em Done.
Entrada em funcionamento (pontos 7–8): Verifique as leituras, defina o control type como AUTO, 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” | Verifique o endereço IP, a porta 80, o token da API e se o endereço IP é acessível a partir do controller (ver ponto 8). |
| Não é possível ativar a Write API | É apresentado o aviso “This functionality is disabled while VPP is active”. Desligue a bateria da VPP e, em seguida, ative a Write API (ver ponto 4.2). |
| Não há nenhum token da API disponível | Abra Software-Integration, separador JSON API, na interface web da sonnenBatterie e clique em Create New. |
| 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 o control type é AUTO, se a estratégia está Active e se apenas uma estratégia está 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. |
| O 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 e a porta e se a API está ativada no dispositivo. |