# C4MLIB 工具

## Why Editor + CLI tools

- - -

## 編譯器

https://blog.zakkemble.net/avr-gcc-builds/

### 安裝

1. 下載 https://blog.zakkemble.net/download/avr-gcc-9.2.0-x64-mingw.zip
2. 解壓縮到你想安裝的資料夾，這邊解壓縮到 `D:/Programs/avr-gcc-8.2.0-x64-mingw/`
3. 將其中的`bin`資料夾路徑加入系統環境的path中。此範例路徑即`D:/Programs/avr-gcc-8.2.0-x64-mingw/bin`
1. 在「搜尋」中，搜尋並選取：系統 (控制台)
2. 按一下進階系統設定連結。
3. 按一下環境變數。在系統變數區段中，找到 PATH 環境變數並加以選取。按一下編輯。如果 PATH 環境變數不存在，請按一下新增。
4. 在編輯系統變數 (或新增系統變數) 視窗中，指定 PATH 環境變數的值。按一下確定。按一下確定，將其餘的視窗全都關閉。

ref: https://www.java.com/zh_TW/download/help/path.xml

- - -

## VScode

### 哪邊安裝 vscode

https://code.visualstudio.com/

### 實驗室目前常用插件

1. C/C++
- 自動補全
- 快速索引
2. gitlens
- 快速查詢 commit 改動
3. Clang-Format
- 自動排版

### 基本介紹

#### 側欄按鈕


- - -

### C/C++ 插件安裝以及設定

#### Step 1. 安裝


#### Step 2. 開啟 C/C++ 插件設定頁面


#### Step 3. 設定 C/C++ 插件

1. 設定名稱
這邊隨意即可，個人習慣輸入 "avr-gcc-for-asa_m128"。

2. 編譯器路徑
這邊輸入安裝好的編譯器位置，要輸入avr-gcc.exe的完整路徑。如下：

3. 包含路徑
第一行輸入 `${workspaceFolder}/**` ，讓插件自動搜索專案中所有標頭檔。
第二行輸入安裝編譯器位置 + `avr/include` ，以引入avrlibc的標頭檔。
像我編譯器安裝在 `D:/Programs/avr-gcc-8.2.0-x64-mingw/`，我要輸入的就是 `D:/Programs/avr-gcc-8.2.0-x64-mingw/avr/include`


4. 定義
這邊複製以下文字貼上即可。

    __AVR_ATmega128__
    F_CPU=11059200

第一行指單板電腦的工作頻率用的mcu，第二行指單板電腦的工作頻率。

- - -

### C/C++ 插件使用

首先，切回編輯頁面，並打開任意 .c/.h 檔案。

#### 索引函式以及巨集

方法1：將鼠標對想要想要索引的函式\巨集點選右鍵，並點選`Go to Definition`，即可跳到該函式\巨集所實現的地方。

方法2：編輯時，直接點選"F12"，即可轉跳到當前cursor所指向之函式\巨集所實現的地方。

#### 自動補全

打完函式前幾項關鍵字後，右側會自動跳出函式\巨集列表，可以透過鍵盤的上下鍵選擇要使用的函式，並使用鍵盤的"Tab"按鈕來確認。