Flexitron Webdyn SunPM User manual

WebdynSunPM
User Manual
www.webdyn.com

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
2
Index
Glossary ............................................................................................................................ 5
About this Document ....................................................................................................... 8
1. Presentation.......................................................................................................................................... 10
1.1 General Description ................................................................................................................. 10
1.2 Principles of Operation ............................................................................................................ 10
1.3 The Interfaces .......................................................................................................................... 11
1.4 Supported Devices................................................................................................................... 12
1.5 Product References.................................................................................................................. 12
1.6 Technical Specications .......................................................................................................... 13
1.6.1 General Specications ............................................................................................... 13
1.6.2 Technical Specications............................................................................................. 14
1.6.3 Software Specications ............................................................................................. 16
1.7 Safety Instructions ................................................................................................................... 17
1.8 Regulation................................................................................................................................. 17
2. Installation and Maintenance.............................................................................................................. 19
2.1 Prerequisite .............................................................................................................................. 19
2.2 Unpacking................................................................................................................................. 19
2.2.1 Content........................................................................................................................ 19
2.2.2 Identication ............................................................................................................... 19
2.3 Assembly................................................................................................................................... 22
2.3.1 Opening/Closing the Box ........................................................................................... 22
2.3.2 Wall Mounting............................................................................................................. 22
2.4 Interface Description ............................................................................................................... 23
2.4.1 Product Power Supply................................................................................................. 23
2.4.2 Cellular Network ........................................................................................................ 24
2.4.3 Indicators & Buttons .................................................................................................. 26
2.4.4 Extension Interface .................................................................................................... 30
2.4.5 Ethernet Interface ...................................................................................................... 31
2.4.6 RS485/RS422 Serial Interface................................................................................. 32
2.4.7 Input/Output Interface............................................................................................... 35

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
3
3. Conguration......................................................................................................................................... 41
3.1 ................................................................................................................................................... FTP/
SFTP/WebDAV................................................................................................................................. 41
3.1.1 Operating Principle ..................................................................................................... 42
3.1.2 Conguration Files...................................................................................................... 42
3.1.3 Updates ....................................................................................................................... 67
3.2 Embedded Web Interface........................................................................................................ 68
3.2.1 Devices........................................................................................................................ 70
3.2.2 Settings ....................................................................................................................... 91
3.2.3 System......................................................................................................................... 132
3.3 Carte Micro SD ......................................................................................................................... 140
4. Operation............................................................................................................................................... 142
4.1 The FTP/SFTP/WebDAV Server ............................................................................................... 142
4.1.1 The Conguration “CONFIG” ...................................................................................... 145
4.1.2 “DEF”, the Denitions................................................................................................. 146
4.1.3 “DATA”.......................................................................................................................... 147
4.1.4 “ALARM” Alarms.......................................................................................................... 152
4.1.5 “CMD” Commands...................................................................................................... 155
4.1.6 “SCRIPTS” ................................................................................................................... 155
4.1.7 “BIN” Update............................................................................................................... 155
4.1.8 “LOG”........................................................................................................................... 156
4.2 The MQTT/MQTTS server ........................................................................................................ 162
4.2.1 Data format................................................................................................................. 164
4.3 microSD card............................................................................................................................ 171
5. Commands............................................................................................................................................ 173
5.1 Principle .................................................................................................................................... 173
5.2 How it Works............................................................................................................................. 173
5.2.1 Command le.............................................................................................................. 173
5.2.2 MQTT command message ......................................................................................... 175
5.2.3 SMS ............................................................................................................................. 176
5.3 List of Commands .................................................................................................................... 176
5.3.1 “connect”: Trigger a connection ................................................................................ 177

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
4
5.3.2 “status”: Retrieval of the status of the concentrator ............................................... 178
5.3.3 “factory”: Return to factory settings.......................................................................... 180
5.3.4 “reboot”: Rebooting the concentrator....................................................................... 181
5.3.5 “updateFirmware”: Concentrator software update.................................................. 181
5.3.6 “apn”: Modem conguration ..................................................................................... 182
5.3.7 “ftp”: Conguration of the FTP/SFTP server............................................................. 183
5.3.8 “log”: Activation of equipment communication logs................................................ 184
5.3.9 “setRelay”: Changing the state of the relay .............................................................. 185
5.3.10 “discoverDevices”: Discovery of equipment........................................................... 185
5.3.11 “getParameters”: Collection of variables dened in action................................... 186
5.3.12 “writeVariable”: Writing a variable on a device ...................................................... 187
6. Update ................................................................................................................................................... 188
6.1 Using the Web Interface .......................................................................................................... 188
6.2 Using FTP/SFTP/WebDAV........................................................................................................ 188
6.3 By SMS or MQTT/MQTTS command....................................................................................... 189
6.4 By micro SD card...................................................................................................................... 189
7. Tools & Diagnostics............................................................................................................................... 190
7.1 Diagnostics................................................................................................................................ 190
7.2 Tools .......................................................................................................................................... 190
8. FAQ......................................................................................................................................................... 191
9. Appendices............................................................................................................................................ 196
9.1 ...................................................................................................................................................
Appendix A: “_cong.ini” le........................................................................................................... 196
9.2 Appendix B: Time zone list....................................................................................................... 211
Ofces & Support Contact............................................................................................... 214

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
5
Glossary
NAME DESCRIPTION
2G Second Generation: second generation (2G) digital standard for cell phones
including GSM, GPRS and EDGE.
3G Third Generation: third generation (3G) digital standard for cell phones including
UMTS, HSPA, HSPA+ and DC-HSPA+.
4G Fourth Generation: fourth generation (4G) digital standard for mobile telephony
including LTE-Advanced.
AES Advanced Encryption Standard: symmetrical encryption algorithm.
APN Access Point Name: the name of the access point the gateway uses to connect to
the Internet via a mobile connection.
Broker MQTT server in charge of receiving published information in order to transmit it to
subscribed clients. The broker has a relay role.
CSV Comma-separated values: open text format representing tabulated data in the form
of values separated by semi-colons. This format makes it easy to use data with
spreadsheet software such as Excel.
DNS Domain Name System: distributed computer service used to translate Internet
domain names to IP addresses.
FTP File Transfer Protocol: communication protocol used to exchange les over a TCP/IP
network.
HTTP HyperText Transfer Protocol: client-server communication protocol developed for the
Web.
IMEI International Mobile Equipment Identity: number used to uniquely identify each
modem.
IMSI International Mobile Subscriber Identity: unique number stored in the SIM card used
by a cell phone network to identify a user.
IP Internet Protocol: message protocol in charge of addressing and sending TCP
packets over the network.
Lua Script language. See http://www.lua.org/ for more details.

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
6
Modbus Modbus is a communication protocol routinely used by industry to dialogue with
industrial equipment over a network. See http://www.modbus.org/ for more details.
MQTT Message Queuing Telemetry Transport: publish-subscribe messaging protocol based
the TCP/IP protocol.
MQTTS Secure Message Queuing Telemetry Transport.
NTP Network Time Protocol: protocol used to synchronise the local concentrator clock
with a time reference via a computer network.
DIN rail Standard 35 mm metal rail used in racked industrial control equipment in Europe.
RSSI Received Signal Strength Indication: reception power level measurement of a signal
issued by a radio antenna.
RTU RTU mode is an RS422/485 hard-wired bus for Modbus.
S0 Standardised pulse from meters (water, gas, electricity, etc.) as per the NF EN
62053-31 standard.
SFTP SSH File Transfer Protocol: communication protocol using a secure SSH
communication protocol. Its use is similar to FTP.
IS Information System: server with which the concentrator exchanges (conguration,
data, alarms, etc.).
Sunspec Open communication protocol for inverters based on Modbus and compliant with
the SunSpec alliance standards (See https://sunspec.org/for more details).
TCP Transmission Control Protocol: an Internet-based connection-oriented protocol
that provides data packet segmenting services that the IP protocol sends over the
network. This protocol provides a reliable data transfer service. See also IP.
TCP/IP Transmission Control Protocol/Internet Protocol: a set of network protocols that
provide interconnection services between computers of different hardware
architectures and operating systems. TCP/IP includes standards for communication
between computers and conventions for network interconnection and routing.
TIC Customer remote information: digital data output from ERDF meters that
permanently broadcasts the managed contractual parameters as well as the
consumption magnitudes measured by the meter.
Topic MQTT information channels that publishers use to send messages. These messages
can be read by subscribers.

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
7
UDP User Datagram Protocol: non connection-oriented protocol of the TCP/IP model
transport layer. This protocol is very simple because it does not provide error checks
(it is not connection-oriented...).
UTF-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 the management of remote les. As part
of the WebdynSunPM, the WebDAV protocol is used over HTTPS. We are therefore
talking about WebDAV-HTTPS.

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
8
About this Document
This guide describes all the WebdynSunPM product characteristics.
Its purpose is to help operators install and congure their WebdynSunPM and to allow operators to
include collected data in their IS.
This manual is split into six separate sections:
• Section 1: General presentation
• Section 2: Installation
• Section 3: Conguration
• Section 4: Operation
• Section 5: Tools & diagnostics
• Section 6: FAQ
Scope
This technical description is valid for WebdynSunPM concentrators as from hardware version V1 and
software version V3.0.0.
Target Audience
This guide is intended for all people involved in photovoltaic system supervision, in particular people in
charge of local or remote installation maintenance, as well as for the developers of portals designed to
use the sent data.
It is recommended to entrust the installation and commissioning of the WebdynSunPM to qualied and
trained persons. Qualied persons must have the following skills:
• Detailed knowledge of network management services.
• Knowledge of IP-based network protocols.
• Knowledge of the specications of the protocols used (Modbus, SunSPec, etc.) and of the
equipment connected to the concentrator.
• Training in the installation and conguration of computer systems.
• Knowledge of and compliance with this document and all safety information.

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
9
Document Versions
VERSION CONTENT
V2.05 Manual creation
V3.0 Micro SD card management
Added WebDAV
Added MQTT
Application notes for ICT and proprietary protocols
Modication of the edition and creation of equipment
Added WebdynSunPM 4G version

[e-mail] | webdyn.com
V2.05 subject to changes | Webdyn © by Flexitron Group
10
1. Presentation
1.1 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). The concentrator provides the security and condentiality of the exchanged information.
The automation of certain local actions, for example injection or self-consumption is managed using
customisable scripts embedded in the concentrator.
1.2 Principles of Operation
The WebdynSunPM concentrator can be fully integrated into photovoltaic installations. Devices such as
inverters, sensors (pyranometers, temperature sensors, etc.), meters, displays, circuit breakers or relays
can be connected to the concentrator using its many available interfaces. Information readings and
device control are carried out by the WebdynSunPM continuously. The data is regularly formatted and
uploaded to an FTP server and/or sent to an MQTT server using the modem or an Ethernet connection.
The concentrator manages the SFTP and MQTTS protocols to secure exchanges with the servers. The
WebdynSunPM can be congured by simply sending text message commands, but also using the
embedded web pages.
Specic scripts can be created for installations requiring specic functions.
Inverters
Circuit,
breaker, relay
PLC
Ethernet/
4G/3G/2G
Modbus slaves
WebdynSunPM
Meters
Sensors
Electric grid
management system
Server 2
Server 1 User
Inverter protocol
Modbus RTU/TCP
Pulse input
0-10V / 4-20mA
Dry contact
Modbus
Dry contacts, 4-20mA, Modbus,
propietary protocol...
888888
User