# zaiohController_ct15_second_develop **Repository Path**: zaihong/zaiohController_ct15_second_develop ## Basic Information - **Project Name**: zaiohController_ct15_second_develop - **Description**: 在鸿控制器CT15二次开发平台SDK工程代码 以太网版分支：master 4G+以太网版分支：master-4g 5G+以太网版分支：master-5g - **Primary Language**: C - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 2 - **Created**: 2025-03-31 - **Last Updated**: 2026-03-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 在鸿控制器CT15二次平台开发指南 ## 引言 在鸿控制器CT15是一款基于国产开源鸿蒙操作系统（OpenHarmony）的软硬一体化工控终端。它不仅是一个高性能、高可靠性的边缘控制节点，更是一个功能强大、开放灵活的二次开发平台。传统工业控制系统往往面临协议封闭、集成困难、定制成本高等挑战，而CT15旨在通过其开放的架构和丰富的开发接口，赋能开发者与合作伙伴，快速构建贴合业务需求的智能控制解决方案。 本指南旨在系统性地介绍CT15的二次开发能力，帮助您快速上手，将创新构想转化为实际应用。 ## 适用人群 - 企业研发人员：需基于控制器扩展功能、对接自有业务系统的嵌入式 / 移动端开发团队 - 系统集成商：需将控制器集成至物联网解决方案、搭建多设备联动系统的技术实施人员 - 运维管理人员：需通过 CCTool 工具进行设备批量管理、故障排查的运维团队 - 高校 / 开发者：学习鸿蒙设备二次开发、进行技术验证或原型开发的个人开发者 - 产品测试人员：验证二次开发功能兼容性、稳定性的测试工程师 ## 核心特性简介 CT15的设计充分考虑了工业场景的可靠性与开发的便捷性，其主要特性包括： **1. 开放的鸿蒙原生平台**: 搭载自主可控的在鸿OS，天然具备分布式软总线能力，支持设备自发现、自组网，为构建分布式控制系统奠定基础。 **2.灵活的硬件扩展**：采用模块化设计，支持DI、DO、AI、AO、RO等多种I/O子模块即插即用与任意组合，最大支持稳定扩展6个子模块，端口自带指示灯便于调试。 **3.强大的内置服务**： - **设备接入**：支持Modbus、S7等多种工业协议，集成超过100+种行业设备的控制模型库，使设备可免开发快速接入。对于模型库之外的设备，借助自研的Dsdk设备驱动框架，即可快速完成三端适配(移动端、云端、设备端)。 - **高效运维**：具备控制状态保持功能（OTA升级或重启时输出状态不变）、离线数据补报、日志环形缓存与长期存储等能力，保障业务连续性与问题可追溯。 - **全面安全**：支持国密算法（SM2/SM3/SM4）及证书链注入，提供从硬件到通信的全链路安全增强。 **4.丰富的管理工具**：提供上位机软件CCTools（用于远程设备发现、日志查看、文件管理、批量OTA升级）、配套鸿蒙APP（支持近场“碰一碰”连接与巡检）以及内嵌Web服务，满足从开发、部署到运维的全周期需求。 ## 二次开发平台的作用 CT15提供的二次开发平台，其核心作用是打破传统黑盒限制，将控制器及移动终端的能力以标准接口和工具的形式开放给开发者，从而实现： - **深度业务定制** ：开发者可借助提供的SDK，为特定场景（如智慧隧道、智慧楼宇）开发定制化的智能控制逻辑应用。 - **生态快速集成**：对于尚未内置驱动的新设备或专用设备，开发者可以利用平台提供的统一API和开发框架，快速开发设备驱动，并将其无缝集成到CT15的生态体系中。 - **专属工具构建**：平台提供了完整的Android和OpenHarmony SDK，合作伙伴或终端客户可以基于此开发属于自己的设备管理APP，实现品牌、界面和功能的完全定制，满足特定的运维管理流程。 ## 二次开发内容详解 CT15控制器提供了一个层次清晰、能力开放的二次开发平台，开发者可以根据需求，在控制器**设备端**或**移动端**进行深度定制与功能扩展。 ### 设备端二次开发 设备端二次开发是指在CT15控制器本地进行的功能定制与扩展。开发者可以充分利用其开放的系统架构和成熟的软硬件服务，快速对接行业生态设备，构建贴合复杂场景需求的智能化解决方案。 #### 核心开发内容 - 设备驱动与协议扩展 虽然控制器已集成超过100种行业设备的控制模型库，并支持Modbus、S7等主流工业协议，实现“免开发、即接即用”。但对于特殊的第三方设备或私有协议，开发者可以利用平台提供的统一设备接入SDK（DSDK）和API接口，开发新的设备驱动，快速将其纳入控制器的管理生态。 - 系统服务集成与调用 开发者可以便捷地调用控制器内置的一系列稳定、可靠的核心系统服务，从而专注于业务创新，无需重复构建底层能力。 - 定制化业务逻辑开发 基于在鸿控制器SDK底座，为特定业务场景（如智慧隧道管控、智慧楼宇能源管理）开发独立的应用，可实现数据分析、设备控制管理、云平台交互等复杂的业务逻辑。 #### 强大的能力支撑 - 为保障二次开发的高效与可靠，控制器提供了坚实的基础支撑： **开放的鸿蒙原生平台**：搭载基于OpenHarmony的自研在鸿OS，具备分布式软总线能力，支持设备自发现、自组网，为构建分布式智能控制系统奠定了基础。 **完善的开发套件**: 二次开发SDK提供了详尽的开发指南、使用手册和示例代码，极大降低了开发者的入门门槛和集成难度。 **稳定可靠的硬件基础**：控制器采用模块化设计，支持DI、DO、AI、AO等多种I/O子模块即插即用与任意组合。具备控制状态保持特性（OTA升级或重启时输出状态不变），宽电压输入（9-36V） 和电源防反接保护等工业级特性，确保定制应用能在严苛环境下稳定运行。 **设备资质齐全**：本设备已通过 CNAS 认可测试机构的多项专业检测并获得正式报告，同时具备完整的认证资质体系，涵盖**CCC 认证**及**OpenHarmony XTS 认证证书**等核心资质。 ***设备端SDK获取及使用说明详情参考***：[端侧开发指导](docs/端侧开发指导.md) - [产品概述](docs/产品概述/产品概述.md) - [开发环境准备](docs/开发环境准备/开发环境准备.md) - [基于docker容器搭建](docs/开发环境准备/基于容器搭建/docker容器开发环境搭建.md) - [基于wsl子系统搭建](docs/开发环境准备/基于wsl子系统搭建/wsl子系统开发环境搭建.md) - [基于虚拟机搭建](docs/开发环境准备/基于虚拟机搭建/虚拟机开发环境搭建.md) - [固件烧录与调试](docs/固件烧录与调试/固件烧录与调试.md) - [设置会话密钥](https://gitee.com/zaihong/zaiohController_cctools/blob/master/%E6%93%8D%E4%BD%9C%E8%AF%B4%E6%98%8E/%E4%BC%9A%E8%AF%9D%E5%AF%86%E9%92%A5.md) - [shell命令介绍](shell命令介绍/shell命令介绍.md) - [应用开发指南](docs/应用开发指南/应用开发指南.md) ### 移动端二次开发 移动端二次开发，是指为智能手机、平板电脑等便携式移动设备开发专属应用程序，用于对在鸿控制器CT15进行近场或远程的运维、管理与监控。移动端侧开发让您能够利用成熟的SDK快速获得硬件连接与控制能力，从而将开发重心集中在构建差异化的业务应用和品牌体验上，实现运维工具的私有化与专业化。 #### 开发目标与设备形态 **目标**：构建品牌化、流程化的专属管理工具，替代或补充通用的上位机软件，以更好地适配企业内部的运维流程、品牌形象和特定业务需求。 **设备形态**：主要面向 Android手机/平板以及搭载OpenHarmony的鸿蒙终端设备（如鸿蒙手机、平板）。开发者可根据最终用户的设备生态，选择合适的平台进行开发。 #### 可供选择的开发版本 为覆盖主流移动设备生态，平台提供了两套SDK： - Android版SDK：用于开发适用于安卓系统的管理APP - OpenHarmony版SDK：用于开发基于鸿蒙生态的原生应用 #### SDK已实现的核心功能（无需从零开发） 集成官方SDK后，您的应用即可快速获得以下关键能力： - 设备连接与鉴权：通过蓝牙（BLE）扫描、发现并安全连接控制器；支持NFC“碰一碰”快速连接与认证。 - 控制器与设备管理：查询控制器基本信息、运行状态、网络配置；管理（添加、配置、测试）控制器下挂载的所有子设备。 - 数据监控与设备控制：实时读取各类I/O子模块的状态、传感器数据；对连接的机电设备（如照明、风机、情报板）进行远程开关、调节等控制操作。 - 智能巡检与场景管理：执行“一键巡检”自动检查所有设备状态，并生成报告；创建和管理设备联动控制场景（如“夜间节能模式”），实现多设备一键状态切换。 - 云端服务对接：通过HTTP模块实现用户登录、产品配置证明获取等与云端平台交互的必要功能。 #### 需要开发者定制的主要内容 基于SDK提供的基础能力，开发者需要专注于以下定制化开发，以打造独特的产品： - 用户界面（UI）与用户体验（UX）：完全自定义应用的视觉设计、布局、交互流程，以符合企业品牌规范和使用习惯。 - 业务逻辑与功能扩展：在基础设备管理之上，开发贴合自身业务的特色功能，例如：工单系统、定制化的报表统计、告警推送规则、与其他企业系统的数据对接等。 - 用户与权限体系：构建适合自身组织的用户登录、角色划分和操作权限管理系统。 - 品牌元素融合：将企业Logo、配色、名称等品牌标识全面融入应用。 ***移动端SDK获取及使用说明详情参考***： - [Android移动端开发指导](https://gitee.com/zaihong/zaiohController_android_sdk) - [OpenHarmony移动端开发指导](https://gitee.com/zaihong/zaiohController_openharmony_sdk) ## 上位机工具（CCTools）—— 开发与运维的效率利器 为了显著提升开发、调试和生产运维效率，我们为CT15控制器提供了功能强大的专用上位机软件 CCTools。它是贯穿二次开发全周期的重要工具，而非开发对象。主要有如下几点核心作用： - **设备发现与连接**：支持跨网段搜索和连接控制器，极大方便了实验室和现场调试。 - **深度调试与运维**： 日志终端：实时查看控制器运行日志，支持远程Shell命令，是定位问题的首要工具。 文件管理：在PC和控制器之间上传/下载文件，用于部署应用、导出数据。 参数管理：可视化地查询、修改控制器各项系统参数和用户参数。 配置备份：用于批量导出项目现场设备配置数据，方便后期运维管理。 - **生产与部署**： 固件烧录：通过USB对单台设备进行固件烧录，通常用于设备出厂时或程序异常时设备烧录。 OTA升级：可通过网络对单台或多台控制器进行固件批量升级。 安全管理：用于设备证书链注入和设备License激活，是设备安全的基石。 CCtools工具获取及使用说明详情参考：[CCTools上位机工具](https://gitee.com/zaihong/zaiohController_cctools)