K1 OH5.0 系统定制说明
修订记录
修订版本 | 修订日期 | 修订说明 |
001 | 2025-01-13 | 初始版本 |
002 | 2025-04-18 | 添加“camera通路定制”章节 |
1. UI 定制
1.1. 更换 boot logo
Boot logo 可放置在 2 个位置:
- 所有方案共用的 boot logo 放置在
device/soc/spacemit/k1/kernel/boot/bootfs
,如下,同一个图案的 boot logo 有 4 张图,分 4 个方向,每个方案根据需要选择不同方向的 logo,一般情况下,都是选用 0° 的 logo 图片。
|-- boot_logo_spacemit_0.bmp
|-- boot_logo_spacemit_180.bmp
|-- boot_logo_spacemit_270.bmp
`-- boot_logo_spacemit_90.bmp
- 特定方案定制的 boot logo 放置在
device/board/spacemit/xxx/kernel/boot/bootfs
,如下:
|-- boot_logo_ry_270.bmp
bootlogo 对于图像的要求为 32bit 的 bmp 图像,放置新的 boot logo 在上述目录,再修改 device/board/spacemit/musepaper/kernel
的 build_kernel.sh
文件,拷贝 boot logo 到打包路径即可。
cp ${OHOS_SOURCE_ROOT}/device/soc/${DEVICE_BOARD}/k1/kernel/boot/bootfs/boot_logo_spacemit_0.bmp ${OHOS_IMAGES_DIR}/bootfs/bianbu.bmp
1.2. 更换 kernel logo
Kernel logo 是在 boot logo 之后和开机动画之间展示的 logo,目的是避免 boot logo 和开机动画之间黑屏太久,一般 kernel logo 的图案和 boot logo 保持一致。
kernel_logo 放置在 device/board/spacemit/common/kernel_logo
,如下:
|-- kernel_logo_ry_270.ppm
|-- kernel_logo_spacemit_0.ppm
|-- kernel_logo_spacemit_180.ppm
|-- kernel_logo_spacemit_270.ppm
`-- kernel_logo_spacemit_90.ppm
Kernel logo 为 ppm 格式,添加新的 kernel logo 后,再修改 device/board/spacemit/xxx/kernel
的 build_kernel.sh
文件,拷贝 kernel logo 到内核的编译路径即可。
cp -rf ${OHOS_SOURCE_ROOT}/device/board/${DEVICE_BOARD}/common/kernel_logo/kernel_logo_spacemit_0.ppm ${KERNEL_BUILD_ROOT}/drivers/video/logo/logo_linux_clut224.ppm
1.2.1. bmp 转 ppm
- 安装转换工具
sudo apt-get install netpbm
- 执行脚本,会在当前目录生成 xxx.ppm
./bmp2ppm.sh xxx.bmp
脚本内容如下:
#!/bin/bash
if [ " $1" == " " ];
then
echo "usage:$0 bmp_file"
exit 0
fi
if [ -f "$1" ]
then
echo $1
else
echo "no find file [$1]"
exit 0
fi
name=${1%%.*}
bmptopnm $1 > $name.pnm
pnmquant 224 $name.pnm > $name.clut224.pnm
pnmtoplainpnm $name.clut224.pnm > $name.ppm
rm $name.pnm $name.clut224.pnm
1.3. 更换开机动画
更换开机动画有 2 种方式,一个是更换原生开机动画,另一个是添加定制动画,下面分别说明:
1.3.1. 更换原生动画
原生开机动画是 foundation/graphic/graphic_2d/frameworks/bootanimation/data
的 bootpic.zip
,可以替换这个 zip 包。
开机动画 zip 包内容包括:
|-- config.json
`-- OH_bootAni compressed
|-- OH_bootAni_00000.jpg
|-- OH_bootAni_00001.jpg
|-- OH_bootAni_00002.jpg
|-- OH_bootAni_00003.jpg
|-- ...
|-- OH_bootAni_00146.jpg
|-- OH_bootAni_00147.jpg
|-- OH_bootAni_00148.jpg
`-- OH_bootAni_00149.jpg
config.json 的内容为:
{
"Remark": "FrameRate Support 30, 60 frame rate configuration",
"FrameRate": 30
}
自己定制开机动画需要按照上面的格式和内容来定制。
1.3.2. 添加定制动画
vendor/spacemit/xxx
目录下,加入 bootanimation_custom_config.json
配置文件,里面配置定制动画的路径,如下:
{
"cust.bootanimation.pics": "/sys_prod/etc/bootanimation/cust_bootpic.zip",
"cust.bootanimation.sounds": "/sys_prod/etc/bootanimation/cust_bootsound.wav",
"cust.bootanimation.video": "/sys_prod/etc/bootanimation/cust_bootvideo.mp4"
}
并在上述文件对应的路径放入定制开机动画。
1.4. 更换开机音乐
更换开机音乐有 2 种方式,一个是更换原生开机音乐,另一个是添加定制音乐,下面分别说明:
1.4.1. 更换原生音乐
原生开机音乐是 foundation/graphic/graphic_2d/frameworks/bootanimation/data
的 bootsound.wav
,可以替换这个 wav 文件,音乐的时长不用太长。
1.4.2. 添加定制音乐
vendor/spacemit
目录下,加入 bootanimation_custom_config.json
配置文件,里面配置定制音乐的路径,如下:
{
"cust.bootanimation.pics": "/sys_prod/etc/bootanimation/cust_bootpic.zip",
"cust.bootanimation.sounds": "/sys_prod/etc/bootanimation/cust_bootsound.wav",
"cust.bootanimation.video": "/sys_prod/etc/bootanimation/cust_bootvideo.mp4"
}
并在上述文件对应的路径放入定制开机音乐。
1.5. 更换开机视频
更换开机视频有 2 种方式,一个是更换原生开机视频,另一个是添加定制视频,下面分别说明:
1.5.1. 更换原生视频
原生开机视频是 foundation/graphic/graphic_2d/frameworks/bootanimation/data
的 bootvideo.mp4
,可以替换这个 mp4 文件,确保开机视频的视频编码格式为 H.264,视频长宽比例与屏幕长宽比例一致。
1.5.2. 添加定制视频
vendor/spacemit
目录下,加入 bootanimation_custom_config.json
配置文件,里面配置定制视频的路径,如下:
{
"cust.bootanimation.pics": "/sys_prod/etc/bootanimation/cust_bootpic.zip",
"cust.bootanimation.sounds": "/sys_prod/etc/bootanimation/cust_bootsound.wav",
"cust.bootanimation.video": "/sys_prod/etc/bootanimation/cust_bootvideo.mp4"
}
并在上述文件对应的路径放入定制开机视频。
1.6. 开机视频切换为开机动画
目前系统中默认开启了开机视频,没有使用开机动画,如果想要切换为开机动画,需要关闭开机视频播放,进行修改:vendor/spacemit/xxx/config.json
的 "component": "graphic_2d"
中添加 graphic_2d_feature_player_framework_enable = false
,如下所示:
fuqiang@snode2:~/workspace/oh5_r_release/vendor/spacemit/musepaper2$ git diff
diff --git a/musepaper2/config.json b/musepaper2/config.json
index d70ad50..ef16ca6 100755
--- a/musepaper2/config.json
+++ b/musepaper2/config.json
@@ -21,7 +21,8 @@
"subsystem": "graphic",
"components": [
{
"component": "graphic_2d",
"features": [
"graphic_2d_feature_ace_enable_gpu = true",
"graphic_2d_feature_parallel_render_enable = true",
- "graphic_2d_feature_rs_enable_eglimage = true"
+ "graphic_2d_feature_rs_enable_eglimage = true",
+ "graphic_2d_feature_player_framework_enable = false"
]
},
{
2. 应用定制
2.1. 预置应用
2.1.1. 添加预置应用
- 将 hap 放置于
applications/standard/hap
- 修改
applications/standard/hap/BUILD.gn
配置,如下例(以浏览器 hap 为例):
diff --git a/BUILD.gn b/BUILD.gn
index c9ea451..87ed7aa 100755
--- a/BUILD.gn
+++ b/BUILD.gn
@@ -407,6 +407,13 @@ ohos_prebuilt_etc("tetris_hap") {
subsystem_name = "applications"
}
+ohos_prebuilt_etc("broswer_hap") {
+ source = "Broswer.hap"
+ module_install_dir = "app/ohos.samples.browser"
+ part_name = "prebuilt_hap"
+ subsystem_name = "applications"
+}
+
group("hap") {
deps = [
":calendarData_hap",
@@ -464,6 +471,7 @@ group("hap") {
"//applications/standard/hap:wuziqi_hap",
"//applications/standard/hap:deviceinfo_hap",
"//applications/standard/hap:tetris_hap",
+ "//applications/standard/hap:broswer_hap",
]
if (defined(product_name) && product_name == "watchos") {
deps -= [
- 修改
vendor/spacemit/xxx/preinstall-config/install_list.json
配置进行安装,如下例:
diff --git a/musepaper/preinstall-config/install_list.json b/musepaper/preinstall-config/install_list.json
index dd859c2..0107e85 100755
--- a/musepaper/preinstall-config/install_list.json
+++ b/musepaper/preinstall-config/install_list.json
@@ -220,6 +220,10 @@
"app_dir": "/system/app/ohos.samples.game2048",
"removable": false
},
+ {
+ "app_dir": "/system/app/ohos.samples.label",
+ "removable": false
+ },
{
"app_dir": "/system/app/com.example.Digital_Huarong_Road",
"removable": false
2.1.2. 删除预置应用
删除应用是添加应用的逆操作,可以参考上面章节,将 vendor/spacemit/xxx/preinstall-config/install_list.json
中的对应 hap 的配置删除即可。
2.1.3. 预置应用可卸载
很多预置的系统应用是不可拆卸的,如果想将预置应用修改为可拆卸,修改如下:vendor/spacemit/xxx/preinstall-config/install_list.json
中将对应应用的 "removable"
设置为 true
,如下所示:
{
"app_dir" : "/system/app/com.ohos.note",
"removable" : true
},
2.2. 替换系统应用
通过 Ability 来区分的话,系统应用又会分为如下两类:
- UIAbility,如:Settings、Photos、Camera 等,这类系统应用能够展示在桌面。
- ExtensionAbility,如:Launcher、SystemUI、Settingsdata 等,这类系统应用有的创建了窗口从而能显示界面,而有的则属于无页面的常驻服务去提供对应的能力。
因此传统的 hdc install
命令以及 IDE 的自动安装都 无法正常安装,这个时候,就需要用到系统应用的替换。
以 Launcher 为例,系统应用的替换步骤如下:
- 找到 Launcher 预置 hap 路径
/system/app/com.ohos.launcher
,可以看到该路径下有 2 个 hap:Launcher.hap
和Launcher_Settings.hap
- 执行以下指令
hdc shell mount -o remount,rw /
hdc shell rm -rf /data/*
hdc file send Launcher.hap /system/app/com.ohos.launcher/Launcher.hap
hdc file send Launcher_Settings.hap /system/app/com.ohos.launcher/Launcher_Settings.hap
hdc shell reboot
- 即可正常替换安装自己构建的 Launcher
2.3. 相册
2.3.1. 推送视频
- 准备
xxx.mp4
视频 - 通过 hdc 将视频推入机器
D:\>hdc file send D:\xxx.mp4 /storage/media/100/local/files/Videos/
- 触发媒体扫描
D:\>hdc shell
# scanner
#
- 打开
相册
应用,播放视频,如果没有视频,将相册
应用后台删除,重新进入
2.3.2. 推送图片
- 准备
xxx.jpg
或者xxx.png
图片 - 通过 hdc 将图片推入机器
D:\>hdc file send D:\xxx.jpg /storage/media/100/local/files/Pictures/
- 触发媒体扫描
D:\>hdc shell
# scanner
#
- 打开
相册
应用,显示图片,如果没有图片,将相册
应用后台删除,重新进入
2.4. Launcher
2.4.1. 替换背景图片
背景图片需要准备 2 张,1 张清晰,1 张模糊,配对使用,如下:
主要修改下面几个位置:
-
修改 systemui,替换下面图片后,重新编译 systemui,将新生成的 hap 放入
applications/standard/hap
文件夹applications/standard/systemui/product/phone/dropdownpanel/src/main/resources/phone/media/dropdownpanel_bgc.jpg
-
修改 launcher,替换下面图片后,重新编译 launcher,将新生成的 hap 放入
applications/standard/hap
文件夹applications/standard/launcher/product/phone/src/main/ets/common/pics
applications/standard/launcher/feature/appcenter/src/main/ets/default/common/pics/ic_wallpaper_form_manager.jpg
applications/standard/launcher/feature/form/src/main/ets/default/common/pics/ic_wallpaper_form_manager.jpg
applications/standard/launcher/feature/recents/src/main/ets/default/common/pics/ic_wallpaper_recent.jpg
-
修改系统,替换下面图片后,和上面修改的 hap 一起编译生成新的 img
base/theme/wallpaper_mgr/frameworks/native/data/
2.4.2. 替换 launcher
-
给自己的应用打上补丁,伪装成 launcher
diff --git a/entry/src/main/ets/pages/Index.ets b/entry/src/main/ets/pages/Index.ets
index 8e2d24a..f72e81a 100644
--- a/entry/src/main/ets/pages/Index.ets
+++ b/entry/src/main/ets/pages/Index.ets
@@ -1,3 +1,8 @@
+import hilog from '@ohos.hilog';
+import systemParameterEnhance from '@ohos.systemParameterEnhance';
+
+const DOMAIN = 0x0000;
+
@Entry
@Component
struct Index {
@@ -20,4 +25,26 @@ struct Index {
.height('100%')
.width('100%')
}
+
+ onPageShow(): void {
+ hilog.info(DOMAIN, 'launcher', 'onPageShow');
+ let firstActivate:boolean | undefined = AppStorage.get('firstActivate');
+ if (typeof firstActivate !== 'boolean') {
+ hilog.info(DOMAIN, 'launcher', 'first activate not defined');
+ AppStorage.setOrCreate('firstActivate', true);
+ this.voteBootEvent();
+ } else if (firstActivate) {
+ this.voteBootEvent();
+ }
+ }
+
+ private voteBootEvent(): void {
+ try {
+ AppStorage.setOrCreate('firstActivate', false);
+ systemParameterEnhance.setSync('bootevent.launcher.ready', 'true');
+ hilog.info(DOMAIN, 'launcher', 'set bootevent.launcher.ready -> true');
+ } catch (err) {
+ hilog.error(DOMAIN, 'launcher', 'set voteBootEvent err: %{public}s', JSON.stringify(err));
+ }
+ }
}
\ No newline at end of file
diff --git a/entry/src/main/module.json5 b/entry/src/main/module.json5
index e691821..0812247 100644
--- a/entry/src/main/module.json5
+++ b/entry/src/main/module.json5
@@ -2,8 +2,9 @@
"module": {
"name": "entry",
"type": "entry",
+ "srcEntry": "./ets/entryability/EntryAbility.ets",
"description": "$string:module_desc",
- "mainElement": "EntryAbility",
+ "mainElement": "com.ohos.launcher.MainAbility",
"deviceTypes": [
"default"
],
@@ -12,7 +13,8 @@
"pages": "$profile:main_pages",
"abilities": [
{
- "name": "EntryAbility",
+ "priority": 2,
+ "name": "com.ohos.launcher.MainAbility",
"srcEntry": "./ets/entryability/EntryAbility.ets",
"description": "$string:EntryAbility_desc",
"icon": "$media:layered_image",
@@ -23,28 +25,17 @@
"skills": [
{
"entities": [
- "entity.system.home"
+ "entity.system.home",
+ "flag.home.intent.from.system"
],
"actions": [
- "action.system.home"
+ "action.system.home",
+ "com.ohos.action.main",
+ "action.form.publish",
]
}
]
}
- ],
- "extensionAbilities": [
- {
- "name": "EntryBackupAbility",
- "srcEntry": "./ets/entrybackupability/EntryBackupAbility.ets",
- "type": "backup",
- "exported": false,
- "metadata": [
- {
- "name": "ohos.extension.backup",
- "resource": "$profile:backup_config"
- }
- ]
- }
]
}
}
\ No newline at end of file -
获取应用的 fingerprint
提高 hilog 打印等级并关闭隐私
hilog -b D
hilog -p off
hilog | grep fingerprint > /mnt/1.txt
尝试安装 hap,可以在 hilog 中检索到 fingerprint
hdc file send your_launcher.hap /mnt/Launcher.hap
hdc shell bm install -p /mnt/Launcher.hap
- 更新
install_list_capability.json
将新的 fingerprint 拷贝到 install_list_capability.json
中 launcher 对应的位置,并更新到 /system/etc/app/install_list_capability.json
hdc file send D:\_Resource\oh\install_list_capability.json /mnt/
hdc shell mount -o rw,remount /
hdc shell cp /mnt/install_list_capability.json /system/etc/app/install_list_capability.json
- 删除
launcher_settings.hap
删除 /system/hap/com.ohos.launcher/launcher_settings.hap
hdc shell rm /system/hap/com.ohos.launcher/launcher_settings.hap
-
安装应用
hdc file send your_launcher.hap /mnt/Launcher.hap
hdc shell mount -o rw,remount /
hdc shell cp /mnt/Launcher.hap /system/app/com.ohos.launcher/Launcher.hap
hdc shell rm -rf /data/* -
reboot
hdc shell reboot
2.5. 锁屏
2.5.1. 去掉锁屏
- 在
applications/standard/hap/BUILD.gn
文件中去除锁屏应用相关的代码,如下:
diff --git a/BUILD.gn b/BUILD.gn
index e213683..7382b97 100755
--- a/BUILD.gn
+++ b/BUILD.gn
@@ -463,7 +463,6 @@ group("hap") {
"//applications/standard/hap:note_hap",
"//applications/standard/hap:notificationManagement_hap",
"//applications/standard/hap:photos_hap",
- "//applications/standard/hap:screenLock_hap",
"//applications/standard/hap:screen_shot_hap",
"//applications/standard/hap:settingsData_hap",
"//applications/standard/hap:settings_faceauth_hap",
@@ -518,7 +517,6 @@ group("hap") {
"//applications/standard/hap:navigationBar_hap",
"//applications/standard/hap:notificationManagement_hap",
"//applications/standard/hap:photos_hap",
- "//applications/standard/hap:screenLock_hap",
"//applications/standard/hap:screen_shot_hap",
"//applications/standard/hap:settingsData_hap",
"//applications/standard/hap:settings_faceauth_hap",
- 在
foundation/systemabilitymgr/safwk/etc/profile/foundation.cfg
文件中去除开机时对锁屏应用状态的检测,如下:
diff --git a/etc/profile/foundation.cfg b/etc/profile/foundation.cfg
index f2573fa..1a21510 100644
--- a/etc/profile/foundation.cfg
+++ b/etc/profile/foundation.cfg
@@ -25,7 +25,6 @@
"name" : "services:restartfoundation",
"cmds" : [
"unset_bootevent bootevent.appfwk.ready",
- "unset_bootevent bootevent.lockscreen.ready",
"unset_bootevent bootevent.launcher.ready",
"reset appspawn",
"reset accountmgr",
@@ -141,7 +140,6 @@
"bootevents": [
"bootevent.wms.fullscreen.ready",
"bootevent.appfwk.ready",
- "bootevent.lockscreen.ready",
"bootevent.launcher.ready",
"bootevent.wms.ready"
],
- 去除窗口控制器对锁屏信号的响应;因为这里我们只是去掉了锁屏应用,但触发锁屏的机制还在,比如说按键触发和遥控器触发,只是没有实际的响应,如果不去掉,当再触发进入锁屏的机制,可能会出现应用界面冻结,修改在
foundation/window/window_manager/wmserver/src/window_controller.cpp
文件,如下:
diff --git a/wmserver/src/window_controller.cpp b/wmserver/src/window_controller.cpp
index 32c6a60ec..98df12ffc 100644
--- a/wmserver/src/window_controller.cpp
+++ b/wmserver/src/window_controller.cpp
@@ -783,8 +783,8 @@ void WindowController::NotifyDisplayStateChange(DisplayId defaultDisplayId, sptr
WLOGFD("NotifyDisplayStateChange start: %{public}u", type);
switch (type) {
case DisplayStateChangeType::BEFORE_SUSPEND: {
- isScreenLocked_ = true;
- windowRoot_->ProcessWindowStateChange(WindowState::STATE_FROZEN, WindowStateChangeReason::KEYGUARD);
+ //isScreenLocked_ = true;
+ //windowRoot_->ProcessWindowStateChange(WindowState::STATE_FROZEN, WindowStateChangeReason::KEYGUARD);
break;
}
case DisplayStateChangeType::BEFORE_UNLOCK: {
- 副作用:无下拉菜单
2.6. USB 通信定制
2.6.1. 使用 USB DDK 通信
- 使用 Deveco Studio 创建 Native C++ 工程
- 在 entry/build-profile.json5 添加 riscv64 适配
{
"apiType": "stageMode",
"buildOption": {
"externalNativeOptions": {
"path": "./src/main/cpp/CMakeLists.txt",
"arguments": "",
"abiFilters": [
"riscv64"
],
"cppFlags": "",
}
},
"buildOptionSet": [
{
"name": "release",
"arkOptions": {
"obfuscation": {
"ruleOptions": {
"enable": false,
"files": [
"./obfuscation-rules.txt"
]
}
}
},
"nativeLib": {
"debugSymbol": {
"strip": true,
"exclude": []
}
}
},
],
"targets": [
{
"name": "default"
},
{
"name": "ohosTest",
}
]
}
- 在 entry/src/main/module.json5 申请权限:
...
"requestPermissions": [
{
"name": "ohos.permission.ACCESS_DDK_USB"
}
]
...
- 链接动态库
修改 entry/src/main/cpp/CMakeLists.txt 添加相关 lib:
target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so libusb_ndk.z.so)
- entry/src/main/cpp/napi_init.cpp 中添加 USB 读写逻辑:
#include "napi/native_api.h"
#include <usb/usb_ddk_api.h>
#include <usb/usb_ddk_types.h>
#include <hilog/log.h>
uint64_t interfaceHandle = 0;
struct UsbDeviceMemMap *devMmap = nullptr;
static napi_value UsbInit(napi_env env, napi_callback_info info)
{
napi_value result;
// 初始化USB DDK
OH_Usb_Init();
struct UsbDeviceDescriptor devDesc;
uint64_t deviceId = 0x0000000200000002; //对应耳机usb节点:/dev/bus/usb/001/003 001对应高八位 004对应第八位
// 获取设备描述符
OH_Usb_GetDeviceDescriptor(deviceId, &devDesc);
struct UsbDdkConfigDescriptor *config = nullptr;
// 获取配置描述符
OH_Usb_GetConfigDescriptor(deviceId, 1, &config);
// 根据配置描述符,找到所需要通信的interfaceIndex
uint8_t interfaceIndex = 0;
// 声明接口
int ret = OH_Usb_ClaimInterface(deviceId, interfaceIndex, &interfaceHandle);
// 释放配置描述符
OH_Usb_FreeConfigDescriptor(config);
napi_create_int32(env, ret, &result);
return result;
}
static napi_value UsbSend(napi_env env, napi_callback_info info)
{
napi_value result;
// 超时时间,设置为1s;
uint32_t timeout = 1000;
//获取deviceid、devicekey
struct UsbControlRequestSetup setupWrite1;
setupWrite1.bmRequestType = 0x40;
setupWrite1.bRequest = 0x09;
setupWrite1.wValue = 0x200;
setupWrite1.wIndex = 0x4;
setupWrite1.wLength = 0x10;
uint8_t dataWrite1[10] = {0xA5,0x5A,0xFA,0x02,0x02,0x00,0x16};
uint32_t dataWriteLen1 = 10;
// 发送控制写请求
OH_Usb_SendControlWriteRequest(interfaceHandle, &setupWrite1, timeout, dataWrite1, dataWriteLen1);
struct UsbControlRequestSetup setupRead;
setupRead.bmRequestType = 0xC0;
setupRead.bRequest = 0x01;
setupRead.wValue = 0x101;
setupRead.wIndex = 0x4;
setupRead.wLength = 0x100;
uint8_t dataRead[256] = {};
uint32_t dataReadLen = 256;
// 发送控制读请求
int ret = OH_Usb_SendControlReadRequest(interfaceHandle, &setupRead, timeout, dataRead, &dataReadLen);
for(int i = 0; i < 10; i++){
OH_LOG_Print(_LOG_APP_, _LOG_ERROR_, 0xff, "usb-ddk", "data read:%{public}x", dataRead[i]);
}
napi_create_int32(env, ret, &result);
return result;
}
static napi_value UsbDestroy(napi_env env, napi_callback_info info)
{
napi_value result;
// 销毁缓冲区
// 释放接口
int ret = OH_Usb_ReleaseInterface(interfaceHandle);
// 释放USB DDK
OH_Usb_Release();
napi_create_int32(env, ret, &result);
return result;
}
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{ "usbInit", nullptr, UsbInit, nullptr, nullptr, nullptr, _napi_default_, nullptr },
{ "usbDestroy", nullptr, UsbDestroy, nullptr, nullptr, nullptr, _napi_default_, nullptr },
{ "usbSend", nullptr, UsbSend, nullptr, nullptr, nullptr, _napi_default_, nullptr }
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
static napi_module demoModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "entry",
.nm_priv = ((void*)0),
.reserved = { 0 },
};
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
napi_module_register(&demoModule);
}
- entry/src/main/cpp/types/libentry/Index.d.ts 中添加声明:
**export const **usbInit: () => number;
**export **const usbDestroy: () => number;
export const usbSend: () => number;
UI 中调用:
**import **testNapi **from **'libentry.so';
@Entry
@Component
**struct **Index {
@State message: string = 'Control Red Led';
build() {
Row() {
Column() {
Text(**this**.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
testNapi.usbInit(); //传入资源对象,以及访问的rawfile文件夹名称
testNapi.usbSend();
testNapi.usbDestroy();
})
}
.width('100%')
}
.height('100%')
}
}
2.6.2. 使用 HID DDK 通信
由于 OH5.0 版本 hid ddk 的功能实现尚未完全,可通过直接读写 hidraw 节点实现通信。
- 内核打开 hidraw 配置(kernel\linux\spacemit_kernel-6.6\arch\riscv\configs\k1_defconfig)
CONFIG_HIDRAW=y
- 修改 hidraw 节点读写权限(base\startup\init\ueventd\etc\ueventd.config)
/dev/bus/usb/* 0666 0 0
- 使用 Deveco Studio 创建 Native C++ 工程
- 在 entry/build-profile.json5 添加 riscv64 适配
{
"apiType": "stageMode",
"buildOption": {
"externalNativeOptions": {
"path": "./src/main/cpp/CMakeLists.txt",
"arguments": "",
"abiFilters": [
"riscv64"
],
"cppFlags": "",
}
},
"buildOptionSet": [
{
"name": "release",
"arkOptions": {
"obfuscation": {
"ruleOptions": {
"enable": false,
"files": [
"./obfuscation-rules.txt"
]
}
}
},
"nativeLib": {
"debugSymbol": {
"strip": true,
"exclude": []
}
}
},
],
"targets": [
{
"name": "default"
},
{
"name": "ohosTest",
}
]
}
- 链接动态库
修改 entry/src/main/cpp/CMakeLists.txt 添加相关 lib:
target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so)
- entry/src/main/cpp/napi_init.cpp 中添加 HID 节点读写逻辑,写数据示例如下:
#include "napi/native_api.h"
#include <hilog/log.h>
#include <iostream>
#include <fcntl.h>
#include <unistd.h>
#include <cstdint>
#include <cerrno>
static napi_value HidTest(napi_env env, napi_callback_info info)
{
napi_value result;
const uint8_t hid_data[] = {
0x2E, 0xAA, 0xEC, 0x6B, 0x00, 0x07, 0xA2, 0xA4,
0x43, 0xA5, 0xA5, 0xC1, 0x5A, 0xF6, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
};
const size_t data_len = sizeof(hid_data);
int fd = open("/dev/hidraw1", O_WRONLY);
if (fd == -1) {
OH_LOG_Print(_LOG_APP_, _LOG_ERROR_, 0xff, "hid-ddk", "open hidraw error");
}
ssize_t write_result = write(fd, hid_data, data_len);
if (write_result == -1) {
OH_LOG_Print(_LOG_APP_, _LOG_ERROR_, 0xff, "hid-ddk", "write error:%{public}s",std::strerror(errno));
}
if (write_result != static_cast<ssize_t>(data_len)) {
OH_LOG_Print(_LOG_APP_, _LOG_ERROR_, 0xff, "hid-ddk", "only write:%{public}zu",data_len);
} else {
OH_LOG_Print(_LOG_APP_, _LOG_ERROR_, 0xff, "hid-ddk", "write success:%{public}zu",write_result);
}
close(fd);
fd = -1;
napi_create_uint32(env, write_result, &result);
return result;
}
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{ "hidTest", nullptr, HidTest, nullptr, nullptr, nullptr, _napi_default_, nullptr },
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
static napi_module demoModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "entry",
.nm_priv = ((void*)0),
.reserved = { 0 },
};
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
napi_module_register(&demoModule);
}
- entry/src/main/cpp/types/libentry/Index.d.ts 中添加声明:
**export const hidTest: () => number;**
- UI 中调用:
**import **testNapi **from **'libentry.so';
@Entry
@Component
**struct **Index {
@State message: string = 'Control Red Led';
build() {
Row() {
Column() {
Text(**this**.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
testNapi.hidTest();
})
}
.width('100%')
}
.height('100%')
}
}
3. 系统定制
3.1. 添加系统属性
3.1.1. 固定值系统属性
在 vendor/spacemit/xxx/etc/param/product_xxx.para
中添加即可,如下:
const.product.name="MUSEPAPER"
const.product.manufacturer="SPACEMIT"
const.product.brand="MUSEPAPER"
const.software.model="1.0.0.1"
const.product.hardwareversion="1.0.0.0"
const.product.software.version="1.0.0.1"
const.product.incremental.version="1.0.0.0"
const.build.product="MUSEPAPER"
添加的属性可以是已经存在的系统属性,这里进行覆盖,也可以是新添加的自定义名称的属性。
3.1.2. 读取值系统属性
读取值系统属性不是固定值,是需要在开机阶段通过读取节点等方式动态获取并写入到属性中的,添加逻辑和固定值系统属性不同。
主要在 base/startup/init/services/init/standard/init.c
中进行添加,代码中已经添加了获取 CPU 型号和 MEM 大小的例子,以获取内存大小为例说明:
- 添加通过节点读取信息的接口
void get_memory_size(char *buffer) {
FILE *fp = fopen("/proc/meminfo", "r");
if (!fp) {
perror("Could not open /proc/meminfo");
return;
}
char line[BUFFER_SIZE];
while (fgets(line, sizeof(line), fp)) {
if (strstr(line, "MemTotal")) {
char *colon = strchr(line, ':');
if (colon) {
unsigned long mem_kb;
sscanf(colon + 1, "%lu", &mem_kb);
float mem_gb = mem_kb / (1024.0 * 1024.0);
snprintf(buffer, BUFFER_SIZE, "%d GB", closest_value(mem_gb));
break;
}
}
}
fclose(fp);
}
- 在 RegisteSystemParameter 中调用接口写入属性
void RegisteSystemParameter(void){
...
char memory_size[BUFFER_SIZE] = "Unknown";
...
get_memory_size(memory_size);
...
i = SystemWriteParameter("const.product.mem", memory_size);
INIT_LOGI("const.product.mem = %s, ret = %d", memory_size, i);
}
3.2. 电源管理定制
主要修改 vendor/spacemit/xxx/power_config/power_mode_config.xml
,如下:
<!--
Power Mode Definitions:
MODE_NORMAL = 600,
MODE_POWER_SAVE = 601,
MODE_PERFORMANCE = 602,
MODE_EXTREME_POWER_SAVE = 603,
-->
<!--
Action Definitions:
DisplayOffTime = 101,
SystemAutoSleepTime = 102,
AutoAdjustBrightness = 103,
AutoWindowRotation = 107,
SystemBrightness = 115,
VibratorsState = 120,
-->
<switch_proxy version="1">
<proxy id="600">
<switch id="101" value="300000" recover_flag="0"/>
<switch id="102" value="0" recover_flag="0"/>
<switch id="103" value="-1" recover_flag="0"/>
<switch id="107" value="1" recover_flag="0"/>
<switch id="115" value="76" recover_flag="0"/>
<switch id="120" value="1" recover_flag="0"/>
</proxy>
<proxy id="601">
<switch id="101" value="10000" recover_flag="0"/>
<switch id="102" value="5000" recover_flag="0"/>
<switch id="103" value="-1" recover_flag="0"/>
<switch id="107" value="-1" recover_flag="0"/>
<switch id="115" value="50" recover_flag="0"/>
<switch id="120" value="-1" recover_flag="0"/>
</proxy>
<proxy id="602">
<switch id="101" value="-1" recover_flag="0"/>
<switch id="102" value="-1" recover_flag="0"/>
<switch id="103" value="-1" recover_flag="0"/>
<switch id="107" value="1" recover_flag="0"/>
<switch id="115" value="255" recover_flag="0"/>
<switch id="120" value="1" recover_flag="0"/>
</proxy>
<proxy id="603">
<switch id="101" value="5000" recover_flag="0"/>
<switch id="102" value="1000" recover_flag="0"/>
<switch id="103" value="-1" recover_flag="0"/>
<switch id="107" value="-1" recover_flag="0"/>
<switch id="115" value="25" recover_flag="0"/>
<switch id="120" value="-1" recover_flag="0"/>
</proxy>
</switch_proxy>
该文件主要定义了几种电源管理模式,包括正常/省电/性能/超级省电等,以及对应管理模式的参数,包括关屏时间,待机时间等。
3.2.1. 设置不关屏休眠
默认系统是在 MODE_NORMAL 模式,可以通过命令切换到其他模式,比如不想让系统进入休眠,可以通过命令切换到性能模式,如下:
power-shell setmode 602
3.2.2. 设置关屏时间
关屏时间主要通过 DisplayOffTime(101)
来修改,单位为 毫秒(ms)
,举例如下:
<switch id="101" value="300000" recover_flag="0"/>
//300000 表示开机后,3分钟后关屏
<switch id="101" value="-1" recover_flag="0"/>
//-1 表示永不关屏
3.2.3. 设置深度休眠时间
深度休眠时间主要通过 SystemAutoSleepTime(102)
来修改,单位为 毫秒(ms)
,举例如下:
<switch id="102" value="0" recover_flag="0"/>
//0 表示关屏后马上休眠
<switch id="102" value="5000" recover_flag="0"/>
//5000 表示关屏5s后,进入休眠
<switch id="102" value="-1" recover_flag="0"/>
//-1 表示只关屏,不休眠
3.3. 窗口管理定制
主要修改 vendor/spacemit/musepaper2/window_config
路径下的 display_manager_config.xml
和 window_manager_config.xml
3.3.1. display_manager_config.xml
<Configs>
<!--Window display dpi, valid range is 80~640, use 0 if no configuration is requeired-->
<dpi>240</dpi>
<!-- Indicate the deviation between the default device display direction and the direction -->
<!-- of the sensor. Use 0 in default, available values are {0, 90, 180, 270} -->
<defaultDeviceRotationOffset>0</defaultDeviceRotationOffset>
<!-- Svg path for cutout, use empty string if there is not cutout on the screen -->
<!-- format: string -->
<!-- default value: empty string -->
<!-- sample: M 100,100 m -75,0 a 75,75 0 1,0 150,0 a 75,75 0 1,0 -150,0 z -->
<defaultDisplayCutoutPath></defaultDisplayCutoutPath>
<!-- Indicates the boundary of the curved screen, each value corresponds to the px from each edge -->
<!-- format: number(left) number(top) number(right) number(bottom) -->
<!-- default value: 0 0 0 0 -->
<!-- sample: 150 150 0 0 -->
<curvedScreenBoundary>0 0 0 0</curvedScreenBoundary>
<!-- Indicates whether the built-in display is a waterfall display -->
<!-- format: boolean -->
<!-- default value: false -->
<!-- sample: false -->
<isWaterfallDisplay enable="false"></isWaterfallDisplay>
<!-- Indicate whether to enable display area compression for waterfall display when displayed in landscape -->
<!-- or landscape_inverted mode. -->
<!-- This configuration item takes effect only when isWaterfallDisplay above is true -->
<!-- format: boolean -->
<!-- default value: false -->
<isWaterfallAreaCompressionEnableWhenHorizontal enable="false"></isWaterfallAreaCompressionEnableWhenHorizontal>
<!-- Indicate the size of both sides of the waterfall display which to be compressed when displayed in landscape -->
<!-- or landscape_inverted mode. -->
<!-- This configuration item takes effect only when isWaterfallDisplay above is true -->
<!-- format: uint32_t, the unit is vp. -->
<!-- default value: 0 -->
<waterfallAreaCompressionSizeWhenHorzontal>0</waterfallAreaCompressionSizeWhenHorzontal>
<!-- Indicates orientation of the built-in screen -->
<!-- 0: Orientation::UNSPECIFIED -->
<!-- 1: Orientation::VERTICAL 2: Orientation::HORIZONTAL-->
<!-- 3: Orientation::REVERSE_VERTICAL 4: Orientation::REVERSE_HORIZONTAL -->
<buildInDefaultOrientation>0</buildInDefaultOrientation>
</Configs>
主要修改的配置为:
- dpi:像素密度,dpi 越大图标越小
- buildInDefaultOrientation:桌面旋转角度配置
3.3.2. window_manager_config.xml
主要用于配置窗口动画,效果等,修改不多
3.4. 网络管理定制
3.4.1. wifi 定制
3.4.1.1. 驱动调试
该调试功能主要由进迭进行,确保驱动层功能正常,并能够编译出 ko。
3.4.1.2. 拷贝 ko(以 rtl8852bs 为例)
在 device/board/spacemit/xxx/kernel
的 build_kernel.sh
中进行拷贝,如下:
function cp_ko(){
# cp ko to userspace
cp ${KERNEL_BUILD_ROOT}/drivers/usb/typec/typec.ko ${OHOS_SOURCE_ROOT}/device/board/${DEVICE_BOARD}/${DEVICE_NAME}/kernel/ko
cp ${KERNEL_BUILD_ROOT}/drivers/usb/typec/husb239.ko ${OHOS_SOURCE_ROOT}/device/board/${DEVICE_BOARD}/${DEVICE_NAME}/kernel/ko
cp ${KERNEL_BUILD_ROOT}/drivers/net/wireless/realtek/rtl8852be/8852be.ko ${OHOS_SOURCE_ROOT}/device/board/${DEVICE_BOARD}/${DEVICE_NAME}/kernel/ko
cp ${KERNEL_BUILD_ROOT}/drivers/net/wireless/realtek/rtl8852bs/8852bs.ko ${OHOS_SOURCE_ROOT}/device/board/${DEVICE_BOARD}/${DEVICE_NAME}/kernel/ko
}
在编译完内核后,将内核编译目录下的 ko 拷贝到 OpenHarmony 系统的目录下,在编译 OpenHarmony 的时候,会将这些 ko 拷贝到 vendor 分区并进行打包。
3.4.1.3. 加载 ko(以 8852bs 为例)
在 device/board/spacemit/xxx/cfg
的 init.xxx.cfg
中进行 ko 的加载,如下:
{
"name" : "fs",
"cmds" : [
"insmod /vendor/modules/8852bs.ko ifname=wlan0 if2name=p2p0",
"insmod /vendor/modules/typec.ko",
"insmod /vendor/modules/husb239.ko"
]
},
开机后,会在 init 进程中,加载这些 ko,通过 lsmod 命令查看是否加载成功,如下:
# lsmod
Module Size Used by
husb239 110592 0
typec 323584 1 husb239
8852bs 10031104 0
3.4.2. BT 定制
待添加
3.4.3. 4G 定制
待添加
3.5. 多媒体系统定制
3.5.1. 音频通路定制
在 vendor\spacemit\xxx\hals\audio\alsa_adapter.json
添加声卡信息。
{
"adapters": [
{
"name": "primary",
"cardId": 0,
"cardName": "sndes8326"
},
{
"name": "usb",
"cardId": 1,
"cardName": "C"
}
]
}
在 vendor\spacemit\xxx\hals\audio\config\riscv64\audio_policy_config.xml
配置不同声卡的音频属性,包括播放、录制下的采样率、通道数、buffer 大小等。
<adapter name="primary" supportSelectScene="0">
<pipes>
<pipe name="primary_output" role="output">
<paProp lib="libmodule-hdi-sink.z.so" role="sink" fixed_latency="1" render_in_idle_state="1" moduleName="Speaker"/>
<streamProps>
<streamProp format="s16le" sampleRates="48000" channelLayout="CH_LAYOUT_STEREO" bufferSize="4096"/>
</streamProps>
<attributes>
<attribute name="preload" value="true"/>
</attributes>
</pipe>
<pipe name="primary_input" role="input">
<paProp lib="libmodule-hdi-source.z.so" role="source" moduleName="Built_in_mic"/>
<streamProps>
<streamProp format="s16le" sampleRates="48000" channelLayout="CH_LAYOUT_STEREO" bufferSize="4096"/>
</streamProps>
</pipe>
</pipes>
<devices>
<device name="Speaker_Out" type="DEVICE_TYPE_SPEAKER" pin="PIN_OUT_SPEAKER" role="output" supportPipes="primary_output"/>
<device name="Wired_Headset_Out" type="DEVICE_TYPE_WIRED_HEADSET" pin="PIN_OUT_HEADSET" role="output" supportPipes="primary_output"/>
<device name="Wired_Headphones_Out" type="DEVICE_TYPE_WIRED_HEADPHONES" pin="PIN_OUT_HEADPHONE" role="output" supportPipes="primary_output"/>
<device name="Builtin_Mic_In" type="DEVICE_TYPE_MIC" pin="PIN_IN_MIC" role="input" supportPipes="primary_input"/>
<device name="Wired_Headset_In" type="DEVICE_TYPE_WIRED_HEADSET" pin="PIN_IN_HS_MIC" role="input" supportPipes="primary_input"/>
</devices>
</adapter>
<adapter name="usb">
<pipes>
<pipe name="usb_output" role="output">
<paProp lib="libmodule-hdi-sink.z.so" role="sink" fixed_latency="1" render_in_idle_state="1" moduleName="Usb_arm_speaker"/>
<streamProps>
<streamProp format="s16le" sampleRates="48000" channelLayout="CH_LAYOUT_STEREO" bufferSize="4096"/>
</streamProps>
<attributes>
<attribute name="preload" value="true"/>
</attributes>
</pipe>
<pipe name="usb_input" role="input">
<paProp lib="libmodule-hdi-source.z.so" role="source" moduleName="Usb_arm_mic"/>
<streamProps>
<streamProp format="s16le" sampleRates="48000" channelLayout="CH_LAYOUT_STEREO" bufferSize="19200"/>
</streamProps>
</pipe>
</pipes>
<devices>
<device name="Usb_Headset_Out" type="DEVICE_TYPE_USB_HEADSET" pin="PIN_OUT_USB_HEADSET" role="output" supportPipes="usb_output"/>
<device name="Usb_Headset_In" type="DEVICE_TYPE_USB_HEADSET" pin="PIN_IN_USB_HEADSET" role="input" supportPipes="usb_input"/>
</devices>
</adapter>
3.5.2. camera 通路定制(mipi)
完成 camera 通路的适配,包括以下三个步骤:
- 确保 camera 底层驱动正常,保证
cam-test
的 demo 正常出图 - 确保
svivi
虚拟摄像头驱动正常,保证v4l2_test_spacemit
正常出图 - 适配 camera 到 OH 框架
下面分 3 个小结进行详细说明:
3.5.2.1. 确保 camera 底层驱动正常
- cam-test 应用点亮一款 OH 已支持的摄像头,只需两步
第一步:
确定摄像头是接在开发板的哪个 MIPI CSI 接口上,假如是接在了 MIPI CSI1
硬件接口,则运行以下命令探测摄像头
cam-test /system/profile/csi1_camera_detect.json
(如果摄像头是接在了 MIPI CSI2
硬件接口则使用 csi2_camera_detect.json
)
运行结果如下 :
......
I: ./sensors/cam_sensors_module.c(235): "detect ov16a10_spm sensors in csi1: success, set 3840x2160 to 1920x1080"
I: auto_detect_camera(1401): "auto detect sensor ===================== finish "
I: update_json_file(672): "save json to /data/csi1_camera_auto.json success"
cam-test 将会自动探测 mipi csi1
上已支持的摄像头 id,如果成功探测到将生成可用的 json 文件到/data/目录,该 json 文件将在后面的步骤中使用到。如果没有探测到,说明没有支持此摄像头,或者硬件有问题,或者软件配置不正确,此情况下建议请求 进迭工程师
提供支持。
从上述运行 log 还可以得出,ov16a10 sensor
生成的 json 默认使用模式 0,sensor 输出分辨率为 3840x2160
,isp 输出分辨率为 1920x1080
。json 配置文件的更多描述,请参阅《camera 快速启动指南》的 JSON 参数说明章节。
第二步:
运行下列命令,使用自动生成的 json 配置文件,启动摄像头出图 500 帧,并保存第 250 帧。
cam-test /data/csi1_camera_auto.json
如果观察到下列打印,则表明摄像头开流有后数据输出。该第一大步骤完成。
I: cpp_client_receive_mctf_buffers(1833): "CPP0: frameid 1, fps 30.0"
如果运行失败,建议请求 进迭工程师
提供支持。请提供 cam-test 测试 log 文件,dmesg 内核打印文件,以及测试情况说明。
- cam-test 应用点亮一款 OH 未支持的新摄像头
请参阅《camera 快速启动指南》快速点亮导览中的 情况二,和文档有差别的地方是 cam-test
源码路径变更为
device/soc/spacemit/k1/hardware/camera
其余基本相同,此处不再赘述。
3.5.2.2. 确保 svivi 虚拟摄像头驱动正常
经过第一步骤,已经可以确定 camera 的软硬件是正常可用的,接下来需要跑通 svivi 虚拟摄像头驱动,为后面 camera 摄像头适配 OH 做好准备工作。
首先,需要按照以下步骤简单调整前面生成的 json 配置:
- 新增 use_v4l:1 字段,切换 cam-test 处于 v4l2 功能模式
{
"tuning_server_enable":1,
"show_fps":1,
"auto_run": 0,
//新增 "use_v4l":1,
"use_v4l":1,
......
}
- 如果该摄像头是后摄,则重命名该文件为
svivi_cam1.json
;如果该摄像头是前摄,则重命名该文件为svivi_cam2.json
,并放置到/system/profile/
目录。 - 使用
v4l2_test_spacemit
执行下列命令测试 svivi 虚拟摄像头驱动。
如果使用的摄像头是后摄,则操作 /dev/video23
,执行的命令如下:
v4l2_test_spacemit --device /dev/video23 --set-fmt-video width=1920,height=1080,pixelformat=NV12 --verbose --stream-dmabuf --stream-loop --stream-save 10 --stream-to=/data/test.yuv
如果使用的摄像头是前摄,则操作 /dev/video24
,执行的命令如下:
v4l2_test_spacemit --device /dev/video24 --set-fmt-video width=1920,height=1080,pixelformat=NV12 --verbose --stream-dmabuf --stream-loop --stream-save 10 --stream-to=/data/test.yuv
测试正常的输出 log 如下:
#v4l2_test_spacemit --device /dev/video24 --set-fmt-video width=1920,height=1080,pixelformat=NV12 --verbose --stream-dmabuf --stream-loop --stream-save 10 --stream-to=test.yuv
stream_save:10
main:847 [WARN]can't get codec type
VIDIOC_G_FMT: ok, type:9
VIDIOC_S_FMT: ok, type:9
Format Video Capture Multiplanar:
Width/Height : 1920/1080
Pixel Format : 'NV12' (Y/UV 4:2:0)
Field : None
Number of planes : 1
Colorspace : sRGB
Plane 0 :
Bytes per Line : 1920
Size Image : 2073600
start buffer preprocessing
VIDIOC_REQBUFS: ok, type:9, count:4
VIDIOC_QUERYBUF: ok, type:9
Index : 0
Type : V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE
Flags : 0
Field : 1
Sequence : 0
Length : 1
Bytesused: 0
Timestamp: 0.000000s
Plane : 0
Length : 3110400
Bytesused : 3110400
Data Offset: 0
VIDIOC_QBUF: ok, type:9
VIDIOC_QUERYBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
VIDIOC_QUERYBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
VIDIOC_QUERYBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
start buffer queue
start to VIDIOC_STREAMON
VIDIOC_STREAMON: ok, type:9
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 0 p:0x3f3b2c8000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 1
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 1 p:0x3f3afd0000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 2
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 2 p:0x3f3acd8000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 3
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 3 p:0x3f3a9e0000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 4
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 0 p:0x3f3b2c8000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 5
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 1 p:0x3f3afd0000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 6
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 2 p:0x3f3acd8000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 7
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 3 p:0x3f3a9e0000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 8
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 0 p:0x3f3b2c8000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 9
start select.
VIDIOC_DQBUF: ok, type:9
write_buffer_to_file:661 [INFO]capture w2f: 1 1 p:0x3f3afd0000 0, 3110400
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 10
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 11
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 12
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 13
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 14
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 15
start select.
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 16
start select.
handle_sig
VIDIOC_DQBUF: ok, type:9
VIDIOC_QBUF: ok, type:9
do_handle_cap:736 [INFO]m2m capture dequeue----------------: 17
start to VIDIOC_STREAMOFF
VIDIOC_STREAMOFF: ok, type:9
exit v4l2_main!
#
注意:分辨率最高仅能输出 1080p
,且格式只能为 NV12
。如果测试失败,请提供 /data/svivi_cam1.log
或 /data/svivi_cam2.log
测试 log 文件,dmesg 内核打印文件,以及测试情况说明。
3.5.2.3. 适配 camera 到 OH 框架
- 参考标案 device/board/spacemit/musepaper2/camera/代码,移植代码到对应的方案目录
device/board/spacemit``/xxx/``camera/
下 - 需要确保
device/board/spacemit``/xxx/``camera/vdi_impl/v4l2/svivi_cam1.json
和svivi_cam2.json
用的是前面步骤调试好的 json 文件 - 编译烧写固件,启动系统,打开相机,观察图像输出是否正常。如果测试失败,请提供
/data/svivi_cam1.log
或/data/svivi_cam2.log
测试 log 文件,dmesg 内核打印文件,hilog 测试 log 文件,以及测试情况说明
3.5.3. Usb camera 通路定制
Usb camera 通路支持通过修改 vendor/spacemit/xxx/hdf_config/uhdf/camera/hdi_impl/``camera_host_config.hcs
配置文件,实现以下各种应用场景的灵活定制 (最大支持2路)
:
- 双 USB 摄像头切换预览场景
- 双 MIPI 摄像头切换预览场景
- 单 USB 摄像头 + 单 MIPI 摄像头预览场景
- 单 USB 摄像头预览场景
- 单 MIPI 摄像头预览场景
要实现以上定制化功能,需要在 camera_host_config.hcs
中定义四个 ability 节点,每个节点都代表一个相机。只有当节点的 cameraPosition 属性设置为 OHOS_CAMERA_POSITION_BACK / OHOS_CAMERA_POSITION_FRONT
状态时,camera``的``hap
才会打开对应的位置的相机使用,而对于设置为 OHOS_CAMERA_POSITION_OTHER
状态的节点将被忽略,不起效果。
在 camera_host_config.hcs
中,ability_01
和 ability_02
分别对应第一个、第二个 mipi 摄像头;ability_03
和 ability_04
分别对应第一个、第二个 usb 摄像头。目前,最多只能支持两个相机切换使用。
当拔掉 usb 相机后,要先退出相机应用再重新打开使用。并确保重新打开相机时候,使用到的 USB/MIPI 摄像头仍插着,否则将导致相机应用黑屏!
上述功能已经在 smt001
方案进行验证,在支持新方案时可以作为参考。下面将针对上面几种常用情况,分别举例进行说明: