OCPP Python实现教程

本指南将详细介绍如何探索并使用mobilityhouse/ocpp这一Python库，该库实现了Open Charge Point Protocol（OCPP）的JSON版本。OCPP是用于电动汽车充电站与中央管理系统之间通信的应用层协议。我们将关注其目录结构、启动文件以及配置文件的关键要素。

1. 项目目录结构及介绍

ocpp项目遵循了清晰的组织结构，便于开发者理解和扩展。以下是主要的目录和文件说明：

• docs: 包含有关OCPP协议的文档和教程，分为v16和v201两个子目录，每个对应不同的协议版本。
• examples: 实践示例代码，展示了如何构建一个简单的OCPP中央系统和充电站。
  • csms: 中央系统管理系统的示例代码。
  • charging_station: 充电站端的示例代码。
• occpp: 核心包，存放着实现OCPP协议的Python类和枚举类型。
  • 分别有针对OCPP 1.6和2.0.1的子包。
• script: 可能包含脚本或辅助工具，但未具体提及。
• tests: 单元测试相关文件，确保代码质量。
• flake8, gitignore, readthedocs.yml, MANIFEST.in, Makefile, README.rst, pyproject.toml: 开发和文档相关的配置文件。
• LICENSE: 许可证文件，指出大部分内容遵循MIT许可证，而特定文档部分采用Creative Commons Attribution-NoDerivatives 4.0 International Public License。

2. 项目启动文件介绍

在examples目录下，有两个关键的启动文件演示如何开始一个OCPP服务：

对于中央系统（CSMS）

• 启动文件: 示例中没有明确列出单个“启动文件”，而是通过异步函数main()来展示整个流程，需在对应的.py文件中执行该函数。
• 关键代码: 使用websockets创建服务器，监听连接，并在接收到新连接时初始化ChargePoint实例处理协议消息。

对于充电站（Charging Station）

• 启动文件: 类似地，通过异步函数执行，设置充电站并与中央系统建立连接，发送BootNotification请求。
• 关键代码: 初始化ChargePoint实例，并调用send_boot_notification方法尝试与中央系统建立注册。

3. 项目的配置文件介绍

尽管项目示例中并未直接强调外部配置文件的使用，配置逻辑通常嵌入到代码内部。例如，在中央系统和充电站的示例中，连接参数（如地址、端口、子协议）作为硬编码值直接在代码中定义。对于实际部署，推荐的做法是采用环境变量或外部配置文件来存储这些敏感信息，以提高灵活性和安全性。

假设自定义配置方案

如果自行实现配置外置，可能会涉及的配置文件例子（非项目自带）:

• config.py

  CENTRAL_SYSTEM_URL = "ws://your-central-system-address:port"
  CHARGE_POINT_ID = "CP_1"
  

然后在你的主应用中导入并使用这些配置，但这需要你自己实现。

总结，mobilityhouse/ocPP项目提供了坚实的基础来搭建和管理电动汽车充电网络，虽然项目本身并不直接提供一个典型的配置文件，通过代码示例的解析我们可以了解如何手动配置服务端点和行为，适合进一步定制化开发。