本文介紹了在OpenHarmony 3.0 LTS系統(tǒng)上重串口功能實(shí)現(xiàn)到應(yīng)用開發(fā)的整套流程。簡單的API接口開發(fā)，可直接依賴系統(tǒng)模塊。難點(diǎn)主要在輕量級系統(tǒng)開發(fā)，讀者可參考開源鴻蒙中輕量級系統(tǒng)服務(wù)管理部件中的相關(guān)介紹進(jìn)行開發(fā)。
??想了解更多關(guān)于開源的內(nèi)容，請?jiān)L問：??
??51CTO 開源基礎(chǔ)軟件社區(qū)??
??https://ost.51cto.com??
前言
OpenHarmony 3.0 LTS是面向全場景的開源分布式操作系統(tǒng)，能夠在物聯(lián)網(wǎng)上使用?？梢灾С秩N系統(tǒng)類型，標(biāo)準(zhǔn)系統(tǒng)、輕量系統(tǒng)和小型系統(tǒng)。本文提供了在OpenHarmony 3.0 LTS實(shí)現(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);
串口初始化及進(jìn)制轉(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ù)，跨進(jìn)程操作串口。具體配置如下：
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},
};代碼實(shí)現(xiàn)服務(wù)初始化，具體實(shí)現(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 軟件進(jìn)行應(yīng)用開發(fā)，真機(jī)設(shè)備運(yùn)行和調(diào)試OpenHarmony應(yīng)用前，需要對應(yīng)用進(jìn)行簽名才能正常運(yùn)行。主要分為四個步驟：生成密鑰和證書請求文件，生成應(yīng)用證書文件，生成應(yīng)用profile文件，配置應(yīng)用簽名信息。
（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
總結(jié)
本文介紹了在OpenHarmony 3.0 LTS系統(tǒng)上重串口功能實(shí)現(xiàn)到應(yīng)用開發(fā)的整套流程。簡單的API接口開發(fā)，可直接依賴系統(tǒng)模塊。難點(diǎn)主要在輕量級系統(tǒng)開發(fā)，讀者可參考開源鴻蒙中輕量級系統(tǒng)服務(wù)管理部件中的相關(guān)介紹進(jìn)行開發(fā)。
??想了解更多關(guān)于開源的內(nèi)容，請?jiān)L問：??
??51CTO 開源基礎(chǔ)軟件社區(qū)??
??https://ost.51cto.com??
