Page 8
Universal Character Set Transformation Format1 - 8 bits: computer character encoding designed to encode all the characters from the ‘Universal encoded character set”. WebDAV Extension to the HTTP protocol to improve remote file management. WebdynSunPM uses the WebDAV protocol with HTTPS. This is known as WebDAV-HTTPS. contact@webdyn.com | webdyn.com...
Page 9
Notes on this manual This guide describes all the WebdynSunPM product characteristics. Its purpose is to help operators install and configure their WebdynSunPM and to allow operators to include collected data in their IS. This manual has eight separate sections: •...
Page 12
1 Presentation General description The WebdynSunPM is a concentrator designed to monitor all types of photovoltaic installation. It is used to collect, analyse, monitor and control the on site devices. The collected information (data, parameters, etc.) is formatted before being sent to an Information System (IS).
Page 14
SIM card holder Modem SMA antenna connector USB port (for extension) RESET button 1.4 Supported devices The WebdynSunPM is compatible with all devices that include one of the supported protocols. Partial list of the supported protocols: Inverter protocol Physical interface Specifications...
Page 15
1.5 Product references References Descriptions WG0517-A01 WebdynSunPM (Europe and India version) WG0517-A02 WebdynSunPM (World Version) WG0517-A03-DEIE WebdynSunPM in a DEIE box (Europe and India version) WG0517-A04 WebdynSunPM 4G (Europe and India version) 1.6 Technical Specifications 1.6.1 General specifications Specifications Descriptions...
Page 20
Please follow all the safety instructions featured in the manufacturer’s device documentation. The WebdynSunPM product can be damaged by electrostatic discharges (ESD). Class 3 equipment: the device operates on safety extra-low voltage (SELV) (50V maximum). The voltage reduction must be obtained using a safety transformer providing safe galvanic isolation between primary and secondary.
Page 22
2 Installation and Maintenance 2.1 Prerequisite As the WebdynSunPM concentrator’s role is to send the data it collects to an IS, installation requires knowledge of the concentrator but also of the IS it will upload its data to. The following elements are required to guarantee proper installation: •...
Page 24
2.3.1 Opening/closing the box Users must not open the product. The WebdynSunPM must be returned to after sales for all work on it (sav@webdyn.com). 2.3.2 Wall mounting The WebdynSunPM is designed to be fixed onto a DIN rail. contact@webdyn.com | webdyn.com...
Page 26
Product power supply 2.4.1.1 External power supply The WebdynSunPM concentrator can be powered using 12V or 24V direct current. The power supply uses the 2 point unpluggable terminal block marked “12/24V” located at the top left of the concentrator. End users must use a CE certified power supply of less than 15 watts. The distance between the power supply and the product must not exceed 3 metres.
Page 27
2.4.1.2 Battery The WebdynSunPM concentrator has a battery that is used to send an alarm to notify of a power failure fault and switch the product to safety mode until the power supply returns. The battery recharges on the concentrator’s external power supply.
Page 28
The concentrator is compatible with all market operators as well as with all mini SIM 2FF 25 x 15mm format SIM cards. To guarantee proper WebdynSunPM operation, insert a SIM card with the following specifications: • Possibility of sending and receiving text messages (preferable but not essential).
Page 31
2.4.3.3 Power LED The Power indicator shows the WebdynSunPM concentrator power up. The indicator is: • On: the concentrator is running. There is a voltage of between 12 and 24 volts at the power supply terminals. • Off: the concentrator is stopped. There is no voltage on the power supply terminal block.
Page 33
2.4.4 Extension interface 2.4.4.1 External memory medium (MicroSD) A micro SD slot is available on the front of the concentrator. WebdynSunPM is compatible with micro SDXC cards (15 x 11 mm) of a capacity of up to 32 Gb. The SD card is used to store the configuration, carry out updates or memorise the data collected from the various devices locally, thus eliminating the need for a remote server.
Page 35
2.4.5 Ethernet interface The WebdynSunPM concentrator has 2 Ethernet interfaces (LAN1 and LAN2) which are separate from each other. These Ethernet interfaces allow the concentrator to be part of 2 different Ethernet networks to communicate with local IP devices belonging to 2 separate networks or to communicate with the IS using Ethernet.
Page 36
To guarantee proper data bus operation, an RS485 bus must feature a 120 Ohm terminator at each end. The WebdynSunPM concentrator can be at the end of the RS485 communication bus or in the middle. As the concentrator has a 120 Ohms resistor, it made need to be enabled depending on the concentrator position on the bus.
Page 39
2.4.7.1 Analog 0-10V or 4-20mA inputs The WebdynSunPM has 4 analog “Analog” inputs used to measure current of between 4 and 20 mA or a voltage of between 0 and 10 V. Each analogue terminal block has a power output that can be used to power a sensor. The voltage delivered by this power output is equal to the concentrator’s power supply voltage.
Page 40
7 watts. 2.4.7.2 Digital ON-OFF/S0 (pulsed) inputs The WebdynSunPM concentrator has 3 inputs that can be configured to ON-OFF mode or S0 pulsed mode (pulse counting). These inputs are located at the bottom left of the WebdynSunPM concentrator.
Page 42
In S0 (pulse) mode: The WebdynSunPM concentrator manages meters that have class A (24 V) and B (5 V) pulse outputs as per the IEC 62053-31-1998 standard. The concentrator runs in “Sink” type mode, meaning that voltage is applied to the meter’s S0+ terminal using an (internal) pull-up resistor and a 0V voltage is applied to the meter’s S0- connection.
Page 48
For an MQTT server: WebdynSunPM can connect to an MQTT server to store its data and alarms. Commands can also be sent to the concentrator through the MQTT server. To do that, the topics subscribed to the concentrator in its settings must be indicated.
Page 59
Name of the definition file describing the associations between registers and variables. The file must be present in the "/DEF" definition directory. If the "mapping file" field is empty, then only WebdynSunPM registers are available. (See section4.1.2: ““DEF”, the definitions”) 3.1.2.1.3.5 Declaration of devices to be monitored...
Page 64
WebdynSunPM will not download the licence file if it is deleted. The licence file is specific to a WebdynSunPM. The same file cannot be used on several concentrators. The licence file contents must not be modified, otherwise the concentrator's licence management will be blocked.
Page 74
• Enter the concentrator IP address in your browser (the default address is: http://192.168.1.12 for LAN1 and http://192.168.2.12 for LAN2) to access the WebdynSunPM home page. (see section 2.4.5: “Ethernet interface”) Parameters LAN1 LAN2 IP address 192.168.1.12 192.168.2.12 • An authentication window is displayed:...
Page 76
3.2.1 Quick Setup To make it easier to configure the WebdynSunPM, the concentrator includes a function to configure the different network interfaces and device configurations with an automatic device discovery function and the option of activating services built into into the concentrator. “Quick Setup" simplifies concentrator configuration by guiding the installer through simple steps.
Page 101
▪ device ▪ Serial1, Serial2 or Serial3: if the device is connected to one of WebdynSunPM's serial ports. For example, for a "modbus RTU” device. ▪ Input/Output: if you want to configure an input or output available on the concentrator.
Page 102
This new definition file will be available in the concentrator’s list of definition files. All definition files imported into WebdynSunPM that are not used for 24 hours will be automatically deleted by the concentrator the next time it connects remotely.
Page 104
All definition files imported into WebdynSunPM that are not used for 24 hours will be automatically deleted by the concentrator the next time it connects remotely. The model, category, and manufacturer are displayed when the definition file is loaded for the device.
Page 147
3.2.4 Control The WebdynSunPM concentrator has a powerful script-based device management and customisation tool also known as services. The tool is based on a LUA command interpreter used to run tasks on the concentrator in the background. A technical reference guide is available describing all the commands and possibilities of the supplied script language in detail.
Page 150
See the “WebdynSunPM LUA User Guide.pdf” document for more details of what can be done. Disabling a service meets stopping it running. When webdynSunPM is restarted, all the services return to the same state as before. For example, if the service was started, it will be started.
Page 161
The Modbus Slave section is used to enable or disable the Modbus slave (see section 3.4: “Modbus slave TCP”). When the Modbus slave is enabled using the web interface, only the WebdynSunPM registers are accessible. The user registers require a specific definition file and can only be configured from a server.
Page 163
Webdyn licence server, then the licence retrieval will be tracked in the log located below. The licence file is specific to a WebdynSunPM. The same file cannot be used on several concentrators. The licence file contents must not be modified, otherwise the concentrator's licence management will be blocked.
Page 166
Webdyn does not supply any SD cards. Contact a computer hardware retailer. WebdynSunPM is compatible with micro SDXC cards (15 x 11 mm) of a capacity of up to 32 Gb. 3.4 Modbus slave TCP The WebdynSunPM has a Modbus TCP slave function which is used to: •...
Page 167
Modbus response. When a group of registers associated with a variable is written, the WebdynSunPM writes the new value to the device as soon as possible. The response is only returned to the client when the operation has been completed.
Page 168
Lua scripts. The file must be present in the "/DEF" definition directory. If the "mapping file" field is empty, then only the WebdynSunPM variables are accessible. The Modbus slave is only accessible on the LAN. No modem access is authorised, even if the SIM card operator provides a public address.
Page 169
3.4.2.1 Predefined Webdyn variables The predefined Webdyn variables are stored in the part of the WebdynSunPM registers addressed between 0x8000 and 0xFFFF (32,768 to 65,535). The WebdynSunPM variables cannot be configured and are used to access certain WebdynSunPM data. The Webdyn variables are available at the following Modbus register addresses:...
Page 172
1;;0;;INVERTER1;Temperature;;;;;1 2;;1_4;;INVERTER1;E-Total;;;;;1 3;;3_20;;INVERTER2;Firmware Version;;;;;1 4;;13_24;;INVERTER2;;DisplaySerialNumber;;;;1 5;;25_8;;regulation;ValueRegulation;;;;;4 3.4.3 Modbus error management If an error occurs, the WebdynSunPM returns a Modbus exception code. The error cases are the following: Code Name Description 0x01 Illegal Function Function code not supported, i.e. other than 0x03, 0x06 or 0x10.
Page 173
A variable of which the size is incompatible with the number of registers is read or written. 0x71 No Such a Variable A device or variable is not known to the WebdynSunPM. 0x72 Invalid Action Writing to the target variable is not supported (Input Register, U8, etc.).
Page 174
It cannot create or modify the configuration or carry out any actions. 4.1 The FTP/SFTP/WebDAV server For the WebdynSunPM FTP, SFTP and WebDAV-HTTPS servers operate identically. However, the use of an SFTP or WebDAV-HTTPS server is preferable because it has built-in security layers which are not present on a classic FTP server.
Page 175
A root directory: The root directory can be “/”, the server root directory, or a series of sub-directories (for example: “/WebdynSunPM/00CF4/”). You can configure your concentrator remotely from your server. This is only possible if your WebdynSunPM is properly configured to upload and synchronise its configuration on it.
Page 177
The configuration “CONFIG” The concentrator can receive remote configurations in configuration files or from text messages. Configuration file: The WebdynSunPM concentrator needs 4 types of configuration file in text and CSV format. The files names are the following: • <UID>_config.ini •...
Page 180
The WebdynSunPM permanently collects the device and interface data and saves it. The reported values are always raw and must be connected to the device definition file. The contents of a data file are in 2 parts which are: ▪...
Page 187
<scriptwebdyn>: Webdyn proprietary script Examples: ControlPower.lua Injection.luax Deie.luaw For more details on script use, see the “WebdynSunPM LUA User Guide.pdf” document available at: https://www.webdyn.com/support/WebdynSunPM/ Proprietary Webdyn ".luaw" scripts are not re-uploaded by the concentrator if they are deleted on the remote server. 4.1.7 “BIN”...
Page 205
4.2.3 Commands Commands can be sent to the WebdynSunPM concentrator by the MQTT/MQTTS server. To do that, the "Command" and "Result" topics must have been entered in the concentrator configuration (see section 3.2.3.3.4: “MQTT”). When a command is published in the "Command" topic on the MQTT/MQTTS server, it is retrieved by the concentrator.
Page 207
5.2.1 Command file During an FTP, SFTP or WebDAV connection, the WebdynSunPM checks for the presence of a command file in the directory configured for that purpose ("/CMD" by default). The file name must be <UID>_cmd.json where <UID> is the gateway identifier.
Page 208
• rpcName: Script name and function to be run in <script name>.<function name> format. For a command, use the script name sunpm, which is reserved for internal WebdynSunPM commands. • parameters: Some functions and commands require additional parameters. Where that is not the case, this field is optional.
Page 209
“callerId”:”3d9311ed-0076-4f28-ac59-a2debfa35b86” 5.2.2 MQTT command message WebdynSunPM can receive MQTT format command messages. Of course, that requires a configured MQTT server (see section 3.2.3.3.4: “MQTT”). The command and result topics must have been entered. WebdynSunPM subscribes to the command topic so that all messages sent to it are received and run. The result of a command or function call is published in the result topic.
Page 210
5.2.3 Text message Text message commands can be sent to the WebdynSunPM modem. To do that, check that the modem is correctly configured (see section 3.2.2.2: “Modem (Mobile)”). Text message commands do not use JSON format. Instead, the accepted format is as follows: <command 1>=<parameter 1>:<parameter 2>:<parameter 3>...
Page 212
The available commands are described below with the expected parameters and the returned results. 5.3.1 “connect”: Connection trigger Asks the WebdynSunPM to start a connection to the server. That forces the settings to be synchronised with the server and all the log files to be uploaded. The connection is launched immediately.
Page 215
• addr: Server address in login@server-address:server-port format. • last: The date and time the WebdynSunPM last connected to server 1 and the connection result in the following format: “DD/MM HH:MM <connection result>”. 5.3.3 “factory”: Back to factory settings Reset the WebdynSunPM. The configuration files and the device acquisition data are deleted and the product is rebooted immediately.
Page 229
The file containing the keys must be made available on a server so that it can be downloaded by the command. For more details on the key format for Lua scripts, see document "WebdynSunPM LUA User Guide.pdf".
Page 234
6 Update The WebdynSunPM concentrator can be updated locally using the web interface or remotely by FTP, SFTP or WebDAV-HTTPS. The latest firmware version (“WebdynSunPM_x.x.x.zip”) is available for downloading from our web site at the following address: https://www.webdyn.com/support/webdynsunpm/ Once the download is complete, unzip the file with contains 2 files: •...
Page 236
On the WEB interface "Dashboard" page, the "Site information" part shows all the devices and is used to quickly detect those that have anomalies. (See section3.2: “Embedded web interface”) If necessary, the WebdynSunPM can be rebooted remotely using the “reboot »” text message command (See section 5.3.4: ““reboot”: Concentrator reboot”).
Page 237
Gateway configuration: How do I access the gateway configuration? Start by checking that the computer’s IP parameters are compatible with the WebdynSunPM IP address (by default 192.168.1.12) Launch a web browser (Chrome, Firefox, Edge, Safari, etc.) and enter the WebdynSunPM concentrator IP address in the address bar.
Page 240
The WebdynSunPM can store up to 50Mb of uncompressed data per declared device. If there is no access to the remote server, the WebdynSunPM concentrator can store the data for several months. The maximum data storage time varies depending on the amount of data to be collected and the configured collection frequency.
Page 241
• All the devices must be configured with identical bus characteristics: same speed, same parity, same number of stop bits and data bits on all the devices and in the WebdynSunPM. • Each device must be assigned a unique Modbus address (between 1 and 247) on the bus. (UnitID) contact@webdyn.com |...
Page 262
10.3 Appendix C: Compatible inverters The WebdynSunPM is compatible with all MODBUS and SUNSPEC MODBUS inverters as well as inverters compatible with the following proprietary protocols: • DELTA • KACO • SMANET • SOLARMAX It also allows the automatic detection of the following inverters: 10.3.1 ABB...
Need help?
Do you have a question about the WebdynSunPM and is the answer not in the manual?
Questions and answers