# 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**: 1
- **Created**: 2025-03-31
- **Last Updated**: 2026-01-06
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 文档目录
* [产品介绍](#section-1)
* [二次开发平台环境搭建介绍](#section-2)
* [虚拟机环境搭建](#section-2.1)
* [本地环境搭建](#section-2.2)
* [快速开发指南](#section-3)
* [编译步骤](#section-3.1)
* [固件烧录步骤](#section-3.2)
* [OTA升级步骤](#section-3.3)
## CT15产品介绍
### 外观图
### 参数介绍
**蓝色标注的内容，仅进行了样机研发或技术原型验证可行，未在实际项目中使用。**
### 设备介绍
### 使用场景介绍
***
## CT15二次开发平台环境搭建介绍
### 引言
* 此文档为在鸿控制器环境搭建指南，旨在为客户快速熟悉开发环境，从而高效地完成工作。
* 此文档主要适合以下工程师：技术开发工程师、软件开发工程师
### 虚拟机环境搭建
#### 1. 准备工作
1：准备一台电脑，无具体要求，可开发即可，已装有Windows10及以上操作系统
2：准备提供的压缩包资料
3：资料准备的虚拟机用户名为openvalley,密码为123456
#### 2. 虚拟机环境部署及Windows上远程连接虚拟机步骤
1：打开VMware Workstation工具，并点击打开虚拟机
2：打开文件夹中的虚拟机镜像vmx，进行导入
3：点击打开虚拟机设置
4: 点击导入20.04 的ISO镜像
5: 点击打开虚拟机，若出现下图所示，则点击 “我已复制虚拟机”
6: 输入虚拟机密码 123456
7：CTRL+ALT+T打开终端或鼠标右键桌面并点击打开终端
在终端上输入ifconfig，查看虚拟机ip地址，然后进行复制ip地址
8：打开mobaxterm，输入刚在虚拟机复制的ip地址和输入虚拟机用户名 openvalley
9：输入虚拟机密码 123456
10：可选：根据自行需求对虚拟机进行个性化设置
### 本地环境搭建步骤
##### 如果客户想自行在服务器或虚拟机搭建环境则参考以下步骤
步骤1：安装ccache（用于加速编译）
sudo apt install ccache
步骤2：新建一个目录，例如tools(步骤7也以此目录来更改)，用来存放下载的编译工具链
mkdir tools
步骤3：下载交叉编译工具链压缩包:
wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz
步骤4：解压工具链:
tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C tools
步骤5：安装hb 工具 进入源码根目录，执行
pip3 install build/hb --user
步骤6：打开配置文件
vim ~/.bashrc
步骤7：在文件末尾添加
export PATH=~/tools/gcc_riscv32/bin:$PATH
export PATH="$HOME/.local/bin:$PATH"
步骤8：使能配置文件
source ~/.bashrc
步骤9：通过 Linux 系统的包管理器，安装嵌入式开发、编译构建所需的各类工具与依赖库
sudo apt install bison ccache default-jdk flex gcc-arm-linux-gnueabi gcc-arm-none-eabi genext2fs libssl-dev libtinfo5 mtd-utils mtools ruby scons u-boot-tools zip
步骤10：将 /bin/sh 的默认指向从 dash 切换为 bash
sudo dpkg-reconfigure dash
步骤11：编译
***
## CT15快速开发指南
### 引言
* 本文档旨在帮助客户快速了解在鸿控制器的代码框架，包括代码结构、功能模块和配置方法及烧录方法，以便于客户能够有效地使用和进行快速开发
* 此文档主要适合以下工程师：技术开发工程师、软件开发工程师
### SDK目录结构
### SDK目录说明
| 序号 | 文件名 | 功能介绍 |
| :-: | :-----------: | :-----------------: |
| 0 | base | 基础软件服务子系统集和硬件服务子系统集 |
| 1 | build | 组件化编译、构建和配置脚本 |
| 2 | commonlibrary | 公共服务层 |
| 3 | developtools | 常用开发工具集合 |
| 4 | device | 厂商相关软件 |
| 5 | drivers | 驱动子系统 |
| 6 | foundation | 系统基础能力子系统集 |
| 7 | kernel | 内核子系统,LiteOS |
| 8 | out | 编译输出产物 |
| 9 | prebuilts | 编译器及工具链子系统 |
| 10 | productdefine | 与芯片无关的通用系统组件形态配置 |
| 11 | test | 测试子系统 |
| 12 | third\_party | 开源第三方组件 |
| 13 | vendor | 厂商相关软件 |
| 14 | build\.py | 轻量系统编译脚本的软链接 |
### 中间件目录说明
| 序号 | 组件名 | 功能介绍 |
| :-: | :----------------------: | :-----: |
| 0 | algorithm | 算法组件 |
| 1 | app\_boot | 应用启动组件 |
| 2 | cc\_protocol | 上位机协议组件 |
| 3 | common | 通用组件 |
| 4 | control\_service | 控制服务组件 |
| 5 | dsdk | 机电设备组件 |
| 6 | easyblink | 闪烁灯组件 |
| 7 | esoftbus | 软总线组件 |
| 8 | iot\_keeper | 云服务组件 |
| 9 | near\_comm | 近场通信组件 |
| 10 | params\_manage | 参数管理组件 |
| 11 | ringbuf | 环形队列组件 |
| 12 | security\_service | 安全服务组件 |
| 13 | system\_service | 系统服务组件 |
| 14 | timestamp\_data\_storage | 时间戳组件 |
| 15 | tool\_service | 工具服务组件 |
| 16 | upgrade | 升级组件 |
| 17 | web\_client | Web服务组件 |
| 18 | wireless\_module | 无线模块组件 |
### 编译步骤
准备工作：环境搭建请跳转查看[CT15二次开发平台环境搭建介绍](#section-2)
步骤1：在SDK顶层目录下，输入hb set
步骤2：按住键盘上下键，选择mini
步骤3：选择对应的单板名称,如CT15
步骤4：输入hb build -f
步骤5：编译生成固件产物
### 在鸿控制器编译产物说明
+ #### bin文件：
**路径**：out/ct15/ct15/OHOS_Image.bin
**作用**：编译生成的固件产物，用于烧录固件所用
+ #### asm文件：
**路径**：out/ct15/ct15/OHOS_Image.asm
**作用**：用于代码崩溃时分析
+ #### ota.bin文件：
**路径**：out/ct15/ct15/OHOS_OTA_V2.9.0.bin
**作用**：编译生成的固件产物，用于OTA时所用
### 在鸿控制器CT15固件烧录
+ #### 准备工具：
1. CT15控制器一台
2. TYPE-C线一根，(用来烧录固件)
3. 串口调试助手（可以通过MoBaXterm/xshell/在鸿控制器上位机cctools查看日志）
4. 上位机软件cctools
5. 固件
6. 220V转24V电源
7. RJ45转TTL串口线一根(用来查看日志消息)
+ #### 接线及固件烧录步骤：
步骤1：用镊子按下控制器旁边按键，再拔插电源，即可进入烧录模式
步骤2：打开上位机软件cctools工具进行烧录
步骤3：烧录完毕之后再拔插电源，即可查看日志并进行调试
步骤4：查看日志，将调试口接入电脑上，打开串口，设置波特率为1500000
**也可以通过cctools查看日志，将控制器接好网线，电脑跟控制器在同一个网段下，打开上位机软件；进行搜索及连接设备，点击日志终端查看日志信息**
### 在鸿控制器CT15 OTA烧录
+ #### 准备工具：
1. CT15控制器一台
2. 上位机软件cctools
3. 固件
4. 网线
5. 220V转24V电源
6. RJ45转TTL串口线一根(用来查看日志消息)
+ #### 接线及固件烧录步骤：
步骤1：将控制器接好网线，电脑跟控制器在同一个网段下
步骤2：打开cctools工具，搜索设备进行连接
步骤3：点击OTA升级界面
步骤4：点击选择想要OTA升级的设备
步骤5：点击选择OTA路径
步骤6：点击升级按钮进行OTA升级
步骤7：若显示升级状态为 传输完成 则OTA升级成功。(若显示升级超时，则重新选择设备，再点开始升级，直到升级成功)
