OpenHarmony L1（3.0）串口功能開發(fā)

作者：軟通動力HOS 2023-02-28 15:49:09

本文介紹了在OpenHarmony 3.0 LTS系統(tǒng)上重串口功能實現(xiàn)到應(yīng)用開發(fā)的整套流程。簡單的API接口開發(fā)，可直接依賴系統(tǒng)模塊。難點主要在輕量級系統(tǒng)開發(fā)，讀者可參考開源鴻蒙中輕量級系統(tǒng)服務(wù)管理部件中的相關(guān)介紹進行開發(fā)。

??想了解更多關(guān)于開源的內(nèi)容，請訪問：??

??51CTO 開源基礎(chǔ)軟件社區(qū)??

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

前言

OpenHarmony 3.0 LTS是面向全場景的開源分布式操作系統(tǒng)，能夠在物聯(lián)網(wǎng)上使用。可以支持三種系統(tǒng)類型，標準系統(tǒng)、輕量系統(tǒng)和小型系統(tǒng)。本文提供了在OpenHarmony 3.0 LTS實現(xiàn)串口調(diào)試功能的開發(fā)方案。

1、編寫代碼生成對應(yīng)動態(tài)庫文件

串口功能開發(fā)包括串口初始化、數(shù)據(jù)讀寫、修改數(shù)據(jù)開發(fā)格式等。具體代碼不便展示。編寫gn文件生成對應(yīng)動態(tài)庫文件。

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

2、提供API接口

（1）依賴router模塊開發(fā)

如果串口權(quán)限不受限制，可以直接在router模塊增加串口相關(guān)功能，節(jié)省開發(fā)時間。
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);

串口初始化及進制轉(zhuǎn)換相關(guān)代碼可直接調(diào)用庫函數(shù)。串口讀回調(diào)的相關(guān)代碼如下：

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模塊增加相關(guān)依賴。
foundation\ace\ace_engine_lite\frameworks\BUILD.gn。

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

（2）輕量級服務(wù)開發(fā)

串口權(quán)限受限時，需要啟用輕量級服務(wù)，應(yīng)用可以通過服務(wù)，跨進程操作串口。具體配置如下：

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

配置服務(wù)自啟動：

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 &

配置服務(wù)：

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

代碼實現(xiàn)服務(wù)初始化，具體實現(xiàn)可參考wifi_lite相關(guān)代碼。在Invoke中去調(diào)用串口相關(guān)功能。
**\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;
}
//創(chuàng)建服務(wù)對象：
static SamgrSerialPortService SerialPortSvc = {
   .GetName = GetName,
   .Initialize = Initialize,
   .MessageHandle = MessageHandle,
   .GetTaskConfig = GetTaskConfig,
   SERVER_IPROXY_IMPL_BEGIN,
   .Invoke = Invoke,
   IPROXY_END,
};
//向SAMGR注冊服務(wù)及接口：
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、開發(fā)應(yīng)用

（1）簽名配置

使用 DevEco Studio 3.0.0.800 軟件進行應(yīng)用開發(fā)，真機設(shè)備運行和調(diào)試OpenHarmony應(yīng)用前，需要對應(yīng)用進行簽名才能正常運行。主要分為四個步驟：生成密鑰和證書請求文件，生成應(yīng)用證書文件，生成應(yīng)用profile文件，配置應(yīng)用簽名信息。

#創(chuàng)作者激勵#OpenHarmony L1（3.0）串口功能開發(fā)-開源基礎(chǔ)軟件社區(qū)

（2）調(diào)試命令

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