OpenAtom OpenHarmony（以下簡(jiǎn)稱(chēng)“OpenHarmony”）正在蓬勃發(fā)展，但開(kāi)源社區(qū)在國(guó)內(nèi)還是一個(gè)年輕的新生事物，如何參與社區(qū)開(kāi)源貢獻(xiàn)已經(jīng)成為開(kāi)發(fā)者們?cè)絹?lái)越關(guān)心的話(huà)題。中國(guó)科學(xué)院軟件研究所的黃吉老師將以一個(gè)開(kāi)發(fā)者的視角給大家闡述深度參與到 OpenHarmony 社區(qū)的一些心得體會(huì)。

Q1

請(qǐng)簡(jiǎn)要介紹下自己，以及所在開(kāi)發(fā)團(tuán)隊(duì)

大家好，我叫黃吉，目前就職于中國(guó)科學(xué)院軟件研究所（以下簡(jiǎn)稱(chēng)“中科院軟件所”），在中科院軟件所負(fù)責(zé) OpenHarmony 移植開(kāi)發(fā)相關(guān)工作。中科院軟件所團(tuán)隊(duì)在 OpenHarmony 項(xiàng)目組中主要負(fù)責(zé) OpenHarmony 的技術(shù)研發(fā)、技術(shù)支持、社區(qū)支持、SIG 倉(cāng) CI 門(mén)禁支持及維護(hù)、活動(dòng)營(yíng)銷(xiāo)支撐、及其他社區(qū)治理相關(guān)的工作。

Q2

作為開(kāi)發(fā)領(lǐng)域知名的技術(shù)大牛，您最初為什么會(huì)選擇加入OpenHarmony生態(tài)、參與開(kāi)源共建呢？您認(rèn)為，OpenHarmony項(xiàng)目最吸引人的點(diǎn)在哪里？

大牛談不上，我的技術(shù)能力、專(zhuān)業(yè)認(rèn)識(shí)等各方面需要學(xué)習(xí)的地方還有很多。我認(rèn)為這個(gè)選擇是雙向的，一方面我被 OpenHarmony 項(xiàng)目積極的開(kāi)源精神深深吸引，感覺(jué)為開(kāi)源社區(qū)貢獻(xiàn)代碼真的是一件很酷的事情，內(nèi)心有參與 OpenHarmony 生態(tài)的主觀動(dòng)力；另一方面是 OpenHarmony 社區(qū)秉持開(kāi)放包容的宗旨，接納了很多普通開(kāi)發(fā)者，我才會(huì)有機(jī)會(huì)去了解 OpenHarmony 項(xiàng)目并嘗試為其貢獻(xiàn)代碼。開(kāi)源共建也是 OpenHarmony 項(xiàng)目最吸引人的重要特點(diǎn)。現(xiàn)如今 OpenHarmony 項(xiàng)目為國(guó)內(nèi)開(kāi)源之路邁出了堅(jiān)實(shí)的一步，這條路可能走得沒(méi)那么快，但它確實(shí)勇敢地踏出了腳步，這就足夠了。

Q3

您在什么時(shí)候加入了OpenHarmony開(kāi)源項(xiàng)目團(tuán)隊(duì)？通過(guò)多久研發(fā)了RK3568的ADM驅(qū)動(dòng)，合入主干上千行代碼，現(xiàn)在被評(píng)為代碼月度貢獻(xiàn)之星，真的太了不起了！您方便給我們介紹一下這個(gè)產(chǎn)品嗎，或者這段經(jīng)歷嗎？這么短時(shí)間達(dá)成了這樣好的效果，請(qǐng)問(wèn)您的“秘訣”都有哪些呢？

我是在 2021 年 2 月份的時(shí)候加入 OpenHarmony 開(kāi)源項(xiàng)目團(tuán)隊(duì)的。當(dāng)時(shí)的 OpenHarmony 還只有輕量及小型系統(tǒng)，如今標(biāo)準(zhǔn)型系統(tǒng)的能力已經(jīng)趨于完善了，并且有了自己的 hap 應(yīng)用開(kāi)發(fā)工具。可以看到 OpenHarmony 的能力是在不斷快速迭代、演進(jìn)及完善。

回首 Dayu200 開(kāi)發(fā)板的 ADM（Audio Device Model，音頻設(shè)備模型）開(kāi)發(fā)過(guò)程，是充滿(mǎn)喜悅、充滿(mǎn)收獲的。ADM 是 HDF（OpenHarmony Driver Foundation）下面的一個(gè)音頻子模塊，ADM 已經(jīng)支持了 Hi3516DV300 等開(kāi)發(fā)板，而我們做的這塊就是對(duì) Dayu200 開(kāi)發(fā)板的適配。在我們做適配之前，音頻驅(qū)動(dòng)完全依賴(lài)于 TinyALSA 庫(kù)，現(xiàn)在將其完全 HDF 化，不僅解決了依賴(lài)問(wèn)題，還具有里程碑意義，為其他第三方開(kāi)發(fā)板的移植提供了參考。適配過(guò)程中，我們發(fā)現(xiàn)從零開(kāi)始實(shí)現(xiàn)接口是不現(xiàn)實(shí)的，造輪子不僅需要考慮穩(wěn)定性、音頻編解碼、格式匹配、DMA 傳輸?shù)榷喾矫娴臇|西，而且工作量巨大，也不利于后續(xù)的維護(hù)，因此我們另辟蹊徑。采用 Linux 原生函數(shù)來(lái)進(jìn)行適配，其中 Codec 層通過(guò)注冊(cè) RK809 原生對(duì)象來(lái)獲取操作 I2C 總線的對(duì)象，然后傳入對(duì)應(yīng)的 regmap 函數(shù)來(lái)進(jìn)行寄存器讀寫(xiě)操作；DAI 層通過(guò)注冊(cè) RK3568 原生對(duì)象來(lái)獲取操作 I2S 總線的對(duì)象，然后傳入對(duì)應(yīng)的 regmap 函數(shù)來(lái)進(jìn)行 I2S 寄存器讀寫(xiě)操作；而 DMA 部分則是通過(guò) Linux原生的 dma_engine 相關(guān)函數(shù)，按照規(guī)范的流程來(lái)完成請(qǐng)求 DMA 通道，配置 DMA 通道，預(yù)處理 DMA 通道，DMA 數(shù)據(jù)提交，DMA 數(shù)據(jù)處理等一系列的操作。因?yàn)閺S商一般都會(huì)對(duì)內(nèi)核部分進(jìn)行維護(hù)，并且其硬件外設(shè)都由內(nèi)核驅(qū)動(dòng)進(jìn)行管理，使用 Linux 原生接口就相當(dāng)于搭了一座橋，把上層框架與內(nèi)核驅(qū)動(dòng)聯(lián)系了起來(lái)，維護(hù)起來(lái)更容易了。同時(shí)，這種適配思路和方法是獨(dú)創(chuàng)性的，是十分具有借鑒意義的。

如果說(shuō)有什么秘訣的話(huà)，那就是一往無(wú)前的勇氣、不屈不撓的毅力以及永無(wú)止境的求知欲。遇到問(wèn)題是再尋常不過(guò)的事情了，“長(zhǎng)風(fēng)破浪會(huì)有時(shí)，直掛云帆濟(jì)滄海”，唯有迎難而上方可解決難題。有時(shí)候很可能多條路都走不通，有時(shí)候會(huì)有挫敗感，但堅(jiān)持的毅力會(huì)帶我們走出去，慢慢找到新的方向。當(dāng)然，還有很多東西是沒(méi)接觸過(guò)或者不甚了解的，但求知欲會(huì)推著我們前進(jìn)，推著我們主動(dòng)去學(xué)習(xí)，去了解未知，去向身邊的人求教，最終幫助我們的成長(zhǎng)。

Q4

能開(kāi)發(fā)出這么一個(gè)優(yōu)秀的產(chǎn)品，將核心代碼合入主干，您和您的團(tuán)隊(duì)一定付出了很多。可以給我們分享一下，開(kāi)發(fā)這個(gè)產(chǎn)品的整個(gè)過(guò)程，包括前期、中期、后期，您們具體都做了哪些工作，投入了多少人力和資源？

Dayu200 開(kāi)發(fā)板基于 OpenHarmony 的移植工作是由潤(rùn)和軟件主導(dǎo)，社區(qū)的多家成員單位的同事深度參與其中，有華為、潤(rùn)和軟件、深開(kāi)鴻、中科院軟件所等。中科院軟件所團(tuán)隊(duì)承接了移植 ADM 模塊的任務(wù) 。接下任務(wù)后，我們聯(lián)系到了華為和潤(rùn)和軟件的技術(shù)人員，獲取到了目標(biāo)開(kāi)發(fā)板的芯片、原理圖等研發(fā)必要的資料，隨后熟悉硬件的參數(shù)設(shè)計(jì)、芯片寄存器配置等信息，并且逐漸搭建代碼框架。熟悉過(guò)程其實(shí)花費(fèi)的時(shí)間和精力非常多，對(duì)于完全不清楚的結(jié)構(gòu)，需要一點(diǎn)一點(diǎn)閱讀文檔，遇到不清楚的細(xì)節(jié)問(wèn)題，還要聯(lián)系開(kāi)發(fā)人員一點(diǎn)一點(diǎn)對(duì)齊，這是一個(gè)考驗(yàn)?zāi)托牡倪^(guò)程。中科院軟件所團(tuán)隊(duì)在整個(gè)開(kāi)發(fā)過(guò)程中一直與其他各單位同事保持著緊密的溝通，幾乎每天都會(huì)組織會(huì)議一起討論研發(fā)方案，針對(duì)使用 HDI 的讀寫(xiě)接口無(wú)法作用于目標(biāo)芯片的問(wèn)題，選擇采用 Linux 原生函數(shù)來(lái)進(jìn)行適配解決，有效提升了進(jìn)度。在完成了代碼的初步功能并驗(yàn)證后，我們把本地適配好的代碼上傳提交到 OpenHarmony 代碼倉(cāng)，期間還經(jīng)過(guò)了 CI 門(mén)禁的代碼編譯、代碼測(cè)試、代碼規(guī)范審查，有問(wèn)題的部分會(huì)被修改直到通過(guò)審核。其中這個(gè)過(guò)程也相當(dāng)考量細(xì)節(jié)，有可能代碼規(guī)范審查一下子就報(bào)幾百個(gè)規(guī)范問(wèn)題或者警告，包括空格規(guī)范問(wèn)題、換行規(guī)范問(wèn)題、注釋規(guī)范問(wèn)題、宏定義規(guī)范問(wèn)題等問(wèn)題，需要仔細(xì)地核對(duì)修改。最后經(jīng)過(guò)對(duì)代碼的不斷修正和驗(yàn)證并將代碼整理到符合社區(qū)規(guī)范的狀態(tài)后，這些代碼成功合入到了主干。總的來(lái)說(shuō)，這是各方一起通力合作的結(jié)果，完成了從進(jìn)度跟蹤到任務(wù)分配再到技術(shù)問(wèn)題攻堅(jiān)的一系列問(wèn)題的閉環(huán)。

Q5

在整個(gè)開(kāi)發(fā)進(jìn)程中，您和您的團(tuán)隊(duì)遇到過(guò)哪些技術(shù)上或其他方面的難題？這些難題又是如何被逐一解決？在這些難題被解決的過(guò)程中，您總結(jié)了哪些寶貴的經(jīng)驗(yàn)or教訓(xùn)？

整個(gè)開(kāi)發(fā)過(guò)程中主要有以下幾個(gè)困難點(diǎn)。第一，Dayu200 開(kāi)發(fā)板的音頻芯片比較特殊，它包含 Codec、RTC、PMIC 等多種功能，不能簡(jiǎn)單的采用 ADM 接口去操作它。為了避免影響到其他功能的正常運(yùn)作，我們使用了原生 Linux 設(shè)備驅(qū)動(dòng)接口來(lái)操作 I2C、I2S、DMA 的通信以及數(shù)據(jù)傳遞，避免了異常操作的風(fēng)險(xiǎn)。第二，播放一段時(shí)間后，停止播放，持續(xù)有尖銳的很小的聲音。針對(duì)此問(wèn)題，我們注冊(cè)了 Trigger 函數(shù)，根據(jù)接收到狀態(tài)信息，如果為停止?fàn)顟B(tài)，則對(duì) Codec 相關(guān)器件進(jìn)行下電。第三，RK 的音量調(diào)節(jié)功能必須要給左右聲道寄存器寫(xiě)入相同數(shù)值才可生效，但當(dāng)時(shí)框架還不支持對(duì)左右寄存器的賦值。后來(lái)，我們與框架開(kāi)發(fā)人員協(xié)商，使得框架新增了該項(xiàng)功能，最終適配上了音量調(diào)節(jié)能力。

經(jīng)驗(yàn)的話(huà)，就是一定要多去和不同的技術(shù)開(kāi)發(fā)人員溝通交流，有時(shí)候可能會(huì)陷入思維定勢(shì)，常常不能發(fā)現(xiàn)自己代碼上的問(wèn)題，而別人一眼就看到關(guān)鍵所在，直接指出來(lái)，那么問(wèn)題就迎刃而解了。

Q6

加入OpenHarmony生態(tài)以來(lái)，您最大的驚喜是什么？或者有哪些具體的收獲？

加入 OpenHarmony 生態(tài)以來(lái)，我最大的驚喜是了解了開(kāi)源社區(qū)的玩法，在 OpenHarmony 社區(qū)，可以從別人的代碼中學(xué)到更多知識(shí)，同時(shí)自己的代碼可以被更多人看到，好的地方不好的地方，都會(huì)有人提出來(lái)，在這種快速的反饋中，更能夠了解自己存在的不足。

我認(rèn)為，這段時(shí)間充滿(mǎn)了收獲，首先是認(rèn)識(shí)了很多志同道合的小伙伴，大家都積極參與開(kāi)源項(xiàng)目，貢獻(xiàn)自己的代碼，開(kāi)源之路本就荊棘叢生，有這么多開(kāi)源社區(qū)的伙伴一起前行，路也好走了許多。其次是獲得了磨練與成長(zhǎng)，在優(yōu)秀的人面前，你能看到差距，從而去學(xué)習(xí)別人的優(yōu)點(diǎn)；在優(yōu)秀的代碼面前，你能看到框架構(gòu)思的差距，從而去學(xué)習(xí)別人的編碼思路，這確實(shí)讓人受益匪淺。

Q7

期待未來(lái)OpenHarmony哪些方面能夠得到改善、提供更多支持？

客觀的說(shuō)，OpenHarmony 還存在有一些不足的地方，比如社區(qū)反映的入門(mén)資料較少、框架解析資料不夠清晰、issue 請(qǐng)求響應(yīng)不太及時(shí)等問(wèn)題。主要原因在這么幾個(gè)方面，一是 OpenHarmony 發(fā)展初期，它是國(guó)內(nèi)最前沿的大規(guī)模的開(kāi)源系統(tǒng)，它的發(fā)展是摸著石頭過(guò)河的過(guò)程，必然會(huì)存在這樣或者那樣的沒(méi)有遇到過(guò)的問(wèn)題，這是相當(dāng)正常的；二是開(kāi)發(fā)者技術(shù)水平和技術(shù)關(guān)注點(diǎn)存在差異，有的開(kāi)發(fā)者可能需要更詳盡的入門(mén)資料來(lái)進(jìn)入門(mén)檻，有的開(kāi)發(fā)者可能關(guān)注底層驅(qū)動(dòng)lib庫(kù)的編譯生成方式，有的開(kāi)發(fā)者可能關(guān)注 OpenHarmony SDK 如何生成 hap 應(yīng)用，不知道如何找到自己想要的開(kāi)發(fā)資料；三是 OpenHarmony 每個(gè)代碼倉(cāng)的管理相對(duì)獨(dú)立，由每個(gè)倉(cāng)庫(kù)自己的 committer 進(jìn)行管理，一方面很多開(kāi)發(fā)者可能找不到正確的代碼倉(cāng)來(lái)提 issue，另外一方面某些 committer 可能由于事務(wù)繁忙，沒(méi)有及時(shí)地回復(fù) issue。我期待未來(lái) OpenHarmony 能夠切實(shí)的引導(dǎo)開(kāi)發(fā)者，根據(jù)他們的需求，提供對(duì)應(yīng)的開(kāi)發(fā)資料開(kāi)發(fā)資源，并且能夠進(jìn)一步加強(qiáng)與開(kāi)發(fā)者的聯(lián)系，更多傾聽(tīng)開(kāi)發(fā)者的聲音，給予良性的有效的反饋。

Q8

OpenHarmony目前仍處在開(kāi)發(fā)探索階段，很多共建單位和生態(tài)伙伴還不清楚開(kāi)源項(xiàng)目的玩法，或不知該如何著手進(jìn)行開(kāi)發(fā)。可以請(qǐng)您給大家分享一條，您認(rèn)為最重要或最值得分享的心得嗎？

我認(rèn)為 OpenHarmony 是一個(gè)非常自由開(kāi)放的項(xiàng)目，各家共建單位或生態(tài)伙伴可以根據(jù)自己的需求想法來(lái)進(jìn)行選擇。如果想進(jìn)行應(yīng)用hap開(kāi)發(fā)，可以參考 OpenHarmony 的 docs 倉(cāng)下面的 JS 開(kāi)發(fā)資料。如果是想進(jìn)行開(kāi)發(fā)板移植，可以參考 OpenHarmony 的 docs 倉(cāng)下面的芯片移植資料，在此基礎(chǔ)上，如果想貢獻(xiàn)代碼，則可以聯(lián)系 OpenHarmony SIG 相關(guān)組織走代碼上倉(cāng)的流程。至于開(kāi)發(fā)上的問(wèn)題，建議在 OpenHarmony 社區(qū)的 Zulip 上提問(wèn)（https://zulip.openharmony.cn，未注冊(cè)用戶(hù)需要郵箱注冊(cè)），或者在研發(fā)討論群里面提問(wèn)，或者是在相關(guān)代碼倉(cāng)提 issue，總之，渠道是十分廣泛的。

審核編輯 ：李倩