OpenHarmony L1（3.0）串口功能开发-电子发烧友网

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模块增加串口相关功能，节省开发时间。foundationaceace_engine_liteframeworkssrccoremodules outer_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::GetInstance()->SerialRead(RouterModule::ReadingCallback);
}

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

JSIValue ReadCallback = JSI::CreateUndefined();
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模块增加相关依赖foundationaceace_engine_liteframeworksBUILD.gn

deps = [
"//device/hals/communication/serial_port:serial_service_api",
]

2.2轻量级服务开发

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

extern 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 &

配置服务：basesecuritypermissionservicespermission_liteipc_authincludepolicy_preset.h

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

代码实现服务初始化，具体实现可参考wifi_lite相关代码。在Invoke中去调用串口相关功能**serial_portserial_port_liteservicesamgr_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文件，配置应用签名信息。

3.2 调试命令

adb push entry-release-lite-signed.hap /userdataadb shellalias ls='ls --color=never'//解决ls乱码bm uninstall -n com.ingenic.curtainbm install -p entry-release-lite-signed.hap