# EqpOEE_doc

**Repository Path**: harrychinese/eqpoee_doc

## Basic Information

- **Project Name**: EqpOEE_doc
- **Description**: No description available
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2022-01-18
- **Last Updated**: 2024-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OEE 系统安装说明

## 1. 服务端安装
### 1.1 SQL Server 数据库安装
#### 下载 
可从微软官方网站下载免费的 SQL Server 2019 Developer 版. 
[微软官方下载地址](https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads)
![下载截图](README_files/1.jpg)

#### 安装的主要步骤:
选择独立安装, 这有选这个才会真正安装服务器   
![选择独立安装](README_files/5.jpg)

设定数据库实例, 选择默认实例, 这样后面的数据库连接会简单些.   
![设定数据库实例](README_files/6.jpg)

设定服务启动类型, 设定为自动启动   
![服务启动类型](README_files/7.jpg)

设定身份验证方式, 选择混合模式.  
并为数据库账号`sa`, 设定密码为`root`, 也可设定为其他密码, 后续要用.  
![设定身份验证方式](README_files/8.jpg)


#### SQL Server 数据库配置 
完成数据库的安装, 需使用SQL server configuration manager 进行服务配置.  
该工具可以通过开始菜单找到. 
![SQL server configuration manager 程序](README_files/2.jpg)

确保自动启动SQL Server, 并开启 SQL Server Browser 服务.  
![](README_files/4.jpg)

启用TCP/IP 网络, 并重启数据库服务.  
![启用TCP/IP 网络](README_files/3.jpg)
![](README_files/9.jpg)

### 1.2 新建 OEE 数据库
####  安装 SQL Server Management Studio 数据库管理工具
可从微软官方网站下载免费的 SQL Server Management Studio 数据库管理工具, 
[微软官方下载地址](https://docs.microsoft.com/zh-cn/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver15)   
安装步骤略. 

#### 使用SQL Server Management Studio工具登录数据库
![登录数据库](README_files/11.jpg)

#### 建立 OEE 数据库
SQL Server Management Studio 数据库管理工具左边树的数据库节点上, 选择`新建数据库`菜单, 新增 `OEE` 数据库.  
![新建Oee数据库](README_files/12.jpg)   
选择合适的数据库文件存放路径.  
![Oee数据库设置](README_files/10.jpg)
#### 建立OEE系统所需的各个数据表
记事本程序打开 `oee.sql` 文件, 复制到 SQL Server Management Studio 中, 执行一下.  
![](README_files/13.jpg)



## 2. Oee.Main 程序配置
Oee.Main 程序提供系统管理和看板功能.  
### 2.1 下载并安装 .Net Framework 4.8 
[微软官方下载地址](https://support.microsoft.com/zh-cn/topic/%E9%80%82%E7%94%A8%E4%BA%8E-windows-%E7%9A%84-microsoft-net-framework-4-8-%E8%84%B1%E6%9C%BA%E5%AE%89%E8%A3%85%E7%A8%8B%E5%BA%8F-9d23f658-3b97-68ab-d013-aa3c3e7495e0)
![下载脱机安装包](README_files/14.jpg)   
安装过程略  

### 2.2 配置 Oee.Main 程序的数据连接信息
浏览 Oee.Main 程序的主目录, 记事本打开 `Oee.Main.exe.config` 文件, 按照数据服务器的具体情况, 修改 `connectionString ` , 下面是一个示例,
```
    <connectionStrings>
        <add name="Oee.Main.Properties.Settings.oeeDb" connectionString="Data Source=localhost;Initial Catalog=Oee;User Id=sa;Password=root"
            providerName="System.Data.SqlClient" />
    </connectionStrings>
```
### 2.3 Oee 账号密码管理
Oee 系统内置 `SuperAdmin` 一个系统最高权限账号, 初始密码都为空, 打开 Oee.Main 程序可以修改密码. 也可以增加其他账号. 


### 2.4 配置车间和机台
打开 Oee.Main 程序, 完成车间和机台的配置工作.  


## 3. Oee.Collector 程序配置
Oee.Collector 程序负责从PLC中收集机台状态, 并完成状态的预处理工作, 将结果写入到 Oee 数据库中.   
一个工厂可以启动多个 Oee.Collector 程序, 但应确保对于特定一个机台, 只能有一个 Oee.Collector 程序完成信号采集, 要防止多个程序重复收值.   
### 3.1 下载并安装 .Net 6
[微软官方下载地址](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
![.Net 6 下载](README_files/15.jpg)
注意需按照Windows版本来决定下载 x64 或 x86 版本, 因为目前 Windows 一般为 x64 版, 所以通常我们要下载 x64 版.   
安装过程略.    

### 3.2 配置 Oee.Collector 程序的数据连接信息
浏览 Oee.Collector 程序的主目录, 记事本打开 `appsettings.json` 文件, 按照数据服务器的具体情况, 修改 `connectionStrings ` , 下面是一个示例,
```
  "ConnectionStrings": {
    "oeeDb": "Server=localhost;Database=Oee;User Id=sa;Password=root;"
  }
```

### 3.3 配置读数和状态映射
PLC 读数为数值, 我们需要将这些数值标识为机台状态,  目前支持的合法状态有 Idle、Run、Alarm 三种。 
```
"plcValueMappings": [
    {
      "Value": 1,
      "State": "Alarm"
    },
    {
      "Value": 2,
      "State": "Run"
    },
    {
      "Value": 3,
      "State": "Idle"
    }
  ]
```

- 红灯，设备故障, 读数为1
- 绿灯，设备生产运行中, 读数为2
- 黄灯，设备待料待机, 读数为3


### 3.4  配置modbus连接信息
#### 理解modbus 
Oee.Collector 程序使用modbus协议连接PLC设备, 具体是读写4区 Holding Register(4x) 寄存器,
因不同的PLC设备的 modbus 地址映射各异, 下面网页提供了20种常用PLC的地址映射表, 仅供参考.    
[20种PLC元件编号和Modbus编号地址对应表](https://blog.csdn.net/weixin_39743511/article/details/111708297)   
其中, 台达DVP-12SA2 截图如下:   
![台达](README_files/16.jpg)


#### 各类地址含义:  

- 寄存器(或线圈)PLC 地址, 是指寄存器在PLC控制器中的地址, 为5位数地址, 比如 40001 或 30002 等.
- modbus 协议地址, 通常是一个很小的地址码, 用于modbus 协议通讯寻址, modbus 通讯协议通过slave Id 和 modbus 功能码和协议通讯地址共同确定一个唯一的寄存器地址.
- modbus 长地址,  为六位数地址, 第一码表示的是modbus功能码, 代码中一般不用这个地址, 在PLC产品说明书中有时使用这个地址.  

各类地址转换公式为:  
- 4区 modbus 协议地址= 寄存器PLC 地址 - 40001
- 4区 modbus 长地址= modbus 协议地址 + 400000

项目中使用台达PLC, 对应的modbus地址为: 
- PLC地址: 机台状态寄存器地址dm100, 对应modbus 协议地址为 4096
- PLC地址: 蜂鸣器报警寄存器写入地址dm110, 对应modbus 协议地址为 4097
 

#### 配置 modbus 信息
Oee.Collector 程序使用的 modbus 协议地址, 访问读写4区 Holding Register(4x) 寄存器.   
浏览 Oee.Collector 程序的主目录, 记事本打开 `appsettings.json` 文件,  其中的 `PlcDevices` 配置项, 即为 modbus 配置,  需要配置 PLC 设备的 modbus IP和端口信息. 

![modbus 配置](README_files/18.jpg)

### 3.5  Oee.Collector 程序使用说明
![](README_files/19.jpg)

### 3.6  Oee.Main 程序使用说明
主界面:   
![](README_files/17.jpg)

管理菜单:  
在使用之前, 需要完成系统基础数据维护工作. 
![](README_files/20.jpg)