0731-84728105
15116127200
關于規範FAST文檔和(hé)代碼版本的(de)通知
發布時間:2018-08-16
     自(zì)從2018年(nián)6月推出OpenBox-S4z平台後,基于OpenBox-S4z/FAST的(de)解決方案已經在國(guó)防科(kē)技大學(xué)、清華大學(xué)、北(běi)京大學(xué)、電子(zǐ)科(kē)技大學(xué)等單位的(de)教學(xué)和(hé)科(kē)研活動中得到應用,涉及到計算機(jī)網絡教學(xué)實驗、新型路由交換(段路由)設備原型、工業互聯網交換設備原型、網絡安全防護設備原型和(hé)網絡測試儀原型的(de)研發。
     随着用戶數不斷增加,用戶開發水平不斷提升,應用開發類型不斷豐富,FAST平台的(de)一(yī)些深層次問題逐漸顯現。一(yī)是設計文檔不完善,用戶無法從文檔中獲取必要的(de)信息;二是設計文檔與代碼不對應,給用戶開發帶來困擾;三是軟硬件代碼設計存在Bug,運行(xíng)不穩定;四是代碼版本管理(lǐ)混亂,降低(dī)開發和(hé)服務的(de)效率。
     為(wèi)了解決上述問題,FAST社區拟開展以下工作。
一(yī)、建立和(hé)維護Bug清單
     集中管理(lǐ)不同(單位)用戶在FAST平台開發中遇到的(de)問題,設置并維護Bug清單。
     用戶可(kě)通過郵件或在FAST社區內(nèi)提交Bug,Bug清單及修複狀态在FAST網站和(hé)公衆号平台定期發布。FAST平台提供商(shāng)和(hé)服務提供商(shāng)負責相關Bug的(de)确認及修複。
二、強化版本管理(lǐ)
     明确區分FAST的(de)研發版本與發布版本,避免出現不同的(de)代碼分支,造成代碼版本管理(lǐ)混亂,降低(dī)開發和(hé)服務的(de)效率。
     FAST平台提供商(shāng)在FPGA OS和(hé)FAST支撐軟件中設置版本标識,FAST服務商(shāng)提供FAST硬件流水線和(hé)FAST庫的(de)版本标識,為(wèi)用戶提供讀取各類版本标識的(de)方法。
     隻有(yǒu)通過內(nèi)部測試的(de)代碼版本才能成為(wèi)發布版本,用戶從唯一(yī)的(de)網址下載FAST發布的(de)軟硬件代碼。
     以後FAST的(de)所有(yǒu)軟硬件代碼及文檔均隻能從網站固定位置下載更新,不再通過其他方式交互。
三、設置常見問題列表
     針對FAST論壇中用戶提出的(de)各類問題以及回複,整理(lǐ)常見問題(FAQ)列表,供其他用戶參考。
     歡迎FAST用戶對以上工作安排提出寶貴意見,上述工作的(de)實施細則将會在近期公布。為(wèi)做(zuò)好以上工作,2018年(nián)8月20日後,請所有(yǒu)FAST用戶從FAST網站下載代碼和(hé)文檔,FAST技術支持團隊不再通過線下直接向用戶提供代碼和(hé)文檔。