DSP整合開發工具CCS的Git工具使用說明
關於CCS軟體的Git使用說明
1.新建工程
- 點選視窗上的 File -> New -> CCS Project
- 如下圖所示,設定工程名、工程路徑,選擇建立 Empty Project (with main.c)
工程目錄下包含 “include
在 Project Explorer 視窗下右鍵工程名,選擇 New -> Folder ,新建一個資料夾。Folder name命名為 Unity。該資料夾下用於存放軟體測試框架原始碼。另外再新建一個 Module 資料夾,用於存放功能程式碼。再在它們的資料夾下面建立src和inc資料夾,分別存放原始碼檔案和標頭檔案。分別將檔案新增到工程目錄中,工程目錄結構如下圖所示:
2.工程程式碼
- DumbExample.c檔案
#include "DumbExample.h"
int AverageThreeBytes(int a, int b, int c)
{
return (int)(((int32_t)a + (int32_t)b + (int32_t)c) / 3);
}
- DumbExample.h檔案
#ifndef DUMBEXAMPLE_H_
#define DUMBEXAMPLE_H_
#include <stdint.h>
int AverageThreeBytes(int a, int b, int c);
#endif /* DUMBEXAMPLE_H_ */
- main.c檔案
#include "unity.h"
#include "DumbExample.h"
void test_AverageThreeBytes_should_AverageMidRangeValues(void)
{
TEST_ASSERT_EQUAL_HEX8(40, AverageThreeBytes(30, 40, 50));
TEST_ASSERT_EQUAL_HEX8(40, AverageThreeBytes(10, 70, 40));
TEST_ASSERT_EQUAL_HEX8(33, AverageThreeBytes(33, 33, 33));
}
void test_AverageThreeBytes_should_AverageHighValues(void)
{
TEST_ASSERT_EQUAL_HEX8(80, AverageThreeBytes(70, 80, 90));
TEST_ASSERT_EQUAL_HEX8(127, AverageThreeBytes(127, 127, 127));
TEST_ASSERT_EQUAL_HEX8(84, AverageThreeBytes(0, 126, 126));
}
void setUp()
{
}
void tearDown()
{
}
int main(void)
{
UNITY_BEGIN();
RUN_TEST(test_AverageThreeBytes_should_AverageMidRangeValues);
RUN_TEST(test_AverageThreeBytes_should_AverageHighValues);
return UNITY_END();
}
在 Project Explorer 視窗下右鍵工程名,選擇 Porperties,如下圖所示:
選擇 Include Options,在右側視窗中新增工程標頭檔案的路徑。
此時可以嘗試一下編譯工程,看看是否有錯誤;
3.開啟Git工具
- 窗體選單欄 View -> Other,在搜尋框中輸入Git,如下圖所示:
4.建立本地倉庫
- 選擇Git Repositories和Git Staging開啟
- 在Git Repositories窗口裡,點選 Create a new local Git Repository,如下圖所示,選擇軟體工程倉庫的具體位置及工程的當前目錄。
- 倉庫建立後介面如下圖所示,該倉庫目前還未初始化。
5.設定遠端連結
右鍵 Remote ,選擇 Create Remote,出現下圖介面,預設將遠端倉庫命名為origin,你也可以根據自己的需要修改命名,然後選擇Configure push,點選OK按鈕。
Configure Push視窗如下圖所示
開啟遠端倉庫的介面,複製遠端倉庫的連結路徑,有兩種連結形式,分別是SSH和HTTP形式。目前先講HTTP形式的連結方式,點選右側複製按鈕,講連結複製貼上板。
點選 Change 按鈕,出現Select URI視窗,介面如下。將貼上板上的遠端連結貼上到URI文字框內,其它文字框內的內容會自動填寫。然後在Authentication介面內填寫User和Password的具體內容。此處的賬戶密碼對應的是你GitLab註冊的賬戶密碼,點選Finish完成配置。
回到Configure Push視窗,介面如下圖所示,點選Advanced按鈕,彈出Configure Push視窗。
- 如下圖所示,是Configure Push視窗,我們需要指定源參考和目的參考,一般將本地倉庫的“master”分支與遠端的“master”建立對映關係,當然如果有多個分支,也可以根據自己的實際需要進行分支對映。然後點選Add Spec按鈕,將該對映關係新增到 Specification for push 介面,點選Finish按鈕,完成配置儲存。
此時再次回到Configure Push視窗,可以點選下方的Try-Run按鈕,出現下圖介面,顯示“rejected - non-fast-forward”,一般出現這個原因是遠端倉庫與本地倉庫的修改不一致,所以我們需要先講遠端倉庫Fetch下來,然後與本地倉庫進行Merge,再講本地倉庫Push到遠端倉庫。先點選Save and Push,將該配置進行儲存,先不管Push失敗的原因,點選OK。
現在檢視Git Repositories介面,如下圖所示,可以發現在Remote下方出現了origin分支,並且下面分別對應Push和Fetch連結。我們剛剛對Push的對映關係進行了說明,下面我們同樣需要對Fetch的對映關係進行配置,配置方式一樣,右鍵綠色箭頭往下的連結,選擇Configure Fetch,同樣也是點選Advanced,在Configure Push視窗中配置對映關係。
配置好Fetch的對映關係後,右鍵Oringin,選擇Fetch選項,彈出如下視窗。可以看出遠端分支指向“1c6be84a”,而本地分支指向“2eb9a7c”。故需要在本地倉庫對更新進行合併。
在Git Repositories介面,右鍵 Branches -> Remote Tracking -> origon -> master,選擇Merge選項,顯示介面如下,可以看出本地倉庫確實與遠端倉庫不一致,點選OK按鈕,合併分支。此時點選Git Repositories介面右上角的重新整理按鈕,可以看到本地倉庫與遠端倉庫標籤一致了。
6.檔案跟蹤
- 在 Project Explorer 視窗工程目錄下,右鍵 Debug 目錄,選擇 Team -> Ignore,忽略該資料夾下的檔案變化。
- 在 Project Explorer 視窗工程目錄下,選中 Unity、Module、28335_RAM_lnk.cmd、main.c,右鍵選擇 Team -> Add to index,
- 檢視Git staging視窗,如下圖所示:
- 左上角視窗中有一些未新增進緩衝區的檔案,可以全部選中,右鍵選擇Add to index,這樣所有的改變檔案都加入到了緩衝區。
- 在右上角Commit Message文字框內,填入此次修改的內容概述,如果想更新到遠端倉庫點選右下角的Commit and Push按鈕,如果只想更新到本地倉庫點選Commit按鈕。
- 如果想檢視自己的提交記錄,可以開啟Git Reflog視窗,如下圖所示。