OpenHarmony L1（3.0）串口功能开发

作者：软通动力HOS 2023-02-28 15:49:09系统 OpenHarmony 本文介绍了在OpenHarmony 3.0 LTS系统上重串口功能实现到应用开发的串口整套流程。简单的串口API接口开发，可直接依赖系统模块。串口难点主要在轻量级系统开发，串口读者可参考开源鸿蒙中轻量级系统服务管理部件中的串口相关介绍进行开发。

​​想了解更多关于开源的串口内容，请访问：​​

​​51CTO 开源基础软件社区​​

​​https://ost.51cto.com​​

前言

OpenHarmony 3.0 LTS是串口面向全场景的开源分布式操作系统，能够在物联网上使用。串口可以支持三种系统类型，串口标准系统、串口轻量系统和小型系统。串口本文提供了在OpenHarmony 3.0 LTS实现串口调试功能的串口开发方案。

1、串口编写代码生成对应动态库文件

串口功能开发包括串口初始化、串口数据读写、串口修改数据开发格式等。具体代码不便展示。编写gn文件生成对应动态库文件。

shared_library("serial_service_api") {  sources = [ "service/serial_service.cpp" ] include_dirs = ["include","service", ]

2、提供API接口

（1）依赖router模块开发

如果串口权限不受限制，可以直接在router模块增加串口相关功能，节省开发时间。
foundation\ace\ace_engine_lite\frameworks\src\core\modules\router_module.cpp。

void InitRouterModule(JSIValue exports)
{ 
JSI::SetModuleAPI(exports, "replace", RouterModule::Replace);
JSI::SetModuleAPI(exports, "init", RouterModule::Init);
JSI::SetModuleAPI(exports, "format", RouterModule::Format);
JSI::SetModuleAPI(exports, "write", RouterModule::Write);
JSI::SetModuleAPI(exports, "read", RouterModule::ReadFormat);
JSI::SetModuleAPI(exports, "disable", RouterModule::Disable);
JSI::SetModuleAPI(exports, "on", RouterModule::OnRead);    
COMMUNICATION::SerialService::GetInstance()->SerialRead(RouterModule::ReadingCallback);

串口初始化及进制转换相关代码可直接调用库函数。串口读回调的相关代码如下：

void RouterModule::ReadingCallback(const char* buffer, int length)
{ 
if(!JSI::ValueIsUndefined(ReadCallback) && gSerialFlag){ 
if(length < 0){ 
SERIAL_LOGI("JS ReadingCallback == 0");
JSIValue evt = JSI::CreateString("error");
JSI::CallFunction(ReadCallback, JSI::CreateUndefined(), &evt, 1);
return;
} else if(length >= 0){ 
SERIAL_LOGI("JS ReadingCallback == 1");
JSIValue evt = JSI::CreateString(buffer);
JSI::CallFunction(ReadCallback, JSI::CreateUndefined(), &evt, 1);
}
}
}
JSIValue RouterModule::OnRead(const JSIValue thisVal, const JSIValue *args, uint8_t argsSize)
{ 
if(!JSI::ValueIsUndefined(ReadCallback)){ 
JSI::ReleaseValue(ReadCallback);
return JSI::CreateBoolean(false);
}
if (JSI::ValueIsUndefined(args[0])) { 
return JSI::CreateBoolean(false);
}
ReadCallback = JSI::GetNamedProperty(args[0], "ReadingCallback");
if(JSI::ValueIsUndefined(ReadCallback)){ 
SERIAL_LOGI("Read Callbk is not got it");
}
}

在route模块增加相关依赖。
foundation\ace\ace_engine_lite\frameworks\BUILD.gn。

"//device/hals/communication/serial_port:serial_service_api",
]

（2）轻量级服务开发

串口权限受限时，需要启用轻量级服务，应用可以通过服务，跨进程操作串口。具体配置如下：

foundation\ace\ace_engine_lite\frameworks\module_manager\ohos_module_config.hextern void InitSerialPortModule(JSIValue exports);const Module OHOS_MODULES[] = { { "serialport", InitSerialPortModule},}

配置服务自启动：

vendor/ingenic/halley5/rootfs-overlay/etc/init.d/S99WmsStart:sleep 1 && /bin/wifi_server &#! /bin/sh
sleep 1 && /bin/wms_server &
sleep 1 && /bin/wifi_server &
sleep 1 && /bin/util_server &
sleep 1 && /bin/serial_port_service &

配置服务：

FeaturePolicy serialServiceFeature[] = { 
{ 
NULL,
{ 
{ 
.type = RANGE,
.uidMin=0,
.uidMax=__INT_MAX__,
}
},
},
};
static PolicySetting g_presetPolicies[] = { 
{ "serialportservice", serialServiceFeature, 1},
};

代码实现服务初始化，具体实现可参考wifi_lite相关代码。在Invoke中去调用串口相关功能。
**\serial_port\serial_port_lite\service\samgr_serial_port_service.cpp。

struct SamgrSerialPortService { 
INHERIT_SERVICE;
INHERIT_IUNKNOWNENTRY(DefaultFeatureApi);
Identity identity;
};
static const char *GetName(Service *service)
{ 
//(void)service;
return SERIAL_PORT_SERVICE_NAME;
}
static int32 Invoke(IServerProxy *iProxy, int funcId, void *origin, IpcIo *req, IpcIo *reply)
{ 
SerialPortService::RequestHandle(funcId, origin, req, reply);
return EC_SUCCESS;
}
//创建服务对象：
static SamgrSerialPortService SerialPortSvc = { 
.GetName = GetName,
.Initialize = Initialize,
.MessageHandle = MessageHandle,
.GetTaskConfig = GetTaskConfig,
SERVER_IPROXY_IMPL_BEGIN,
.Invoke = Invoke,
IPROXY_END,
};
//向SAMGR注册服务及接口：
static void Init()
{  
SERIAL_LOGI("serial RegisterService Init, ver = %u", SerialPortSvc.ver);
bool ret = SAMGR_GetInstance()->RegisterService((Service *)&SerialPortSvc);
if (!ret) { 
SERIAL_LOGI("RegisterService error");
return;
}
ret = SAMGR_GetInstance()->RegisterDefaultFeatureApi(SERIAL_PORT_SERVICE_NAME, GET_IUNKNOWN(SerialPortSvc));
if (!ret) { 
SERIAL_LOGI("RegisterDefaultFeatureApi error");
return;
}
SERIAL_LOGI("serial RegisterService out, ver = %u", SerialPortSvc.ver);
}
SYSEX_SERVICE_INIT(Init);

3、开发应用

（1）签名配置

使用 DevEco Studio 3.0.0.800 软件进行应用开发，真机设备运行和调试OpenHarmony应用前，需要对应用进行签名才能正常运行。主要分为四个步骤：生成密钥和证书请求文件，生成应用证书文件，生成应用profile文件，配置应用签名信息。

（2）调试命令

adb push entry-release-lite-signed.hap /userdata
adb shell
alias ls=‘ls --color=never’ //解决ls乱码
bm uninstall -n com.ingenic.curtain
bm install -p entry-release-lite-signed.hap

总结

本文介绍了在OpenHarmony 3.0 LTS系统上重串口功能实现到应用开发的整套流程。简单的API接口开发，可直接依赖系统模块。难点主要在轻量级系统开发，读者可参考开源鸿蒙中轻量级系统服务管理部件中的相关介绍进行开发。

​​想了解更多关于开源的内容，请访问：​​

​​51CTO 开源基础软件社区​​

​​https://ost.51cto.com​​

责任编辑：jianghua 来源： 51CTO 开源基础软件社区 鸿蒙应用开发

(责任编辑：焦点)