Configuration toml

Proxy configuration

TOML config file

TSUN cloud (for GEN3 inverter only)

keyword	type	mandatory/optional	description
tsun.enabled	bool	mandatory	false: no connection to TSUN cloud, no updates true: normal proxy operation
tsun.host	string	mandatory	The hostname or IP address of the TSUN server default: logger.talent-monitoring.com
tsun.port	int (1024...65535)	mandatory	The network port of the TSUN servery default: 5005

Solarman cloud (for GEN3PLUS inverter only)

keyword	type	mandatory/optional	description
solarman.enabled	bool	mandatory	false: no connection to TSUN cloud, no updates true: normal proxy operation
solarman.host	string	mandatory	The hostname or IP address of the TSUN server default: iot.talent-monitoring.com
solarman.port	int (1024...65535)	mandatory	The network port of the TSUN servery default: 10000

MQTT broker account

keyword	type	mandatory/optional	description
mqtt.host	string	mandatory	The hostname or IP address of the MQTT broker default: mqtt
mqtt.port	int (1024...65535)	mandatory	The network port of the remote broker default 1883
mqtt.user	string	mandatory	The username to authenticate with default: <empty>
mqtt.passwd	string	mandatory	The password to authenticate with default: <empty>

Home Assistant

keyword	type	mandatory/optional	description
ha.auto_conf_prefix	string	mandatory	MQTT prefix for subscribing for homeassistant status updates
ha.discovery_prefix	string	mandatory	MQTT prefix for discovery topic
ha.entity_prefix	string	mandatory	MQTT topic prefix for publishing inverter values
ha.proxy_node_id	string	mandatory	MQTT node id, for the proxy_node_id
ha.proxy_unique_id	string	mandatory	MQTT unique id, to identify a proxy instance

Inverter list

keyword	type	mandatory/optional	description
inverters.allow_all	bool	mandatory	true: allow inverters, even if we have no inverter definition block with a matching serial number
[inverters."<inverters-serial>"]	table	optional	Named index of a Inverter definition block

Inverter definitions

The inverter definition block must begin with a named index line such as [inverters."<inverters-serial>"]. All subsequent lines are part of this block until a new block is started with a new index line with square brackets.

keyword	type	gen	mandatory/optional	description
node_id	string	all	mandatory	MQTT replacement for inverters serial number
suggested_area	string	all	optional	Suggested installation place for home-assistant
monitor_sn	int	GEN3PLUS	mandatory	The "Monitoring SN:" can be found on a sticker enclosed with the inverter
modbus_polling	bool	all	optional	false: disable MODBUS polling true: enable MODBUS polling (default)
client_mode.host	string	GEN3PLUS	optional	Inverter IP addr for client mode
client_mode.port	int	GEN3PLUS	optional	Inverter TCP port of client-mode connection default: 8899
pv<1..6>.type	string	all	optional	Type of the PV module 1..6
pv<1..6>.manufacturer	string	all	optional	Manufacturer of the PV module 1..6

AT+ Command Filter (for GEN3PLUS inverter only)

If this configuration block follows an inverter definition block, you must use an index line with square brackets such as [gen3plus.at_acl] and must omit the index gen3plus.at_acl. in the associated lines.

keyword	type	mandatory/optional	description
gen3plus.at_acl.tsun.allow	string	mandatory	List of AT commands, which are allowed
gen3plus.at_acl.tsun.block	string	optional	List of AT commands, which will be blocked
gen3plus.at_acl.mqtt.allow	string	mandatory	List of AT commands, which are allowed
gen3plus.at_acl.mqtt.block	string	optional	List of AT commands, which will be blocked

Docker build arguments

name	description
environment	dev or production; for production we remove unused commands from the container to reduce the attack surface
SERVICE_NAME	name of the proxy, must not be changed
VERSION	version string build from the git tag during container build
LOG_LVL	DEBUG, INFO, WARN, set in container build

Docker compose environment variables

name	description
UID	user id for the proxy
GID	group id for the proxy
DNS1	defines which DNS server the proxy use
DNS2	defines a backup DNS server for the proxy
TZ	timezone e.g. Europe/Brussels ❗This should be determined by the host operating system of your Docker Engine and is mandatory for GEN3 inverter
PROJECT_DIR	common base path