Sungrow iSolarCloud | Sofar EMS Documentation

Dispositivos suportados

Device Type
Todos os inversores Sungrow registrados no iSolarCloud

Pré-requisito: cada inversor já está adicionado à sua conta iSolarCloud e visível no portal web ou aplicativo móvel.

Obtenha as credenciais da API
iSolarCloud → Configurações → Open API fornece:
API Key, Access Key e RSA Key.
Crie um usuário somente leitura (recomendado)
Em Usuários & Funções adicione um usuário “API” dedicado e limite os seus direitos para Leitura.

Adicione o driver em Sofar

Preencha os campos:

Campo	Exemplo
Nome de usuário / Senha	`api_user / S3cureP@ss`
API Key / Access Key / RSA Key	valores do passo 1
Filtro de localização	`100;101` (opcional – lista separada por ponto e vírgula)
Tipo de comando	padrão (limite de potência ativa)

Salve – todo inversor pertencente às localizações selecionadas aparecerá automaticamente.

Chave	Descrição	Unidade
`actualPowerTot_W`	Potência AC instantânea da usina fotovoltaica	W
`producedEnergyDeltaTot_Wh`	Energia FV desde a última leitura ¹	Wh
`importedEnergyDeltaTot_Wh`	Energia importada da rede (se fornecida pela Sungrow)	Wh
`exportedEnergyDeltaTot_Wh`	Energia exportada para a rede (injeção)	Wh

¹ O driver integra potência ao longo do tempo quando contadores absolutos de kWh não estão disponíveis.

HTTP 401 / 403 – verifique novamente as credenciais da API e se o usuário tem acesso API ativado no iSolarCloud.
Nenhum inversor encontrado – verifique a lista de IDs de localização; deixe o campo vazio para buscar todas as usinas associadas à conta.
Redução ignorada – alguns firmwares mais antigos da Sungrow não respeitam limites de potência ativa; altere o modo de comando do driver para Alternativo (LIGADO/DESLIGADO) nas configurações.