Table of Contents
Start using ↵
Quick to use ↵
1. Software introduction¶
Software introduction¶
PBox-Logger is a special device for photovoltaic power generation systems that integrates data collection, protocol conversion, data storage, centralized monitoring and maintenance. It has a built-in web server and can be accessed and configured through a browser without the need to install additional debugging software. It is easy to operate and It has the characteristics of complete functions, remote debugging, convenient maintenance, and support for power dispatching.
Running environment¶
-
System Requirements
There is no operating system requirement, any system is acceptable;
-
Browser requirements
Chrome browser, Firefox browser, edge browser are all available.
Configure local IP¶
The factory default IP of the gateway is 192.168.11.177 (NET1), 192.168.12.177 (NET2). Before use, please use a network cable to connect the computer network port and the gateway's NET1 (or NET2), and add the calculated Configure the IP address to 192.168.11.178 (the same network segment is acceptable), and then use a browser to access https://192.168.11.177/.

Default account¶
Please change the default password as soon as possible after logging in.
| Username | Default password | Description |
|---|---|---|
| admin | public | Advanced user, administrator account |
| user | public | Operator account |
| visitor | 123456 | Visitor account, read-only permission |
2.Project wizard¶
New roject wizard¶
On the top menu bar, click Maintenance -> Channel Management -> New Project Wizard, and the New project Wizard will pop up. There are two steps in total。

Add device¶
Based on the actual RS485 connection, select the corresponding point table template under different COM ports, and then add the next step;

Forwarding management¶
Select the protocol to be forwarded. Currently, only IEC104 forwarding and MODBUS-TCP forwarding are supported.
The project takes effect immediately after completion. By default, if you remove the check box, you need to manually restart application;
Finally click Finish, please later the gateway will automatically create the project according to the wizard, depending on the number of inverters required time。

Configuration fine-tuning¶
Currently, you can modify only the protocol feature configuration, some parameters of the channel, and some parameters of the device。
Protocol feature configuration : Add IV Scan¶
Open the Protocol Settings of the MODBUS-RTU acquisition channel you want to configure for IV scanning, scroll down to find the CHINT IV Curve Listening (UDP) Port option, and configure the corresponding port.


3.Monitor Data¶
1.View overview data¶
View inverter operating data¶
On the top menu bar, click Overview -> Power Station Operation Information to view the overview data, which contains power station summary data and a list of key data for each inverter,

View Active Alarm data¶
In the top menu bar, click Overview->Active Alarms to view the active alarm data, which contains a variety of Alarm data for each device, we can filter the query based on device, fault status, confirm status, Severity, start and end time, object model identification, and we can check the Alarm data one by one as well as batch confirmation. Alarm data can be confirmed one by one and in batch.

View Power staion¶
Top menu bar, click Overview->Power Station Historical Data to view power station historical data, which contains Power Station Historical Summary Data, we can filter the query according to Start and End Time.

View Device historical data¶
Top menu bar, click Overview->Device Historical Data to view the device historical data, which contains each Device Historical Summary Data, we can filter the query based on Device, Start and End Time.

2.View live data¶
On the top menu bar, click Monitoring -> Device Monitoring to view detailed real-time data;
You can select a target device in the left tree to view the real-time data of a device。

3.View channel monitoring¶
Click Maintenance on the top menu bar, and click the Channel Monitor button on the right of the target channel in the channel list to view real-time communication messages in the pop-up TAB。


4.Operation menu¶
Operation menu¶
The upper-right corner of the top-level menu bar displays the current language and the login user. Click to pop up the operation menu。

Modify language¶
Click Simplified to change the language to English. Currently, only simplified Chinese and English are supported。

Change password¶
Click the login user, click Change password in the pop-up menu, you can change the password of the current account。

Restart application¶
Click the login user, click Restart application in the pop-up menu, you can restart the collection process and statistics and history storage process。

Restart gateway¶
Click the login user and click ** Restart Gateway ** in the pop-up menu to restart the gateway. After restarting the gateway, you need to log in again。

Log out¶
Click the login user, click Log out in the pop-up menu, you can log out。

Ended: Quick to use
Logger configure ↵
1.Network settings¶
IP configuration¶
On the top menu bar, click Settings -> Communication Parameters ->IP Configuration, you can configure the IP of the gateway。

The upper part of the figure below is the configuration of the gateway IP address, subnet mask and other parameters, the lower part can configure the gateway route, after the addition is completed, you need to click Set button will be delivered to the gateway, the configuration takes effect immediately;
warn
Multi-network port device,The IP addresses of different network adapters cannot be in the same network segment,Otherwise, it will cause ** to be unable to connect to the Internet ** or ** network communication abnormal !
For example, if 192.168.1.100 is configured for NET1 and 192.168.1.200 is configured for NET2, this parameter is not allowed。
Note
If set as the default route is selected and the Internet of Things card is inserted, the Internet access priority of the gateway is Wired network > 4G dial;
Only one NIC can be modified at a time. After the modification is complete, click Settings to deliver the modification to the gateway. The modification takes effect immediately;
If you do not modify the Settings, the previous Settings will be lost when you switch the network adapter。

| Attribute | Instructions |
|---|---|
| Network card | NET1 indicates the first network card of the gateway, NET2 indicates the second network card, and so on |
| Whether to enablet | Enabled by default; If no is selected, this network port of the gateway will be used as a DHCP server to provide network to other devices |
| IP acquisition method | Select Static IP(Recommended),Then you need to manually configure the IP address;Select DHCP(Not recommend),Then the router (or other DHCP server) assigns the IP address |
| Default gateway | If the gateway accesses the Internet through this network card, you need to fill in Default gateway |
| Whether to set as the default route | If the gateway accesses the Internet via SIM card 4G, then select ** No ; If the gateway accesses the Internet through this network card, then select ** Yes . There can be only one default route. If multiple routes are set, the one with the smaller NET index takes effect first. If this parameter is modified, the gateway disconnects and reconnects for about 10 seconds |
| IP address | IP address of the NIC. A maximum of 10 different IP addresses can be added |
| Subnet mask | The subnet mask of the network adapter is automatically filled after the IP address is configured |
| gateway route | This parameter is reserved for compatibility with gateways of older software versions. You can leave this parameter blank. For details about how to add a route, see the following parameters |
| Target | Specifies the range of IP addresses that match the route, for example:192.168.100.0/24 |
| Next hop | The next point of the route, for example:192.168.0.1, indicates that the data in the network segment 192.168.100.xxx is transferred from 192.168.0.1 |
Ended: Logger configure
Logger debugging ↵
1.Serial port debugging¶
Open the serial port¶
First, select the serial port to debug,Set the parameters of the serial port correctly,Then click the ** Open ** button to open the serial port。

Look out
After the serial port is enabled, the service communication through the serial port is temporarily suspended. Ensure that services are not affected before performing this operation。
Manual organizing message¶
For example, if you want to read the total energy output of an inverter with RTU address 1, function code 0x04, register address 22 in decimal notation, and read two registers, the message to be sent should read as follows:
01 04 00 16 00 02
Because the CRC check is checked by default, CRC will be automatically included at the end of sending without manual calculation;
As shown below,greenindicates the packet sent by the gateway,Blueindicates the content received by the gateway,You can see that the register data of the total power generation is 00 00 00 5B ;

If there is no response, enlarge the timeout period and try again, or check whether the serial port parameters are correctly configured and the device address is correct。

Close the serial port¶
After debugging is complete, turn off the serial port. Otherwise, services will be interrupted。

2.Command line debug¶
ping(Network test)¶
Select ping(network test) command, fill in the domain name or IP address to be tested in the right edit box, click send, you can ping test。
tip
Some ip addresses (or domain names) cannot be pinged. In this case, use Port detection function
Network normal condition:

Network anomaly:

telnet(Port detection)¶
Select telnet(Port detection) command,The format is IP address (or domain name)+Space+Port number,In the following figure, although the gateway cannot ping 172.20.1.189(possibly because the 172.20.1.189 firewall is enabled), the port detection can be successful, which indicates that they can communicate with each other.
tip
Even if the port is successfully opened, the communication may fail. For example, the target machine has restrictions on the IP whitelist, connection number, and user name and password authentication。
The port under test is open:

The port under test is closed:

ifconfig(Check IP address)¶
Select the ifconfig(Check IP address) command. If no parameter is specified, the information about all nics is obtained. If the name of the target NIC is specified, only the information about the target NIC is obtained。
tip
eth0 corresponds to NET1, and so on。

route(View Routing table)¶
Select the route(View Routing table) command, then the -n parameter will be automatically filled. Click ** to send ** to obtain the information of the current routing table 。

ls(view file list)¶
Select ls(view file list) command, enter the path, you can view the file list。

ps(View process list)¶
Select ps(View process list) command, at this time will automatically fill -aux parameter, you can view the process list。
tip
If the process list fails to be obtained, delete the default parameter -aux and try again。

uptime(View time information)¶
You can run the uptime(View time information) command to view the current time of the gateway, the running time, and the 1, 5, and 15-minute average load of the system。

df(check dist usage)¶
select df(check dist usage) command,You can view the current disk usage of the gateway。

get_pro_ver(check driver version number)¶
select get_pro_ver(check driver version number) command,You can see the current version number of the protocol driver, and the driver names can be separated by commas。

View logs¶
select View collection log command,Parameter 100 indicates the number of lines to view, the command is dynamically refreshed in real time, if no longer need to view, click ** Stop ** button;
You can view run logs, interface logs, collection logs, storage logs, restart logs, reset logs, operate logs and inverter operate logs.

Ended: Logger debugging
Firmware upgrade¶
Select a archive¶
Click the Select File button to select the upgrade compressed package on your computer. The file name usually starts with ioserver_bin and ends with tar.gz, for example, ioserver_bin_en-A53-2.0.09-20240219.tar.gz;
The gateway will verify the upgrade compressed package. If the verification fails, no operation will be performed;
If the verification is successful, it means that the upgrade compressed package has passed the check and been downloaded to the gateway. At this time, the upgrade package will not take effect until you operate Restart Gateway on the web page. It will not take effect without restarting.

Query upgrade operation records¶
Click the Refresh button to query all upgrade operation records and save the latest 100 records;
Click the Copy button to copy the recorded text content.

Authorization information¶
Inquire¶
Click the Refresh button on the right side of the authorization information to refresh the current authorization.

Update authorization¶
Click the Copy Machine Code button to send the machine code to the technical support engineer. The engineer will send back the authorization code. Fill the authorization code into the edit box for update authorization. Click the Update Authorization button to update the authorization. ;
The updated authorization requires the operation Restart Application to take effect.

2.IV Scan¶
Add IV Scan¶
Open the Protocol Settings of the MODBUS-RTU acquisition channel you want to configure for IV scanning, scroll down to find the CHINT IV Curve Listening (UDP) Port option, and configure the corresponding port.


about¶
Maintenance->About menu displays the basic information of the software, which can be modified including Software Name, Company Name, System Language, Icon, and Power Station Picture these parameters.

Ended: Start using
driver help ↵
MODBUS protocol ↵
modbus-rtu采集¶
云端配置(modbus-rtu采集)¶
新建通道¶
新建一个采集通道,协议选择MODBUS-RTU,主参数中,串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1,以此类推),其它参数如无特殊要求保持默认即可;
提示
本协议支持切换协议类型为TCP,可做TCP Server接收DTU数据,此时设备公共地址填DTU的注册帧字符串。


新建设备¶
新建一个设备,自定义设备名称,通讯地址填写modbus从站的485地址,其余参数留空即可。

新建测点¶
举例新建一个保持寄存器测点,已知寄存器地址为4100,数据类型为16位有符号位整型,那么功能码选择03,06号命令,地址填写4100,数据类型选择16位有符号,数据格式(高低位)选择12。
提示
有些设备的点表在描述时,可能会将寄存器类型作为数字拼接到寄存器的最高位,例如“4100”,也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。

举例读字符串数据,该字符串保存在保持寄存器中,已知寄存器地址为260,字符串值长度为9,那么功能码选择03,06号命令,地址填写260,数据格式(高低位)选择21(根据实际情况可以更改为12),数据类型选择字符串,此时系数一栏会变成字符串长度,在此填写9。
提示
为了避免字符串读取不全,本驱动中对长度做了x2处理,所以此处填5(计算时长度补足为偶数然后除以2(9+1)/2=5)或者9都是能读到的。

本地配置(modbus-rtu采集)¶
展开查看视频
新建通道¶
新建一个采集通道,协议选择MODBUS-RTU,主参数中,串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1,以此类推),其它参数如无特殊要求保持默认即可;
提示
本协议支持切换协议类型为TCP,可做TCP Server接收DTU数据,此时设备公共地址填DTU的注册帧字符串。

新建设备¶
新建一个设备,自定义设备名称,通讯地址填写modbus从站的485地址,其余参数留空即可。

新建测点¶
举例新建一个保持寄存器测点,已知寄存器地址为4100,数据类型为16位有符号位整型,那么功能码选择03,06号命令,地址填写4100,数据类型选择16位有符号,数据格式(高低位)选择12。
提示
有些设备的点表在描述时,可能会将寄存器类型作为数字拼接到寄存器的最高位,例如“4100”,也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。
注意
使用01、02功能码读取时,测点数据类型必须为位;
使用03、04功能读取,且需要按位取值时,测点数据类型应该为16位有/无符号或32位有/无符号。

举例读字符串数据,该字符串保存在保持寄存器中,已知寄存器地址为260,字符串值长度为9,那么功能码选择03,06号命令,地址填写260,数据格式(高低位)选择21(根据实际情况可以更改为12),数据类型选择字符串,此时系数一栏填写字符串长度9。
提示
为了避免字符串读取不全,本驱动中对长度做了x2处理,所以此处填5(计算时长度补足为偶数然后除以2(9+1)/2=5)或者9都是能读到的。

modbus-rtu转发¶
云端配置(modbus-rtu转发)¶
新建通道¶
新建一个转发通道,协议选择MODBUS-RTU(转发),主参数中,串口名称按照网关实际的接线情况选择对应的COM口,其它参数如无特殊要求的留空即可;

新建设备¶
新建一个设备,自定义设备名称,设备通讯地址为MODBUS协议转发出去的从站设备地址,其余参数留空即可。

新建测点¶
提示
不管用哪种功能码转发,您可以任意指定地址,尽管它们是不连续的,留空的地址默认实时值为0;
需要注意的是,地址在递增时,位、8位、16位有/无符号步长为1(例如27、28、29...),32位有/无符号或单精度浮点数步长为2(例如12、14、16...)。
保持寄存器(0x03功能码)¶
举例转发一个保持寄存器测点,测点可以批量新增已有的采集点或中间点为转发测点;
已知寄存器地址为4100,数据类型为int(16位有符号),那么功能码选择03,06号命令,地址填写4100,数据类型选择16位有符号,数据格式(高低位)选择12;如下图:
提示
转发测点的寄存器地址从0开始,最小地址为0;
输入寄存器(0x04功能码)建点过程与保持寄存器(0x03功能码)一致。

假设上述测点当前值为6789,Modbus Poll读取报文如下:
发送>>01 03 10 04 00 0A 80 CC
接收<<01 03 14 1A 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 1C 4D
配置如下:

离散寄存器(0x01功能码)¶
举例转发一个离散寄存器测点,已知寄存器地址为4,数据类型为BIT(位),那么功能码选择01,05号命令,地址填写4,数据类型选择位,高低位选择12。
提示
转发测点的寄存器地址从0开始,最小地址为0;
离散输入寄存器(0x02功能码)建点过程与离散寄存器(0x01功能码)一致。

假设上述测点当前值为1,Modbus Poll读取报文如下:
发送>>01 01 00 00 00 0A BC 0D
接收<<01 01 02 10 00 B4 3C
配置如下:

本地配置(modbus-rtu转发)¶
新建通道¶
新建一个转发通道,协议选择MODBUS-RTU(转发),主参数中,串口名称按照网关实际的接线情况选择对应的COM口,其它参数如无特殊要求的留空即可;

新建设备¶
新建一个设备,自定义设备名称,设备通讯地址为MODBUS协议转发出去的从站设备地址,其余参数留空即可。

新建测点¶
提示
不管用哪种功能码转发,您可以任意指定地址,尽管它们是不连续的,留空的地址默认实时值为0;
需要注意的是,地址在递增时,位、8位、16位有/无符号步长为1(例如27、28、29...),32位有/无符号或单精度浮点数步长为2(例如12、14、16...)。
保持寄存器(0x03功能码)¶
举例转发一个保持寄存器测点,测点可以批量新增已有的采集点或中间点为转发测点;
已知寄存器地址为4100,数据类型为int(16位有符号),那么功能码选择03,06号命令,地址填写4100,数据类型选择16位有符号,数据格式(高低位)选择12;如下图:
提示
转发测点的寄存器地址从0开始,最小地址为0;
输入寄存器(0x04功能码)建点过程与保持寄存器(0x03功能码)一致。

假设上述测点当前值为6789,Modbus Poll读取报文如下:
发送>>01 03 10 04 00 0A 80 CC
接收<<01 03 14 1A 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 1C 4D
配置如下:

离散寄存器(0x01功能码)¶
举例转发一个离散寄存器测点,已知寄存器地址为4,数据类型为BIT(位),那么功能码选择01,05号命令,地址填写4,数据类型选择位,高低位选择12。
提示
转发测点的寄存器地址从0开始,最小地址为0;
离散输入寄存器(0x02功能码)建点过程与离散寄存器(0x01功能码)一致。

假设上述测点当前值为1,Modbus Poll读取报文如下:
发送>>01 01 00 00 00 0A BC 0D
接收<<01 01 02 10 00 B4 3C
配置如下:

modbus-tcp转发¶
云端配置(modbus-tcp转发)¶
新建通道¶
新建一个转发通道,协议选择MODBUS-TCP(转发),主参数中,IP地址保持默认即可,端口号按需修改;
提示
报文序列号、IP白名单、连接数等更多设置见规约特征页面。

剩余步骤参照modbus-rtu转发(标准)。
本地配置(modbus-tcp转发)¶
新建通道¶
新建一个转发通道,协议选择MODBUS-TCP(转发),主参数中,IP地址保持默认即可,端口号按需修改;
提示
报文序列号、IP白名单、连接数等更多设置见规约特征页面。

剩余步骤参照modbus-rtu转发(标准)。
Ended: MODBUS protocol
electricity protocol ↵
IEC-104 protocol ↵
104从站转发¶
云端配置(104从站转发)¶
新建通道¶
新建一个转发通道,协议选择104从站转发(IEC),通道地址填写本104从站的RTU地址,主参数中,IP地址填写0.0.0.0,端口号填2404,通讯方向选择等待接入(服务端);
提示
通讯方向通常都是等待接入,以实际情况为准可选主动连接。
注意
RTU地址在以下2种情况下使用转发设备的通讯地址:
-
存在多个转发设备时.
-
只有一个转发设备,且通道地址等于1时。

规约特征中可以配置104协议相关参数以及IP白名单等,参数详解见下表(简单参数不再赘述)。

| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息, 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息,31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1),变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据,也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭,填1开启,则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
新建设备¶
当只有一个主站来采集,且只有一份转发表时,设备的参数保持默认无需修改,无实际意义;

当有多个主站来采集,且监听的IP地址和端口号相同,且转发点表不同时,在设备的通讯地址填写从站RTU地址,设备的公共地址填写主站IP,此时会根据连入主站的IP自适应不同设备下的转发点表进行转发;
例如,主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集,且他们的转发点不同,那么建两个转发设备,公共地址分别对应两个主站的IP地址。

新建测点¶
举例转发一个遥测点,其104寄存器地址为4001H,新建一个测点,功能码选择遥测量YC,地址填0(即4001H减去104遥测基地址4001H),数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时,相关配置见规约特征。

本地配置(104从站转发)¶
新建通道¶
新建一个转发通道,协议选择104从站转发(IEC),通道地址填写本104从站的RTU地址,主参数中,IP地址填写0.0.0.0,端口号填2404,通讯方向(即角色)选择等待接入(服务端);
提示
通讯方向(即角色)通常都是等待接入,以实际情况为准可选主动连接。

规约特征中可以配置104协议相关参数以及IP白名单等,参数详解见下表(简单参数不再赘述)。

| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息, 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息,31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1),变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据,也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭,填1开启,则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
新建设备¶
当只有一个主站来采集,且只有一份转发表时,设备的参数保持默认无需修改,无实际意义;

当有多个主站来采集,且监听的IP地址和端口号相同,且转发点表不同时,在设备的通讯地址填写从站RTU地址,设备的公共地址填写主站IP,此时会根据连入主站的IP自适应不同设备下的转发点表进行转发;
例如,主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集,且他们的转发点不同,那么建两个转发设备,公共地址分别对应两个主站的IP地址。

新建测点¶
举例转发一个遥测点,其104寄存器地址为4001H,新建一个测点,功能码选择遥测量YC,地址填0(即4001H减去104遥测基地址4001H),数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时,相关配置见规约特征。

Ended: IEC-104 protocol
Ended: electricity protocol
Ended: driver help
extensions ↵
1.Configure AC-PLC¶
Whitelist setting¶
1.Open serial port¶
Select the serial port to operate, baud rate and master PLC address according to the actual configuration (usually keep the default can be), click the open button, you can open the serial port。
tip
Enabling a serial port temporarily stops the service communication under the serial port. Ensure that services are not affected before you perform this operation。

2.Disabling whitelisting¶
Check the current whitelist status. If unknown is displayed, click the refresh button on the right of unknown to refresh the current whitelist status;
If the whitelist status is Enable, then click the Disable button to temporarily disable the whitelist;
If the whitelist status is Disabled, proceed to the next step。

3.current network node is updated¶
Refresh Current node until data appears in the list below;
If the whitelist is disabled, it takes about 10 seconds for a node to be connected to the network. If the node cannot be refreshed for a long time, check the serial port connection and try again。

4.Overwrite/append to whitelist and apply¶
Check whether the updated node SN meets expectations. By default, all nodes are selected. You can deselect the nodes you do not want,
Then click the button Overlay to Whitelist and apply(recommended) or Add to whitelist and apply to send the whitelist to PLC。

5.Check the whitelist¶
Click Query Whitelist button, check the content of the whitelist configured in the previous step, click Enable button to enable the whitelist。

6.Restart PLC¶
Click the Restart PLC button to restart the PLC。

7.Add, empty, and delete¶
Click the Add button to manually add SN to the whitelist. If you add multiple SN's, separate them by newlines。
Note
The length of a single SN is up to 16 bits. The high bits less than 16 bits are automatically filled with zero, and the high bits more than 16 bits are automatically truncated。

Click Clear blank list button, you can clear the current whitelist configuration, use caution。

Click Delete button, you can delete a whitelist record, will not take effect immediately, need to manually restart the PLC。

8.Close serial port¶
Click Close button to turn off the serial port, after the configuration is complete must close the serial port。

2.Sub-device upgrade¶
Open the serial port¶
First select the serial port to be debugged and configure the correct parameters of the serial port, then click the Open the serial port button to open the serial port.

Look out
Opening a serial port temporarily suspends the business communication of that port, please ensure that there is no impact on the business before operation.
Search for equipment¶
First, configure the query parameters, select the Search for equipment command, and wait for a moment to search for the relevant devices.

Download Firmware¶
After the execution of the command to open the serial port, tick the device you want to download the firmware, select the type/name of the firmware to be downloaded, select the Select a file command, and then the pop-up window will appear to select the corresponding firmware, and then you can execute the firmware download operation.

Sub-equipment upgrades¶
After performing all the above operations, select the Upgrade command, at which time the upgrade operation will be performed.
Look up
Do not redirect the current page during the upgrade operation. If necessary, you can create a new tab to log in to the web version of the system, but also do not operate the already open serial port.

Close the serial port¶
After making sure that the upgrade of the sub-device is complete and there are no other operations, select the Close the serial port command to close the serial port.
Look up
Please remember to execute the command to close the serial port at the end, otherwise it will affect the normal business operation.

Ended: extensions
common problems ↵
1.Unable to access the Logger¶
Problem description¶
If the browser enters the gateway ip address, the pbox-logger web page cannot be opened。

Check and solve¶
1)Whether the gateway is powered on?¶
Please switch on the power supply of the gateway and check whether the PWR light is steady on, or the RUN light is blinking。
2)The network cable is correctly connected¶
Please check whether the computer network card configuration has a Red Cross, you can also right-click the network card, first disable, and then enable target network card;

Check whether the two small indicators at the gateway network port are steady yellow and blinking green。

3)Whether they are on the same network?¶
Make sure the computer and the gateway are on the same network, connected to the same router or switch, or directly connected to the gateway and the computer through a network cable,
And the computer's network card is configured with the same network segment as the gateway (different network segments can also be searched, the same network segment is configured to facilitate troubleshooting) IP address, usually the default IP address of the gateway is 192.168.11.177,
If the configuration is correct, you can run the ping command to ping 192.168.11.177 from the PC。
tip
If the gateway has multiple nics, start with NET1(or eth0), 192.168.11.177, 192.168.12.177, 192.168.13.177......
If it is an x86 rack-mounted management machine (for example, 6220A), then starting from NET1(or eth0), 192.168.0.177, 192.168.1.177, 192.168.2.177...

4)Use reserved IP¶
For all gateways, each NIC reserves an IP address by default. The reserved IP address for NIC 1 is 19.6.0.177/24, the reserved IP address for NIC 2 is 19.6.1.177/24, and so on;
If the computer is connected to the NET1 network port of the gateway, set the IP address of the computer to 19.6.0.178/24(or another IP address in the same network segment), then log in to the cmd terminal ping19.6.0.177, ping the CLI successfully, and then access the computer through your browser https://19.6.0.177/。

Ended: common problems
Version release ↵
Updated logs¶
V2.0.09¶
-
Release date
Gateway software has been released in 2024-02-26 new version, version number V2.0.09。
-
New changes
1、Added support for querying gateway firmware upgrade records;
2、Added support for serial debugging and command line debugging;
3、Added support for AC-PLC whitelist;
4、Added support for querying and delivering gateway authorization;
5、Added functions such as counting successful login failures and reminding users of long-term password change;
6、Encrypt the firmware upgrade package to prevent it from being tampered with;
-
Bug fix
1、Fixed the error of loading the negative attribute of the tag;
2、Fixed excel parsing, data misalignment;
3、The inverter summary data cannot be obtained from the home page;
-
Other instructions
1、This release is a test release. All functions not listed in the document have not been implemented。
V2.0.07¶
-
Release date
Gateway software has been released in 2024-01-15 new version, version number V2.0.07。
-
New changes
1、Create a collection and forward project using a template;
2、Support IP configuration;
3、Support site data statistics;
4、Support firmware upgrade。
-
Bug fix
1、None。
-
Known problem
1、In the acquisition channel, the data calculation of virtual devices may be inaccurate;
-
其它说明
1、This release is a test release. Functions not listed in the document but available on the interface have not been implemented are subject to the official release version。
Upgrade Guide¶
Please refer to Firmware upgrade.
Ended: Version release
Export PDF ↵
Export PDF¶
illustrate¶
-
To export the contents of a single-page document, please operate on a single page;
-
To export the contents of all documents, click here to access full webpage. Note that the webpage is very large. Please wait patiently for the loading to complete. It is recommended to access it through a computer under a wired network environment;
Google Chrome, Microsoft Edge¶
- Right-click the browser page->Print->Save as PDF to save locally.
Firefox Firefox browser¶
- Menu in the upper right corner, Print->Save as PDF, save locally.


Ended: Export PDF
About the documentation ↵
pbox-logger help documentation¶
This manual mainly introduces the software usage, configuration process and other methods of pbox-logger.
-
For first time use, please start from Start using=>Software introduction;
-
If you have questions about the configuration process of some collection and forwarding drivers, please check the driver help.
Optional collection protocols include modbus-rtu collection,
Optional forwarding protocols include modbus-tcp forwarding, 104 slave forwarding;
-
To learn about version changes, please check Updated Logs.
About¶
Authors¶
@xusl、@zhangh、@qiujj。
Thank you very much for your contributions to this documentation.
Build¶
This documentation built with MkDocs.
License¶
Copyright © 2023-2024, HANGZHOU LINKQI TECHNOLOGY CO ., LTD. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.