JChargePointProtocol/jcpp-infrastructure-proto/src/main/proto/uplink.proto

/**
 * 开源代码，仅供学习和交流研究使用，商用请联系三丙
 * 微信：mohan_88888
 * 抖音：程序员三丙
 * 付费课程知识星球：https://t.zsxq.com/aKtXo
 */
syntax = "proto3";

package infrastructureProto;

option java_package = "sanbing.jcpp.proto.gen";
option java_outer_classname = "UplinkProto";

// 上行队列消息（从充电桩到服务器）
message UplinkQueueMessage {
  int64 messageIdMSB = 1;
  int64 messageIdLSB = 2;
  int64 sessionIdMSB = 3;
  int64 sessionIdLSB = 4;
  string messageKey = 5;
  string protocolName = 6;
  int64 ts = 7;
  bytes requestData = 10;
  SessionCloseEventProto sessionCloseEventProto = 20;
  LoginRequest loginRequest = 21;
  HeartBeatRequest heartBeatRequest = 22;
  VerifyPricingRequest verifyPricingRequest = 23;
  QueryPricingRequest queryPricingRequest = 24;
  GunRunStatusProto gunRunStatusProto = 25;
  ChargingProgressProto chargingProgressProto = 26;
  SetPricingResponse setPricingResponse = 27;
  RemoteStartChargingResponse remoteStartChargingResponse = 28;
  RemoteStopChargingResponse remoteStopChargingResponse = 29;
  TransactionRecordRequest transactionRecordRequest = 30;
  BmsChargingErrorProto bmsChargingErrorProto = 31;
  BmsParamConfigReportProto bmsParamConfigReportProto = 33;
  BmsChargingInfoProto bmsChargingInfoProto = 34;
  BmsAbortProto bmsAbortProto = 35;
  RestartPileResponse restartPileResponse = 36;
  BmsHandshakeProto bmsHandshakeProto = 37;
  OtaResponse otaResponse = 38;
  GroundLockStatusProto groundLockStatusProto = 39;
  OfflineCardBalanceUpdateResponse offlineCardBalanceUpdateResponse = 40;
  OfflineCardSyncResponse offlineCardSyncResponse = 41;
  TimeSyncResponse timeSyncResponse = 42;
  BmsDemandChargerOutputProto bmsDemandChargerOutputProto = 43;
  StartChargeRequest startChargeRequest = 44;
  SetQrcodeResponse setQrcodeResponse = 45;
  OfflineCardClearResponse offlineCardClearResponse = 46;
  OfflineCardQueryResponse offlineCardQueryResponse = 47;
}

// 会话关闭事件
message SessionCloseEventProto {
  string pileCode = 2;                // 充电桩编码
  SessionCloseReason reason = 3;      // 会话关闭原因
  optional string additionalInfo = 20; // 附加信息
}

// 会话关闭原因枚举
enum SessionCloseReason {
  SESSION_CLOSE_UNKNOWN = 0;          // 未知原因
  SESSION_CLOSE_DESTRUCTION = 1;      // 自然销毁（空闲超时）
  SESSION_CLOSE_ON_CHANNEL_INACTIVE = 2;  // 通道不活跃
  SESSION_CLOSE_MANUALLY = 3;         // 手动关闭
}

// 登录请求
message LoginRequest {
  string pileCode = 2;
  string credential = 3;
  string remoteAddress = 4;
  string nodeId = 10;
  string nodeHostAddress = 11;
  int32 nodeRestPort = 12;
  int32 nodeGrpcPort = 13;
  optional string additionalInfo = 20;
}

// 启动充电请求
message StartChargeRequest {
  int64 ts = 1;
  string pileCode = 2;                  // 桩编号
  string gunNo = 3;                     // 枪编号
  string startType = 4;                 // 启动类型
  string cardNo = 5;                    // 账号或物理卡号
  bool needPassword = 6;                // 是否需要密码
  string password = 7;                  // 密码
  string carVinCode = 8;               // 车辆识别码(VIN)
  optional string additionalInfo = 20;  // 附加信息
}

// 心跳请求
message HeartBeatRequest {
  string pileCode = 3;
  string remoteAddress = 4;
  string nodeId = 10;
  string nodeHostAddress = 11;
  int32 nodeRestPort = 12;
  int32 nodeGrpcPort = 13;
  optional string additionalInfo = 20;
}

// 校验计费请求
message VerifyPricingRequest {
  string pileCode = 4;
  int64 pricingId = 30;
  optional string pricingModel = 31;
  optional string additionalInfo = 20;
}

// 查询计费请求
message QueryPricingRequest {
  string pileCode = 4;
  optional string additionalInfo = 20;
}

// 枪运行状态枚举
enum GunRunStatus {
  IDLE = 0;              // 空闲
  INSERTED = 1;       // 已插枪
  CHARGING = 2;         // 充电中
  CHARGE_COMPLETE = 3;   // 充电完成
  DISCHARGE_READY = 4;   // 放电准备
  DISCHARGING = 5;      // 放电中
  DISCHARGE_COMPLETE = 6; // 放电完成
  RESERVED = 7;         // 预约
  FAULT = 8;            // 故障
  UNKNOWN = 9;           // 未知
}

// 枪运行状态消息
message GunRunStatusProto {
  string pileCode = 4;
  string gunNo = 5;
  GunRunStatus GunRunStatus = 41;
  repeated string faultMessages = 6;
  optional string additionalInfo = 20;
}

// 充电进度消息
message ChargingProgressProto {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  string outputVoltage = 7;
  string outputCurrent = 8;
  int32 soc = 9;
  int32 totalChargingDurationMin = 10;
  string totalChargingEnergyKWh = 11;
  string totalChargingCostYuan = 12;
  optional string additionalInfo = 20;
}

// 设置计费响应
message SetPricingResponse {
  bool success = 1;
  string pileCode = 4;
  int64 pricingId = 30;
}

// 远程启动充电响应
message RemoteStartChargingResponse {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  bool success = 7;
  string failReason = 8;
  optional string additionalInfo = 20;
}

// 重启充电桩响应
message RestartPileResponse {
  string pileCode = 4;
  bool success = 7;
}

// 远程停止充电响应
message RemoteStopChargingResponse {
  string pileCode = 4;
  string gunNo = 5;
  bool success = 7;
  string failReason = 8;
  optional string additionalInfo = 20;
}

// 明细类型枚举
enum DetailType {
  PEAK_VALLEY = 0;  // 峰谷电量明细
  TIME_PERIOD = 1;  // 时段电量明细
}

// 峰谷电量明细
message PeakValleyDetail {
  string topEnergyKWh = 1;      // 尖峰电量
  string topAmountYuan = 2;     // 尖峰电费
  string peakEnergyKWh = 3;     // 峰时电量
  string peakAmountYuan = 4;    // 峰时电费
  string flatEnergyKWh = 5;     // 平时电量
  string flatAmountYuan = 6;    // 平时电费
  string valleyEnergyKWh = 7;   // 谷时电量
  string valleyAmountYuan = 8;  // 谷时电费
  string deepEnergyKWh = 9;     // 深谷电量
  string deepAmountYuan = 10;   // 深谷电费
}

// 时段电量明细
message TimePeriodDetail {
  message PeriodItem {
    int32 periodNo = 1;           // 时段序号，从1开始
    string startTime = 2;         // 开始时间，格式 HH:mm:ss
    string endTime = 3;           // 结束时间，格式 HH:mm:ss
    string energyKWh = 4;         // 该时段电量
    optional string amountYuan = 5; // 该时段电费，可选
  }
  repeated PeriodItem periods = 1; // 时段列表
}

// 交易明细
message TransactionDetail {
  DetailType type = 1;                        // 明细类型
  optional PeakValleyDetail peakValley = 2;   // 峰谷电量明细
  optional TimePeriodDetail timePeriod = 3;   // 时段电量明细
}

// 交易记录请求
message TransactionRecordRequest {
  string pileCode = 4;                    // 充电桩编码
  string gunNo = 5;                     // 枪编号
  string tradeNo = 6;                     // 交易流水号
  int64 startTs = 51;                     // 开始时间戳
  int64 endTs = 52;                       // 结束时间戳
  string totalEnergyKWh = 53;             // 总电量(必填)
  optional string totalAmountYuan = 54;   // 总电费(可选)
  int64 tradeTs = 55;                     // 交易时间戳
  string stopReason = 56;                 // 停止原因
  int64 pricingId = 57;                   // 计费ID
  optional TransactionDetail detail = 58;  // 电量电费明细
  optional string additionalInfo = 20;     // 附加信息
}

// BMS充电错误消息
message BmsChargingErrorProto {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  optional string additionalInfo = 20;
}

// BMS参数配置上报
message BmsParamConfigReportProto {
  string pileCode = 2;             // 桩编码
  string gunNo = 3;                // 枪编号
  string tradeNo = 4;              // 交易号
  string maxSingleCellVoltage = 5;  // BMS单体最高允许充电电压 (V)
  string maxChargeCurrent = 6;      // BMS最高允许充电电流 (A)
  string ratedEnergy = 7;           // BMS动力蓄电池标称总能量 (kWh)
  string maxTotalChargeVoltage = 8; // BMS最高允许充电总电压 (V)
  string maxTemperature = 9;         // BMS最高允许温度 (℃)
  string soc = 10;                  // BMS荷电状态SOC (%)
  string currentBatteryVoltage = 11; // BMS当前电池电压 (V)
  string pileMaxOutputVoltage = 12; // 电桩最高输出电压 (V)
  string pileMinOutputVoltage = 13; // 电桩最低输出电压 (V)
  string pileMaxOutputCurrent = 14; // 电桩最大输出电流 (A)
  string pileMinOutputCurrent = 15; // 电桩最小输出电流 (A)
}

// BMS充电信息
message BmsChargingInfoProto {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  optional string additionalInfo = 20;
}

// BMS中止充电
message BmsAbortProto {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  optional string additionalInfo = 20;
}

// BMS握手信息
message BmsHandshakeProto {
  string pileCode = 2;                   // 桩编码
  string gunNo = 3;                      // 枪编号
  string tradeNo = 4;                    // 交易流水号
  string bmsProtocolVersion = 5;         // BMS通信协议版本号
  int32 bmsBatteryType = 6;              // BMS电池类型
  int32 bmsPowerCapacity = 7;            // BMS整车动力蓄电池系统额定容量
  int32 bmsPowerMaxVoltage = 8;          // BMS整车动力蓄电池系统额定总电压
  string bmsFactory = 9;                 // BMS电池生产厂商名称
  int32 bmsSerialNo = 10;                // BMS电池组序号
  int32 bmsCreateYear = 11;              // BMS电池组生产日期年
  int32 bmsCreateMonth = 12;             // BMS电池组生产日期月
  int32 bmsCreateDay = 13;               // BMS电池组生产日期日
  int32 bmsChargeCount = 14;             // BMS电池组充电次数
  int32 bmsPropertyRightLabel = 15;      // BMS电池组产权标识
  string carVinCode = 16;                // 车辆识别码(VIN)
  string bmsSoftwareVersion = 17;        // BMS软件版本号
  optional string additionalInfo = 20;   // 附加信息
}

// OTA响应
message OtaResponse {
  string pileCode = 1;         // 桩编号
  bool success = 2;
  optional string errorMsg = 3;
}

// 地锁状态上报
message GroundLockStatusProto {
  string pileCode = 2;                   // 桩编号
  string gunNo = 3;                      // 枪号
  int32 lockStatus = 4;                  // 车位锁状态
  int32 parkStatus = 5;                  // 车位状态
  int32 lockBattery = 6;                 // 地锁电量状态 (百分比值0~100)
  int32 alarmStatus = 7;                 // 报警状态
  int32 reserved = 8;                    // 预留位
  optional string additionalInfo = 20;   // 附加信息
}

// 离线卡余额更新响应
message OfflineCardBalanceUpdateResponse {
  string pileCode = 1;                    // 充电桩编码
  string cardNo = 2;                      // 物理卡号
  bool success = 3;
  optional string errorMsg = 4;
}

// 离线卡同步响应
message OfflineCardSyncResponse {
  string pileCode = 1;                    // 充电桩编码
  bool success = 3;
  optional string errorMsg = 4;
}

// 时间同步响应
message TimeSyncResponse {
  string pileCode = 1;
  string time = 2;
}



message OfflineCardClearResponse {
  string pileCode = 1;                    // 充电桩编码
  repeated ClearResult clearResult = 2;   // 清除卡号结果集合
}

message ClearResult {
  string cardNo = 1;                      // 物理卡号
  bool success = 2;
  optional string errorMsg = 3;
}



message OfflineCardQueryResponse {
  string pileCode = 1;                    // 充电桩编码
  repeated QueryResult queryResult = 2;   // 查询卡号结果集合
}

message QueryResult {
  string cardNo = 1;                      // 物理卡号
  bool exist = 2;

}



// BMS需求充电机输出
message BmsDemandChargerOutputProto {
  string pileCode = 4;
  string gunNo = 5;
  string tradeNo = 6;
  optional string additionalInfo = 20;
}
// 设置二维码响应
message SetQrcodeResponse {
  bool success = 1;
  string pileCode = 4;
  int32 type = 7;
  int32 startAddr = 8;
}