JOYZL SCADA

在 Linux 中安装

安装示例基于 Debian 12 x64位操作系统。

1.安装前的准备

扫码端(JOYZL SCADA Scanner) 需要桌面图形环境。 如果是新装操作系统，在软件选择界面 勾选 Debian desktop environment 或 Xfce desktop environment ； 如果已有操作系统，且未安装图形界面组件， 可通过以下命令安装。

# 执行更新
sudo apt update
# 安装图形界面
sudo apt install task-xfce-desktop
# 重启系统
sudo reboot

确保当前登录用户未来将用于管理维护并具有 root 权限，否则请切换当前登录用户。 然后下载 扫码端(JOYZL SCADA Scanner) 程序包，到当前登录用户目录并将其解压。 也可以通过其它工具上传或复制程序包到操作系统中，再执行解压。

# 下载
wget https://www.joyzl.com/download/joyzl-scada-scanner_linux-x86_64_9.1.0.tar.gz
# 解压
tar -xzf joyzl-scada-scanner_linux-x86_64_9.1.0.tar.gz

2.执行安装

切换当前目录到解压后的程序文件目录中，然后执行安装脚本。 安装完成将自动创建桌面入口，名为 JOYZL SCADA Scanner。

# 切换目录
cd joyzl-scada-scanner
# 安装
sudo ./install.sh

安装后文件位于以下目录中：

• 主程序 /opt/joyzl/scada-scanner
• 数据文件 /var/lib/joyzl/scada-scanner

在 Windows 中安装

安装示例基于 Windows 10 专业版 x64位操作系统。

1.安装前的准备

下载 扫码端(JOYZL SCADA Scanner) 程序包到操作系统中。 也可通过其它工具上传或复制到操作系统中。 然后将程序包解压到任意位置。

2.执行安装

将解压后的整个程序文件夹移动到您期望的目录位置， 确保整个路径中没有特殊字符和双字节字符（例如汉字）。 扫码端(JOYZL SCADA Scanner) 可以免安装方式直接运行， 双击程序目录中的 scanner.exe 文件启动程序 产生的数据均位于程序所在目录中。

配置单应用模式(Kiosk)

Debian 12 x64

下载 kiosk.sh 并执行，可自动将安装的 扫码端(JOYZL SCADA Scanner) 配置为单应用模式。 执行之前请先安装扫码端(JOYZL SCADA Scanner)程序； 此命令脚本将卸载当前使用的图形界面组件和所有桌面程序， 而后安装 LightDM 作为图形基础， 禁用屏幕保护和系统休眠，自动隐藏鼠标指针； 配置完成之后须重启操作系统。

注意： 执行 kiosk.sh 命令脚本配置单应用模式具有风险， 配置之前请备份重要数据和文件， 如果您对此没有把握，请向专业人士寻求帮助。

#下载脚本
wget https://www.joyzl.com/download/kiosk.sh
# 设置可执行权限
sudo chmod +x kiosk.sh
# 执行自动配置
sudo ./kiosk.sh
# 重启系统
sudo reboot

重启完成之后系统将自动进入 扫码端(JOYZL SCADA Scanner) 程序全屏界面。 您可能需要检查当前的分辨率是否合适，必要时手动设置为最佳分辨率。 可通过快捷键 Ctrl+Alt+F3切换为命令行模式， Ctrl+Alt+F7切换为图形模式。 验证就绪之后，可以移除连接的键盘和鼠标，在单应用模式下 扫码端(JOYZL SCADA Scanner) 无须键盘和鼠标仅需要扫码器即可完成所有工作。

Windows 10 x64

配置主要涉及两个步骤： 1.创建并指定一个本地标准用户（不能是管理员组）； 2.配置启动模式。 在开始配置之前请关闭屏幕保护程序，禁用或移除输入法， 在控制面板的 电源选项中设置 计算机睡眠 和 关闭显示器 为 从不。

1.创建本地账户

按此操作顺序： 开始 设置 > 账户 > 家庭和其他用户 > 将其他人添加到这台电脑 进入账户创建界面； 在界面中填写用户名和密码即可（可留空）。 账户创建后更改 扫码端(JOYZL SCADA Scanner) 程序所在目录，使其新账户具有完全控制权限。

2.配置启动模式

注意： 配置启动模式需要更改注册表，这是具有风险的操作， 配置之前请备份重要数据和文件， 如果您对此没有把握，请向专业人士寻求帮助。

通过更改注册表方式设置自动登录和启动程序， 按Win+R， 输入 regedit， 在 注册表编辑器 窗口中展开并定位到以下节点： HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ Windows NT \ CurrentVersion \ Winlogon； 编辑其中注册表项 AutoAdminLogon 值为 1， DefaultUserName 为新创建的用户名 DefaultPassword 为用户密码，无密码可留空； Shell 为 JOYZL SCADA Scanner 程序可执行文件完整路径 (例如：C:\joyzl\scada-scanner\scanner.exe)， 如果这些键值项不存在可新建。 配置完成之后须重启操作系统。

重启完成之后系统将自动进入 扫码端(JOYZL SCADA Scanner) 程序全屏界面。 验证就绪之后，可以移除连接的键盘和鼠标， 在单应用模式下 扫码端(JOYZL SCADA Scanner) 无须键盘和鼠标仅需要扫码器即可完成所有工作。

开始使用

扫码端(JOYZL SCADA Scanner) 程序启动后， 须通过界面右下角的 设置 打开设置窗口，执行必要的参数配置。

服务端(JOYZL SCADA Server)相关设置

• 服务端： 设置需要连接 服务端 的地址和端口；
• 机台编号： 设置通过 服务端 验证的装备编号；
• 登录账号： 设置自动登录 服务端 的用户名；
• 登录密码： 设置自动登录 服务端 的密码；
• 确认密码： 再次确认输入的登录密码；
• 自动刷新： 设置自动刷新排队列表的空闲时间（秒）。

如果配置服务端(JOYZL SCADA Server)相关参数， 则必须指定自动登录账户密码和有效机台号， 连接成功之后将首先执行登录然后校验机台号。 如果未配置服务端参数，将不会连接服务端也不会校验机台号。

管理系统相关设置

• 员工校验： 设置通过 HTTP 接口校验员工工号有效性；
• 工号长度： 设置员工工号长度，用以判定是扫描编号否为工号；
• 编号检查： 设置通过 HTTP 接口校验产品代码有效性；
• 编号提交： 设置通过 HTTP 接口批量提交产品代码；
• 编号保存： 设置本地保存编号的目录位置。

如果配置管理系统相关参数， 则可支持以通过扫码器（扫码枪）读取印制的员工工号校验当前操作人员， 以及对每次扫描的产品编码执行有效性校验。 员工校验和产品代码的检查及提交接口，应由其它应用程序对接，通常是 MES 或 ERP； 如果未配置将不执行扫码校验和提交动作。

配置项

扫码端(JOYZL SCADA Scanner) 配置文件名为 setting， 在Windows系统中配置文件位于程序目录中； 在Linux系统中配置文件位于 /var/lib/joyzl/scada-server/ 中。 程序启动后可通过设置界面调整配置参数并自动保存。

# 启动时是否全屏
FULL_SCREEN=TRUE

# 服务端(JOYZL SCADA Server)地址
HOST=192.168.2.24
# 服务端(JOYZL SCADA Server)端口
PORT=1230

# 机台编号
EQUIPMENT=E0001
# 自动登录用户
USER=ED000000
# 自动登录密码
PASSWORD=XXXXXX
# 自动刷新空闲（秒）
REFRESH_DELAY=3

# 本地保存路径
SAVE_PATH=
# 通过HTTP接口校验员工工号
EMPLOYEE_URL=http\://192.168.2.24/employee
# 通过HTTP接口提交产品代码
POST_URL=http\://192.168.2.24/codepost
# 通过HTTP接口校验产品代码
CHECK_URL=http\://192.168.2.24/codecheck
# 指定员工工号长度
EMPLOYEE_LENGTH=4

# 全局键入启用
KBH=TRUE
# 网络接收端口
UDP=1106
# 串口扫码器
COM=COM3:9800.8.1.0

注意： 配置文件支持明文设置用户名和密码，但这存在着泄漏账户登录信息的风险； 推荐通过扫码端(JOYZL SCADA Scanner)设置界面，指定自动登录的用户名和密码， 这有助于保护账户敏感信息。

卸载程序

删除程序文件所在的目录即可，没有额外的注册表项和关联文件。