简介
OpenAtom OpenHarmony（以下简称“OpenHarmony”） 3.2 Beta5版别在OpenHarmony 3.1 Release版别的基础上，有以下改动：性能上有很大的提高、规范体系运用开发结构增强、规范体系分布式能力增强。
本文介绍诚迈科技根据RK3568规划的HCPAD-100开发板以及根据RK3566规划的中控屏HongzPad2022在OpenHarmony 3.2 Beta5版别上的适配进程。
涉及到开发板的增加/u-boot /linux-5.10/分区表/根文件体系/显现/触摸/USB的移植进程以及OpenHarmony所依靠的驱动特性介绍。
怎么增加新的开发板进行编译
参照DAYU200的工程装备文件咱们新建自己的编译指令。1)在device/board/目录新建archermind目录，新建rk3568/rk3588/rk3399目录，并增加相关的工程文件。
2)在vendor目录新建archermind目录。新建以下几个目录，并增加相关的工程文件。
3)修正vendor/archermind/hongzos_rk3568/config.json文件，product_name改成hongzos_rk3568，device_build_path改成第一步新建的目录。
{
"product_name": "hongzos_rk3568",
"device_company": "rockchip",
"device_build_path": "device/board/archermind/rk3568",
"target_cpu": "arm",
"type": "standard",
"version": "3.0",
"board": "rk3568",
经过./build.sh –product-name hongzos_rk3568来编译出咱们自己开发板的镜像，编译完后对应开发板的image镜像放在out/rk3568/packages/phone/目录。相关代码放在文章最终的参阅链接。
U-Boot移植
U-boot是经过二进制镜像直接放在device/board/hihope/rk3568/loader目录下的，这个目录下涉及到文件如下：
1)下载rk官方发布的uboot源码
git clone https://github.com/rockchip-linux/u-boot.git
2)修正make.sh, 指定RKBIN_TOOLS的路径
RKBIN_TOOLS=rkbin/tools
3）增加代码读取ramdisk分区到指定的内存方位，修正cmd/pxe.c
#include "boot_rkimg.h"
#define BLK_CNT(_num_bytes, _block_size) \
((_num_bytes + _block_size - 1) / _block_size)
static char* load_ramdisk_from_partition(void *buffer)
{
struct blk_desc *desc = rockchip_get_bootdev();
disk_partition_t part_ramdisk_boot;
static char initrd_str[28];
long blk_cnt = 0, blks_read = 0;
long blk_start = 0;
if (part_get_info_by_name(desc, "ramdisk", &part_ramdisk_boot) < 0) {
printf("No ramdisk partition\n");
return NULL;
}
blk_cnt = part_ramdisk_boot.size;
blk_start = part_ramdisk_boot.start;
printf("Load from partition ' ramdisk ' to address 0x%p, count: %ld total block(s) by ludao\n", buffer, blk_cnt);
blks_read = blk_dread(desc, blk_start, blk_cnt, buffer);
if (blks_read != blk_cnt) {
return NULL;
}
printf("Read from partition ' ramdisk ' done, from 0x%lx total block(s) 0x%lx\n", blk_start, blk_cnt);
sprintf(initrd_str, "0x%p:0x%lx", buffer, blk_cnt*(part_ramdisk_boot.blksz));
printf("Openharmony ramdisk_addr_r = %s\n", initrd_str);
return initrd_str;
}
static int label_boot(cmd_tbl_t *cmdtp, struct pxe_label *label)
if (label->initrd) {
if (get_relfile_envaddr(cmdtp, label->initrd, "ramdisk_addr_r") < 0) {
printf("Skipping %s for failure retrieving initrd\n",
label->name);
return 1;
}
bootm_argv[2] = initrd_str;
strncpy(bootm_argv[2], env_get("ramdisk_addr_r"), 18);
strcat(bootm_argv[2], ":");
strncat(bootm_argv[2], env_get("filesize"), 9);
}else{
void *buffer = (void *)env_get_ulong("ramdisk_addr_r", 16, 0);
bootm_argv[2] = load_ramdisk_from_partition(buffer);
if(bootm_argv[2]){
printk("initrd = %s \n", bootm_argv[2]);
}
}
4）指定交叉编译器和平台开端编译，编译完成后根目录会生成u-boot.bin
./make.sh CROSS_COMPILE=aarch64-linux-gnu- rk3568
一切相关代码现已放到开源社区，咱们能够下载下来直接编译运用，相关代码放在文章最终的参阅链接。
Linux-5.10移植
1）内核编译脚本
linux编译脚本的是放在device/board/hihope/rk3568/kernel目录下的build_kernel.sh文件，由于kernel/linux/linux-5.10是公共代码，OpenHarmony编译脚本是经过打补丁的方法来适配不同平台，不同的平台有自己的内核补丁。
编译脚本会先把kernel/linux/linux-5.10拷贝到out/kernel/src_tmp/linux-5.10/，然后打上3568的内核补丁patch -p1 < kernel/linux/patches/linux-5.10/rk3568_patch/kernel.patch后编译生成自己的镜像，不利于咱们开发，咱们自己开发进程中做如下修正，这样便利咱们开发进程中的修正。
先进入kernel/linux/linux-5.10目录
patch -p1 < kernel/linux/patches/linux-5.10/rk3568_patch/kernel.patch
修正device/board/hihope/rk3568/kernel/build_kernel.sh
注释掉
//patch -p1 < ${KERNEL_PATCH}
2)设备树的定制，首要咱们需求有自己的板子的设备树例如rk3568-chujue-linux.dts
把设备树放到kernel/linux/linux-5.10/arch/arm64/boot/dts/rockchip/目录
修正kernel/linux/linux-5.10/ make-ohos.sh
model_list=(
"TB-RK3568X0 arm64 0xfe660000 rk3568-toybrick-x0-linux Image rockchip_linux_defconfig"
"TB-RK3568X10 arm64 0xfe660000 rk3568-toybrick-x10-linux Image rockchip_linux_defconfig"
)
修正其间的TB-RK3568X0，把rk3568-toybrick-x0-linux改成咱们自己的rk3568-chujue-linux.dts，
TB-RK3568X0是在device/board/hihope/rk3568/kernel/build_kernel.sh指定的
这样编程后生产设备树便是咱们自己开发板的，设备树假如不对，机器将会无法开机，U-boot也会无法敞开。
3）内核config的定制
文件方位kernel/linux/config/linux-5.10/arch/arm64/configs/rk3568_standard_defconfig3.2 显现设备需求翻开CONFIG_DRM_PANEL_SIMPLE装备显现才干正常显现
CONFIG_DRM_PANEL_SIMPLE = y
kernel/linux/linux-5.10/drivers/gpu/drm/panel/panel-simple.c
注释掉
//int panel_simple_loader_protect(struct drm_panel *panel)
4）发动Logo定制修正device/board/hihope/rk3568/kernel目录的图片即可
kernel/linux/linux-5.10/ make-ohos.sh
cmdline="append earlycon=uart8250,mmio32,${uart} root=PARTUUID=614e0000-0000-4b53-8000-1d28000054a9 rw rootwait rootfstype=ext4
分区表
1）rk3568采样的是GPT格式的分区表，v3.2新增加了三个分区sys_prod, chip-prod,ramdisk经过修正以下文件来修正分区表的装备,咱们能够直接运用dayu开发板的分区表。device/board/hihope/rk3568/loader/parameter.txt
FIRMWARE_VER:11.0
MACHINE_MODEL:rk3568_r
MACHINE_ID:007
MANUFACTURER: rockchip
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: rk3568_r
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
CMDLINE:mtdparts=rk29xxnand:0x00002000@0x00002000(uboot),0x00002000@0x00004000(misc),0x00003000@0x00006000(resource),0x00030000@0x00009000(boot_linux:bootable),0x00002000@0x00039000(ramdisk),0x00400000@0x0003B000(system),0x00200000@0x0043B000(vendor),0x00019000@0x0063B000(sys-prod),0x00019000@0x00654000(chip-prod),0x00010000@0x0066D000(updater),-@0x0067D000(userdata:grow)
uuid:system=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot_linux=a2d37d82-51e0-420d-83f5-470db993dd35
device/board/hihope/rk3568/cfg/fstab.rk3568
# fstab file.
#<src> <mnt_point> <type> <mnt_flags and options> <fs_mgr_flags>
/dev/block/platform/fe310000.sdhci/by-name/system /usr ext4 ro,barrier=1 wait,required
/dev/block/platform/fe310000.sdhci/by-name/vendor /vendor ext4 ro,barrier=1 wait,required
/dev/block/platform/fe310000.sdhci/by-name/sys-prod /sys_prod ext4 ro,barrier=1 wait
/dev/block/platform/fe310000.sdhci/by-name/chip-prod /chip_prod ext4 ro,barrier=1 wait
/dev/block/platform/fe310000.sdhci/by-name/userdata /data f2fs discard,noatime,nosuid,nodev,fscrypt=2:aes-256-cts:aes-256-xts wait,check,fileencryption=software,quota
/dev/block/platform/fe310000.sdhci/by-name/misc /misc none none wait,required
2）怎么修正RKDevTool.exe工具加载的分区表
parameter.txt文件中的CMDLINE字段中有mtdparts=，其间0x00002000@0x00002000(uboot)的括号里边是分区的名字，@后边的0x00002000是分区的开端地址，以4k为单位的偏移地址，@前面是分区的大小，注意修正的时分要注意连续性，不要有堆叠的方位。
根文件体系
1)ramdisk从3.1到3.2的变化
3.1中ramdisk.Img是放在out/kernel/src_tmp/linux-5.10/boot_linux/目录下被打包到boot_linux.img中。
3.2的ramdisk.Img是直接放在单独的分区里边，由Boot在开机的形式不同的情况下挑选加载不同的根文件体系
2）怎么修正ramdisk
在.gn文件里边增加对应的装备文件，生成的文件将会被放到ramdisk镜像里边
image_list += [ "ramdisk", "updater_ramdisk", ]
显现模块适配
1)Devices tree装备
经过设备树来翻开mipi 通道1的装备和hdmi的设备，OpenHarmony 3.2 Beta5 是支撑多屏异显的，OpenHarmony 3.1 Release 不支撑。
&dsi1 {
status = "okay";
//rockchip,lane-rate = <200>;
dsi1_panel: panel@0 {
status = "okay";
compatible = "simple-panel-dsi";
reg = <0>;
backlight = <&backlight>;
reset-delay-ms = <60>;
enable-delay-ms = <60>;
prepare-delay-ms = <60>;
unprepare-delay-ms = <60>;
disable-delay-ms = <60>;
dsi,flags = <(MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST |
MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_EOT_PACKET)>;
dsi,format = <MIPI_DSI_FMT_RGB888>;
dsi,lanes = <4>;
panel-init-sequence = [
05 78 01 11
05 14 01 29
];
panel-exit-sequence = [
05 00 01 28
05 00 01 10
];
disp_timings1: display-timings {
native-mode = <&dsi1_timing0>;
dsi1_timing0: timing0 {
clock-frequency = <150000000>;
hactive = <1200>;
vactive = <1920>;
hback-porch = <120>;
hfront-porch = <10>;
vback-porch = <10>;
&hdmi {
status = "okay";
rockchip,phy-table =
<92812500 0x8009 0x0000 0x0270>,
<165000000 0x800b 0x0000 0x026d>,
<185625000 0x800b 0x0000 0x01ed>,
<297000000 0x800b 0x0000 0x01ad>,
<594000000 0x8029 0x0000 0x0088>,
<000000000 0x0000 0x0000 0x0000>;
};
2)内核翻开相关的装备
3.2中默许关闭了CONFIG_DRM_PANEL_SIMPLE，但是咱们的设备数中字段需求依靠这个装备项，所以需求翻开它。
CONFIG_DRM_PANEL_SIMPLE=y
CONFIG_DRM_ANALOGIX_DP=y
CONFIG_DRM_DW_HDMI=y
CONFIG_DRM_DW_HDMI_I2S_AUDIO=y
CONFIG_DRM_DW_HDMI_CEC=y
CONFIG_DRM_DW_MIPI_DSI=y
3)HAL层的适配
源码结构
显现HDI需求适配两部分：gralloc 和 display_device。
display device适配
display device模块提供显现设备管理、layer管理、硬件加速等功用。
drm设备节点界说
在//device/soc/rockchip/rk3568/hardware/display/src/display_device/drm_device.cpp文件中，可根据实际情况修正
std::shared_ptr<HdiDeviceInterface> DrmDevice::Create()
{
DISPLAY_DEBUGLOG();
if (mDrmFd == nullptr) {
const std::string name("rockchip");
int drmFd = open("/dev/dri/card0", O_RDWR | O_CLOEXEC); // drmOpen(name.c_str(), nullptr);
}
如开发板不支撑硬件组成或是有问题的时分，需求在drm_display.cpp文件中越过gfx的初始化。
int32_t DrmDisplay::Init()
{
...
...
ret = preComp->Init(); // gfx初始化，这儿需求越过
DISPLAY_CHK_RETURN((ret != DISPLAY_SUCCESS), DISPLAY_FAILURE, DISPLAY_LOGE("can not init HdiGfxComposition")); // 或者不判别返回值
}
同时在//device/soc/rockchip/rk3568/hardware/display/src//hdi_gfx_composition.cpp文件中修正set_layers方法，全部运用CPU组成显现。
int32_t HdiGfxComposition::SetLayers(std::vector<HdiLayer *> &layers, HdiLayer &clientLayer)
{
#if 0 // CPU组成
layer->SetDeviceSelect(COMPOSITION_CLIENT);
#else
if ((layer->GetCompositionType() != COMPOSITION_VIDEO) &&
(layer->GetCompositionType() != COMPOSITION_CURSOR)) {
layer->SetDeviceSelect(COMPOSITION_DEVICE);
} else {
layer->SetDeviceSelect(layer->GetCompositionType());
}
#endif
}
gralloc适配
gralloc模块提供显现内存管理功用，OpenHarmony提供了运用与Hi3516DV300参阅完成。drm设备节点界说在
//device/soc/rockchip/rk3568/hardware/display/src/display_gralloc/display_gralloc_gbm.c文件中，可根据实际情况修正
const char *g_drmFileNode = "/dev/dri/card0";
1)Devices tree装备
咱们的开发板运用的是gt9XX的触摸屏，所以咱们把相关的信息装备进去。
gt9xx: gt911@14 {
compatible = "goodix,gt9xx";
reg = <0x14>;
pinctrl-names = "default";
pinctrl-0 = <&tp_gpio>;
goodix_irq_gpio = <&gpio3 RK_PB4 IRQ_TYPE_LEVEL_LOW>;
goodix_rst_gpio = <&gpio3 RK_PB3 GPIO_ACTIVE_HIGH>;
/*touchscreen-inverted-x;*/
status = "okay";
};
2)内核驱动装备
翻开内核装备CONFIG_TOUCHSCREEN_GT9XX=y
驱动源码里边把一切ABS_MT_WIDTH_MAJOR相关的特点去掉。3.2不识别有这个特点的输入设备。
kernel/linux/linux-5.10/drivers/input/touchscreen/gt9xx/gt9xx.c
//input_set_abs_params(ts->input_dev, ABS_MT_WIDTH_MAJOR, 0, 255, 0, 0);
USB调试适配
- 调试工具
开发板的USB host是规范的linux驱动架构，OpenHarmony 对这块基本不需求做修正，USB的设备包含鼠标，sdcard都会默许支撑。
USB 作为devices,最常用的功用是连接电脑，用电脑端的hdc shell来调试设备，这样咱们才干在后续作业中抓取日志剖析。
hdc shell “dmesg -Tw” 实时获取kernel 日志
hdc shell “hilog” 获取OpenHarmony 日志
2)USB devices设备的端口挑选
init.rk3568.usb.cfg文件中有Usb初始化参数设置，其间最主要的是
sys.usb.controller设置成正确的基地址以及设备类型
"setparam sys.usb.controller fcc00000.dwc3"
总结
至此咱们的开发板具有自己的开发基线，也现已能够进入到桌面，触摸屏，USB鼠标，hdc调试都现已正常作业,咱们接下来进行下一阶段的适配作业。
参阅链接
以下是源码仓库地址
gitee.com/harchermind…
gitee.com/harchermind…
gitee.com/harchermind…
gitee.com/harchermind…
