# openuc

**Repository Path**: didiopensource/openuc

## Basic Information

- **Project Name**: openuc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-27
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenUC(开放充电通用协议,Open UniCharge)

> Open protocol and SDK framework for communication between EV charging piles and cloud platforms | 电动汽车充电桩与云端运营平台的开放通信协议及SDK框架

## 项目说明

本项目提供开放充电通用协议定义文档、提供桩侧的SDK包以及提供云平台协议解析SDK文档。

### 开放充电通用协议

开放充电通用协议（Open UniCharge，简称OpenUC）是一个规定了充电桩与充电运营平台之间数据交互的流程、格式和内容。

协议整体依据国网104充电桩规约，新增数据部分协议参照 GBT-27930 对充电桩充电过程中与充电运营平台的交互数据进行了补充，本协议适用于交、直流，交流在本协议中部分数据无需上送数据项在下面协议部分均有标注。

## 目录结构

### cloud

此目录下为云端处理SDK，具体目录结构如下：

```
openuc-java-cloud-sdk/
├── pom.xml                           # Maven项目配置文件
└── src/                              # 源代码目录
    ├── main/                         # 主源代码
    │   └── java/                     # Java源代码
    │       └── com/openuc/cloud/sdk/ # SDK根包
    │           ├── common/           # 公共常量定义
    │           ├── decoder/          # 协议解码器
    │           ├── encoder/          # 协议编码器
    │           ├── message/          # 消息实体类
    │           ├── pojo/             # 数据传输对象
    │           ├── request/          # 请求对象
    │           ├── sender/           # 命令发送器
    │           └── util/             # 工具类
    └── test/                         # 测试代码
        └── java/                     # Java测试代码
```

#### 各模块详细说明

- **1. common - 公共模块**
  - Constants.java: 项目中使用的公共常量定义
- **2. decoder - 解码模块**
  - 协议解码器核心类和命令解码实现
  - 包含20+个具体命令的解码处理类
- **3. encoder - 编码模块**
  - ProtocolEncoder.java: 协议编码器实现
- **4. message - 消息模块**
  - 各类消息实体类，包括:
    - 充电相关命令消息（开始充电、停止充电等）
    - 设备状态消息（心跳、握手等）
    - 数据查询消息（充电记录、BMS信息等）
    - 控制命令消息（远程重启、OTA升级等）
- **5. pojo - 数据对象模块**
  - ElectricityPeriodTimeDTO.java: 电价时段数据传输对象
  - ElectricityPriceDTO.java: 电价数据传输对象
- **6. request - 请求模块**
  - 各类请求对象，用于向上游系统发送请求
- **7. sender - 发送器模块**
  - 各类命令发送器，用于向设备发送指令
  - 包含充电控制、设备管理、状态查询等命令发送器
- **8. util - 工具模块**
  - 提供各类工具方法:
    - AsciiUtil.java: ASCII编码工具
    - BCD.java & BCDUtil.java: BCD码处理工具
    - CRC16Util.java: CRC16校验工具
    - HexStrUtil.java: 十六进制字符串处理工具
    - 时间、序列号、数值处理等工具类
- **9. test - 测试模块**
  - HexStrUtilTest.java: HexStrUtil工具类的单元测试

### equipment

开放充电通用协议设备侧SDK文档集合，SDK是基于C语言开发的充电桩设备通信代码，主要用于实现充电桩与云平台之间的数据通信，包括协议处理、网络通信、数据编解码等功能。

具体目录结构如下：

```
document/
├── 开放充电通用协议文档-V1.0.pdf     # 协议定义文档
├── 通用协议SDK使用说明.pdf           # SDK使用说明文档
sdk/
├── DataDeal.c                        # 数据处理实现文件
├── DataDeal.h                        # 数据处理头文件
├── Net_Deal.c                        # 网络通信处理实现文件
└── Net_Deal.h                        # 网络通信处理头文件
```

其中sdk目录下各模块详细说明：

#### 1. DataDeal 模块

- **主要功能**
  - 数据编解码处理
  - 各种数据类型读写操作
  - CRC校验算法实现
  - BCD码转换处理
  - 核心功能函数
- **数据读取函数:**
  - ReadReceiveCommandChar8: 读取单字节数据
  - ReadReceiveCommandInt16/Int24/Int32: 读取多字节整型数据(大小端两种格式)
- **数据写入函数:**
  - AddNewCommandByte/Int16/Int24/Int32: 写入各种类型数据(大小端两种格式)
  - AddNewCommandBuf: 写入缓冲区数据
- **校验算法:**
  - Modbus_Crc16: Modbus CRC16校验
  - CRC16_MODBUS_Calc: MODBUS CRC16计算
  - ModbusCRC: 协议使用的CRC校验
  - AppCRC_crccheck32: CRC32校验
- **编码转换:**
  - bcd2todec: BCD转十进制
  - dectobcd: 十进制转BCD
  - BCD_to_DEC: BCD转DEC转换

#### 2. Net_Deal 模块

- **主要功能**
  - 网络通信管理
  - 充电桩与平台通信协议实现
  - 充电流程控制
  - 数据上报与命令处理
- **核心数据结构**
  - ParamSet: 桩体参数设置结构体
  - stNetConFlag: 网络连接相关结构体
  - stRateInfo: 桩计费模型信息
  - stChargeInfo: 充电信息结构体
  - stBatteryPara: 电池信息结构体
  - stPileQRCodeInfo: 二维码信息结构体
- **核心功能函数**
  - 网络通信函数
    - NetSendData: 网络数据发送
    - CreateConnectForGun: 创建网络连接
    - DeleteConnectForGun: 删除网络连接
    - NetDeal_Recv: 网络数据接收处理
    - NetDeal_SendRecv: 网络数据收发处理
  - 数据发送函数
    - PileSendServeiceStart: 充电桩登录平台认证
    - PileSendHeart: 发送心跳包
    - PileSendRealTimeInfo: 发送实时信息
    - PileSendRecordData: 发送订单数据
    - PileSendChargeStep1/2/3Info: 发送充电各阶段信息
  - 数据接收处理函数
    - Rcv_DataAnaly: 平台数据解析处理
    - Receive_RataInfo: 计费模型接收
    - Receive_PileStartChargeInfo: 启动充电命令处理
    - Receive_RemotoStartChargeInfo: 远程启动充电处理
  - 状态管理函数
    - Net_init_send_data: 网络初始化处理
    - Net_StateHardData_Send: 心跳状态发送
    - CheckTimeOut: 超时重发处理
    - NetTimeOutSet/Clear: 超时管理

## 测试工作台

开放充电通用协议对应的官方沙箱测试平台为：http://openuc-saas.yqcd.cc/#/login

此平台用于桩企开发完成桩端侧的程序开发后需要和远端的云平台进行联调，即完成端到云的整个链路的调试工作。