#创作者激励#OpenHarmony L1（3.0）串口功能开发原创

软通动力HOS

发布于 2023-2-27 10:33

浏览

4收藏

【本文正在参加2023年第一期优质创作者激励计划】

前言

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接口

2.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.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. 开发应用

3.1 签名配置

使用 DevEco Studio 3.0.0.800 软件进行应用开发，真机设备运行和调试OpenHarmony应用前，需要对应用进行签名才能正常运行。主要分为四个步骤：生成密钥和证书请求文件，生成应用证书文件，生成应用profile文件，配置应用签名信息。
#创作者激励#OpenHarmony L1（3.0）串口功能开发-鸿蒙开发者社区

3.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