更新文档说明
This commit is contained in:
dathlin
269
README.md
269
README.md
@@ -3,8 +3,21 @@
|
||||
#### 关于HslCommunication.dll
|
||||
<p>该组件功能提供了一些基础类和整个C-S项目的核心网络的支持，除此之外，该组件提供了访问三菱PLC和西门子PLC的数据功能。</p>
|
||||
|
||||
<br />
|
||||
<br />
|
||||
<p>本组件支持常规的整数的数据读写，也支持字符串数据读写，包括中文，以下只是简单的举例，目前已经完成了一个三菱PLC高并发访问的类，具体交流可以通过以下方式联系我</p>
|
||||
<ul>
|
||||
<li>技术支持QQ群：<strong>592132877</strong></li>
|
||||
<li>邮箱：<strong>hsl200909@163.com</strong></li>
|
||||
</ul>
|
||||
<p>如果要使用本组件访问PLC，需要引用命名空间，如下</p>
|
||||
<pre>
|
||||
<code>
|
||||
using HslCommunication.Profinet;
|
||||
</code>
|
||||
</pre>
|
||||
|
||||
三菱详细手册：<a href="https://github.com/dathlin/C-S-/blob/master/MelsecReadMe.md">三菱PLC数据读写手册</a>
|
||||
|
||||
西门子详细手册：<a href="https://github.com/dathlin/C-S-/blob/master/SiemensReadMe.md">西门子PLC数据读写手册</a>
|
||||
|
||||
#### 关于本项目模版
|
||||
<p style="text-indent:2em">本模版基于.Net Framework3.5+C#7.0开发完成，所以必须使用Visual studio 2017进行开发，低版本的IDE打开项目将出现语法识别错误。有必要说明下为什么使用.Net Framework3.5，这个版本是xp系统比较方便安装的，在企业部署中会相对容易很多，所以如果你的系统也是应用于企业的，那么强烈建议使用3.5版本，该模版由三部分的程序组成：</p>
|
||||
@@ -22,206 +35,76 @@
|
||||
|
||||
<br />
|
||||
|
||||
#### 服务器端程序界面如下：
|
||||
|
||||
功能菜单都在设置中，可以尝试其他操作。
|
||||
<br />
|
||||
#### 客户端后台登录流程
|
||||
<ol>
|
||||
<li>状态检查，检测服务器的维护状态设置，如果处于维护中，则显示不能登录系统原因。</li>
|
||||
<li>账户检查，服务器对登录账户全面检查，用户名是否存在，密码是否正确，是否允许登录，并对登录ip，时间，频次进行记录。</li>
|
||||
<li>版本检查，服务器返回最新的版本号，客户端检测后根据自己的需求选择是否启动更新程序。</li>
|
||||
<li>参数下载，上述所有检查通过以后，进行运行数据的初始化，比如将公告数据传送到客户端，您也可以添加自己的数据。采用json数据进行封装，客户端解析的时候请参照示例。</li>
|
||||
<li>上述所有检测通过之后，启动客户端的主界面程序。但凡有一项检测失败，或者参数下载失败，均不允许登录，并且提示相关错误。</li>
|
||||
</ol>
|
||||
|
||||
#### 客户端的程序界面
|
||||
##### 登录窗口
|
||||
# 服务器端程序界面如下：
|
||||
|
||||
<br />
|
||||
######下述服务器端的功能说明均来自服务器的菜单点击
|
||||
|
||||
1. 服务器端的版本控制，更新新的版本号，按照实际需求来更新您的版本号，门牌为【设置】-【版本控制】
|
||||
<br />
|
||||
|
||||
2. 服务器端的维护状态控制，比如系统维护阶段，不允许所有客户端登录，门牌为【设置】-【维护切换】
|
||||
|
||||
3. 消息群发，您也可以在代码中自动触发群发，代码参考此处的手动群发，门牌为【设置】-【消息发送】
|
||||
|
||||
4. 账户管理，客户端的界面和这个一致，该管理属于底层的json数据管理，任意更改数据，门牌为【设置】-【账户管理】
|
||||
|
||||
5. 关于本系统，框架版本号以本github发布的版本号为准，门牌为【关于】-【关于软件】
|
||||
|
||||
6. 一键断开，如遇到紧急情况，或是切换维护之前，可以选择强制关闭所有的客户端。门牌为【设置】-【一键断开】
|
||||
|
||||
<br />
|
||||
<br />
|
||||
<br />
|
||||
# 客户端的程序界面
|
||||
###### 登录窗口
|
||||
|
||||
<br />
|
||||
|
||||
##### 主界面
|
||||
###### 登录主界面（此处点击了关于菜单）
|
||||
|
||||
|
||||
<br />
|
||||
<br />
|
||||
###### 更改公告，此处没有设置权限过滤，门牌为【管理员】-【更改公告】
|
||||
|
||||
|
||||
###### 日志查看，本系统集成了非常实用的日志功能，所有的网络组件均支持日志的记录，方便调试。门牌为【管理员】-【日志查看】
|
||||
|
||||
|
||||
###### 远程更新，成功部署本系统后，支持远程客户端的版本更新，此功能应开发人员拥有。门牌为【管理员】-【远程更新】
|
||||
|
||||
|
||||
###### 密码更改，当账户需要更改密码时，需要对密码进行验证。门牌为【设置】-【修改密码】
|
||||
|
||||
|
||||
###### 更新日志，当客户端更新了新的版本后，初次运行程序时就会自动弹出如下窗口，具体的更新内容应该写入到文件中。手动门牌为【关于】-【更新日志】
|
||||
|
||||
|
||||
###### 反馈意见，人性化的软件允许用户支持提交修改建议，功能使用反馈等。门牌为【关于】-【意见反馈】
|
||||
|
||||
|
||||
###### 快速注册账号，支持管理员快速注册账号，该界面允许更改。门牌为【管理员】-【注册账号】
|
||||
|
||||
|
||||
###### 共享文件，本系统支持一个小型的文件共享，包含了上传下载删除过滤。门牌为主界面的【文件数量】
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<br />
|
||||
<br />
|
||||
|
||||
# 本网络组件支持使用工业以太网技术访问PLC
|
||||
<p>本组件支持常规的整数的数据读写，也支持字符串数据读写，包括中文，以下只是简单的举例，目前已经完成了一个三菱PLC高并发访问的类，具体交流可以通过以下方式联系我</p>
|
||||
<ul>
|
||||
<li>技术支持QQ群：<strong>592132877</strong></li>
|
||||
<li>邮箱：<strong>hsl200909@163.com</strong></li>
|
||||
</ul>
|
||||
<p>如果要使用本组件访问PLC，需要引用命名空间，如下</p>
|
||||
<pre>
|
||||
<code>
|
||||
using HslCommunication.Profinet;
|
||||
</code>
|
||||
</pre>
|
||||
|
||||
#### 三菱PLC访问数据读写
|
||||
|
||||
详细手册：<a href="https://github.com/dathlin/C-S-/blob/master/MelsecReadMe.md">三菱PLC数据读写手册</a>
|
||||
|
||||
##### 初始化对象
|
||||
<pre>
|
||||
<code>
|
||||
private MelsecNet melsec_net = new MelsecNet();
|
||||
private void Form1_Load(object sender, EventArgs e)
|
||||
{
|
||||
//初始化
|
||||
melsec_net.PLCIpAddress = System.Net.IPAddress.Parse("192.168.0.7");//IP
|
||||
melsec_net.PortRead = 6000;//端口
|
||||
melsec_net.PortReadBackup = 6001;//备用读端口，也可以不指定，默认负数，不会切换负数端口
|
||||
melsec_net.PortWrite = 6000;//写入端口，也可以和读取一样
|
||||
melsec_net.NetworkNumber = 0;//网络号
|
||||
melsec_net.NetworkStationNumber = 0;//网络站号
|
||||
melsec_net.ConnectTimeout = 500;//连接超时时间
|
||||
}
|
||||
</code>
|
||||
</pre>
|
||||
##### 读写D寄存器数据
|
||||
<pre>
|
||||
<code>
|
||||
private void button1_Click(object sender, EventArgs e)
|
||||
{
|
||||
//读取PLC数据 D6000开始21个字 也即是D6000-D6020 最大长度980
|
||||
OperateResultBytes read = melsec_net.ReadFromPLC(MelsecDataType.D, 6000, 21);
|
||||
if(read.IsSuccess)
|
||||
{
|
||||
//成功读取
|
||||
textBox2.Text = "D6000:" + melsec_net.GetShortFromBytes(read.Content, 0);
|
||||
//textBox2.Text = "D6001:" + melsec_net.GetShortFromBytes(read.Content, 1);
|
||||
//textBox2.Text = "D6002:" + melsec_net.GetShortFromBytes(read.Content, 2);
|
||||
//textBox2.Text = "D6003:" + melsec_net.GetShortFromBytes(read.Content, 3);
|
||||
//textBox2.Text = "D6004:" + melsec_net.GetShortFromBytes(read.Content, 4);
|
||||
//================================================================================
|
||||
//这两种方式一样的，
|
||||
//textBox2.Text = "D6000:" + BitConverter.ToInt16(read.Content, 0);
|
||||
//textBox2.Text = "D6001:" + BitConverter.ToInt16(read.Content, 2);
|
||||
//textBox2.Text = "D6002:" + BitConverter.ToInt16(read.Content, 4);
|
||||
//textBox2.Text = "D6003:" + BitConverter.ToInt16(read.Content, 6);
|
||||
//textBox2.Text = "D6004:" + BitConverter.ToInt16(read.Content, 8);
|
||||
}
|
||||
else
|
||||
{
|
||||
//失败读取
|
||||
MessageBox.Show(read.ToMessageShowString());
|
||||
}
|
||||
}
|
||||
private void button2_Click(object sender, EventArgs e)
|
||||
{
|
||||
short[] values = new short[4] { 1335, 8765, 1234, 4567 };//决定了写多少长度的D
|
||||
//写入PLC数据 D6000为1234,D6001为8765,D6002为1234,D6003为4567
|
||||
OperateResultBytes write = melsec_net.WriteIntoPLC(MelsecDataType.D, 6000, values);
|
||||
if(write.IsSuccess)
|
||||
{
|
||||
textBox2.Text = "写入成功";
|
||||
}
|
||||
else
|
||||
{
|
||||
MessageBox.Show(write.ToMessageShowString());//显示失败原因
|
||||
}
|
||||
}
|
||||
</code>
|
||||
</pre>
|
||||
##### 读写M寄存器数据
|
||||
<pre>
|
||||
<code>
|
||||
private void button100_Click(object sender, EventArgs e)
|
||||
{
|
||||
//后台循环读取PLC数据 M200开始10个字 也即是M200-M209
|
||||
OperateResultBytes read = melsec_net.ReadFromPLC(MelsecDataType.M, 200, 10);
|
||||
if (read.IsSuccess)
|
||||
{
|
||||
textBox2.Text = "M200:" + (read.Content[0] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M201:" + (read.Content[1] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M202:" + (read.Content[2] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M203:" + (read.Content[3] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M204:" + (read.Content[4] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M205:" + (read.Content[5] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M206:" + (read.Content[6] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M207:" + (read.Content[7] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M208:" + (read.Content[8] == 1 ? "通" : "断");
|
||||
//textBox2.Text = "M209:" + (read.Content[9] == 1 ? "通" : "断");
|
||||
}
|
||||
else
|
||||
{
|
||||
//失败读取，显示失败信息
|
||||
MessageBox.Show(read.ToMessageShowString());
|
||||
}
|
||||
}
|
||||
private void button5_Click(object sender, EventArgs e)
|
||||
{
|
||||
//此处写入后M200:通 M201:断 M202:断 M203:通
|
||||
bool[] values = new bool[] { true, false, false, true };
|
||||
OperateResultBytes write = melsec_net.WriteIntoPLC(MelsecDataType.M, 200, values);
|
||||
if(write.IsSuccess)
|
||||
{
|
||||
textBox2.Text = "写入成功";
|
||||
}
|
||||
else
|
||||
{
|
||||
MessageBox.Show(write.ToMessageShowString());
|
||||
}
|
||||
}
|
||||
</code>
|
||||
</pre>
|
||||
|
||||
#### 西门子PLC访问数据读写
|
||||
|
||||
详细手册：<a href="https://github.com/dathlin/C-S-/blob/master/SiemensReadMe.md">西门子PLC数据读写手册</a>
|
||||
|
||||
##### 初始化对象
|
||||
<pre>
|
||||
<code>
|
||||
//西门子PLC读取块
|
||||
private SiemensNet siemens_net = new SiemensNet();
|
||||
private void Form1_Load(object sender, EventArgs e)
|
||||
{
|
||||
siemens_net.ConnectTimeout = 500;//超时时间
|
||||
siemens_net.PortRead = 2000;//读端口
|
||||
siemens_net.PortReadBackup = 2002;//备用读端口，也可以不指定，默认负数，不会切换负数端口
|
||||
siemens_net.PortWrite = 2001;//写端口
|
||||
siemens_net.PLCIpAddress = System.Net.IPAddress.Parse("192.168.0.6");//ip地址
|
||||
}
|
||||
</code>
|
||||
</pre>
|
||||
|
||||
##### 读写M寄存器数据
|
||||
<pre>
|
||||
<code>
|
||||
private void button3_Click(object sender, EventArgs e)
|
||||
{
|
||||
OperateResultBytes read = siemens_net.ReadFromPLC(SiemensDataType.M, 100, 2);
|
||||
if(read.IsSuccess)
|
||||
{
|
||||
textBox4.Text = "M100:" + read.Content[0] + " M101:" + read.Content[1];
|
||||
bool M100_0 = (read.Content[0] & 0x01) == 0x01;//M100.0的通断
|
||||
bool M100_1 = (read.Content[0] & 0x02) == 0x02;//M100.1的通断
|
||||
bool M100_2 = (read.Content[0] & 0x04) == 0x04;//M100.2的通断
|
||||
bool M100_3 = (read.Content[0] & 0x08) == 0x08;//M100.3的通断
|
||||
bool M100_4 = (read.Content[0] & 0x10) == 0x10;//M100.4的通断
|
||||
bool M100_5 = (read.Content[0] & 0x20) == 0x20;//M100.5的通断
|
||||
bool M100_6 = (read.Content[0] & 0x40) == 0x40;//M100.6的通断
|
||||
bool M100_7 = (read.Content[0] & 0x80) == 0x80;//M100.7的通断
|
||||
}
|
||||
else
|
||||
{
|
||||
MessageBox.Show(read.ToMessageShowString());
|
||||
}
|
||||
}
|
||||
private void button4_Click(object sender, EventArgs e)
|
||||
{
|
||||
//写入结果是M100:81 M101:22 M102:124
|
||||
OperateResultBytes write = siemens_net.WriteIntoPLC(SiemensDataType.M, 100, new byte[] { 81, 22, 124 });
|
||||
if (write.IsSuccess)
|
||||
{
|
||||
textBox4.Text = "写入成功";
|
||||
}
|
||||
else
|
||||
{
|
||||
MessageBox.Show(write.ToMessageShowString());
|
||||
}
|
||||
}
|
||||
</code>
|
||||
</pre>
|
||||
|
||||
|
||||
# License:
|
||||
Copyright (c) Richard.Hu. All rights reserved.
|
||||
Licensed under the MIT License.
|
||||
###### Copyright (c) Richard.Hu. All rights reserved.
|
||||
###### Licensed under the MIT License.
|
||||
|
||||
Reference in New Issue
Block a user