大家好，我是雜燴君。
在嵌入式項目中，軟件是一個不斷迭代的過程，需要考慮各種兼容性。之前我們的項目，因為這方面考慮得比較少，導致項目中后期開發起來很被動。
項目系統總體設計階段，應盡可能地考慮到未來可以遇見的情況，覆蓋到盡可能多的業務擴展。項目雖然分階段開發，各個階段完成的功能都不一樣，總體設計要指向最終的需求。
制定的協議要滿足整個項目所有數據的交互。
比如：
這里的 ID 設置為 1 個字節，可能有一定的風險。后面功能加著加著，可能 1 個字節的 ID 滿足不了，就得改協議。盡管可能滿足了某個項目的需求，但萬一之后其它項目也用了這一套代碼，但是 1 個字節的 ID 滿足不了，又得改代碼。這里設置 2 字節可能會好一點，基本上能滿足絕大部分情況的使用。
不一定為了覆蓋范圍更廣而設置 4 字節，這樣可能有點冗余。很多情況都有一個平衡點，需要自己權衡。
Length字段只設置了 1 個字節，可能也有一定的奉獻。后面功能中如果有發較大的數據，可能要分好多包發，原本可以發得很快，被這里限制死了。到時候想要提速，就得改協議。
之前項目里，幾塊板間的通信都用同一套協議。但后期發現該協議滿足不了新需求，但為了不影響到前面的數據，又搞了一套協議。導致項目里有兩套差不多一樣的協議處理代碼。
協議應該是項目一開始考慮好、制定好，整個項目開發期間，都不應該再做改動。
后面新增的數據，不應該插入現有的數據中，應該單獨增加一個數據ID。
比如：
現有的數據中，有一條數據叫做設備信息的數據，設備信息里包含了：設備IP、設備Mac。這個數據會顯示在手機APP上。對應的 C 語言代碼：
#define??MSG_ID_DEV_INFO???0x0001
typedef?struct?_dev_info
{
?char?dev_ip[IP_MAX_LEN];
?char?dev_mac[MAC_MAX_LEN];
}dev_info_t;
假如后面需要再顯示一個設備的sn，這個數據我們應該加在哪里？
如果是項目前中期，這時候還是在開發階段，我們可以隨意修改。因為設備sn也是設備信息的一部分，可以直接在設備信息這個數據里添加會比較合理：
#define??MSG_ID_DEV_INFO???0x0001
typedef?struct?_dev_info
{
?char?dev_ip[IP_MAX_LEN];
?char?dev_mac[MAC_MAX_LEN];
????char?dev_sn[SN_MAX_LEN];
}dev_info_t;
如果是產品已經在市場上流通，這時候這么加的話，軟件兼容性就不太好。因為假如你的手機APP版本與設備版本不匹配，原有的設備IP及設備MAC這兩個設備信息可能都顯示不出來，因為我們這么一改，破壞了原有的數據結構，而手機APP按照原來的數據來做解析的，會解析不過。
這時候可以這么來加：
#define??MSG_ID_DEV_INFO???0x0001
#define??MSG_ID_DEV_SN?????0x0002
typedef?struct?_dev_info
{
?char?dev_ip[IP_MAX_LEN];
?char?dev_mac[MAC_MAX_LEN];
}dev_info_t;
typedef?struct?_dev_sn
{
????char?dev_sn[SN_MAX_LEN];
}dev_sn_t;
這樣，哪怕手機APP版本與設備版本沒有對應上，原來的數據還是能正常顯示的。當然，最好的情況當然是在開發階段就合理地設計好。不然，像這種情況，只能犧牲一些程序可讀性來換取程序兼容性了。這會讓后面看代碼的人覺得很奇怪，你這個sn不也是數據設備信息嗎，怎么還單獨給一個ID。后面接手這個代碼的人，可能就會把這一塊代碼給改了。
溫馨提示：在沒有完全弄懂維護項目的代碼為什么這么實現的情況下，能正常在跑的程序還是別亂動得好，哪怕你覺得這是屎山代碼。否則可能會出大問題。要么等到軟件重構時再修改，要么就繼續打補丁。
如果是刪除本模塊內部自己使用的數據，你想怎么刪就怎么刪。
如果是刪除與其它模塊進行交互的數據，這就不能這么隨意了。比如，請求、應答的方式。應答端給請求端返回的數據是不能隨意刪的，如果要刪，一定要確保請求端已經沒有請求數據的需求，并且已經去掉相關代碼時，這時候應答端才去刪數據，否則還是留著吧。
其實數據定了，為了保證軟件兼容性，應該是要禁止修改的。
如果一定要修改，可以先增加一條新數據，后面慢慢切為新數據、刪除舊數據。
正在使用的接口，應該盡量不要修改。如果要修改，一定不要影響之前的功能。
之前就有遇到類似的情況。舉個例子：
typedef?enum?_sys_status
{
?SYS_STATUS_IDLE,
?SYS_STATUS_RUNNING,
?SYS_STATUS_STOP,
}sys_status_t;
static?sys_status_t?g_sys_status;
sys_status_t?get_sys_status(void)
{
?return?g_sys_status;
}
這里的系統狀態是要顯示在手機APP上的，不同的狀態顯示不同的圖標。后面要新增一個狀態，結果數據提供者這么改：
typedef?enum?_sys_status
{
?SYS_STATUS_IDLE,
?SYS_STATUS_NEW_STATUS,
?SYS_STATUS_RUNNING,
?SYS_STATUS_STOP,
}sys_status_t;
static?sys_status_t?g_sys_status;
sys_status_t?get_sys_status(void)
{
?return?g_sys_status;
}
接口提供者把新增的數據插入了中間，影響了枚舉原有的順序。結果手機APP上圖標顯示亂了。
影響到接口的修改，要保證原有的數據不受影響。
在軟件升級過程中，需要考慮軟件所依賴的其他系統組件是否發生變化，以確保升級后軟件能夠正常運行，不會影響其他系統組件的正常運行。如果其他系統組件發生變化，則需要進行相關測試和文檔更新，以確保整個系統能夠正常運行。
另外隨著項目的迭代，這一套代碼有可能運行于不同的系統不同的芯片平臺。
比如，我們嵌入式Linux項目，有些項目里會用到一些第三方庫，這時候可能會編譯成動態庫的形式。要考慮升級的時候能不能升級動態庫。如果不能，就得把依賴的庫一起編譯到可執行程序里。
另外，如果使用動態庫，之后產品軟硬件迭代換了一個芯片平臺的話，我們就需要重新交叉編譯一次所依賴的庫。如果為了保證這一塊的兼容性，也可以考慮把所依賴的庫與用戶代碼一起編譯。
當然，這個根據實際情況進行權衡取舍。如果依賴的庫很多，一起編譯到可執行程序里，導致可執行程序很大，到時候更新也不好更新。
涉及到功能的添加的，盡量不要影響到之前已開發的功能。不然也會增加用戶對產品的學習成本。比如某些指示燈在前一個版本的快閃、慢閃代表什么意思，這個在之后就盡量不要去修改了，不然用戶又得重新理解。
在軟件升級過程中，需要考慮軟件的性能是否發生變化，以確保升級后軟件的性能仍然能夠滿足用戶需求。如果軟件的性能發生變化，則需要進行相關測試和優化，以確保軟件能夠正常運行，并且能夠滿足用戶的性能需求。
比如，原來正常升級需要3分鐘，某個版本之后升級變成了6分鐘，升級效率變差了。
在軟件升級過程中，需要考慮軟件的安全性是否得到加強，以確保升級后軟件的安全性能夠得到保障，不會出現新的安全風險。如果軟件的安全性得到加強，則需要進行相關測試和文檔更新，以確保軟件能夠正常運行，并且能夠保障用戶的安全。
相關資料：
END
來源：嵌入式大雜燴
版權歸原作者所有，如有侵權，請聯系刪除。
▍推薦閱讀
華為C/C++編碼規范流出
分享一個開源串口神器，太強了！
短短三個月，稚暉君創業項目已獲三輪融資
