MakefileをC++に対応させる

前回、Makefileでのビルドを使ってLチカをしました。

しかし、MakefileがC++でのビルドに対応していないので、cppファイルがあると読み込めません。

少し変更してC++に対応させましたので、ここに残しておきます。
makefileを以下のように編集します。

######################################
# target
######################################
TARGET = G431RBMakeProj

######################################
# building variables
######################################
# debug build?
DEBUG = 1
# optimization
OPT = -Og
#OPT = -O0

#######################################
# paths
#######################################
# Build path
#BUILD_DIR = build
ifeq ($(DEBUG), 1)
BUILD_DIR = Debug
endif
######################################
# source
######################################
# C sources
C_SOURCES = \
$(wildcard Src/*.c) \
$(filter-out Drivers/STM32G4xx_HAL_Driver/Src/stm32g4xx_hal_msp_template.c \
			Drivers/STM32G4xx_HAL_Driver/Src/stm32g4xx_hal_timebase_tim_template.c,\
			 $(wildcard Drivers/STM32G4xx_HAL_Driver/Src/*.c)) \ #Driverからは使用例のtemplateファイルを除く
			 
# CPP sources
CPP_SOURCES = \
$(wildcard Src/*.cpp) \

# ASM sources
ASM_SOURCES =  \
startup_stm32g431xx.s

#######################################
# binaries
#######################################
PREFIX = arm-none-eabi-
# The gcc compiler bin path can be either defined in make command via GCC_PATH variable (> make GCC_PATH=xxx)
# either it can be added to the PATH environment variable.
ifdef GCC_PATH
CC = $(GCC_PATH)/$(PREFIX)gcc
CXX = $(GCC_PATH)/$(PREFIX)g++	#cpp
AS = $(GCC_PATH)/$(PREFIX)gcc -x assembler-with-cpp
CP = $(GCC_PATH)/$(PREFIX)objcopy
SZ = $(GCC_PATH)/$(PREFIX)size
else
CC = $(PREFIX)gcc
CXX = $(PREFIX)g++	#cpp
AS = $(PREFIX)gcc -x assembler-with-cpp
CP = $(PREFIX)objcopy
SZ = $(PREFIX)size
endif
HEX = $(CP) -O ihex
BIN = $(CP) -O binary -S
 
#######################################
# CFLAGS
#######################################
# cpu
CPU = -mcpu=cortex-m4

# fpu
FPU = -mfpu=fpv4-sp-d16

# float-abi
FLOAT-ABI = -mfloat-abi=hard

# mcu
MCU = $(CPU) -mthumb $(FPU) $(FLOAT-ABI)

# macros for gcc

# C defines
C_DEFS =  \
-DUSE_HAL_DRIVER \
-DSTM32G431xx \
'-D__weak=__attribute__((weak))' \
'-D__packed=__attribute__((__packed__))'
# C++ defines
CPP_DEFS = $(C_DEFS)
# AS defines
AS_DEFS = 


# C includes
C_INCLUDES =  \
-IInc \
-IDrivers/STM32G4xx_HAL_Driver/Inc \
-IDrivers/STM32G4xx_HAL_Driver/Inc/Legacy \
-IDrivers/CMSIS/Device/ST/STM32G4xx/Include \
-IDrivers/CMSIS/Include
# C++ includes
CPP_INCLUDES = $(C_INCLUDES)
CPP_INCLUDES += \
# AS includes
AS_INCLUDES = 

# compile gcc flags # compile g++ flags
CFLAGS = $(MCU) $(C_DEFS) $(C_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections
CPPFLAGS = $(MCU) $(CPP_DEFS) $(CPP_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections
ASFLAGS = $(MCU) $(AS_DEFS) $(AS_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections

ifeq ($(DEBUG), 1)
#CFLAGS += -g -gdwarf-2
CFLAGS += -g3 -O0 -gdwarf-2
#CPPFLAGS += -g -gdwarf-2
CPPFLAGS += -g3 -O0 -gdwarf-2
endif


# Generate dependency information
CFLAGS += -MMD -MP -MF"$(@:%.o=%.d)"

## Generate dependency information
CPPFLAGS += -MMD -MP -MF"$(@:%.o=%.d)"

#######################################
# LDFLAGS
#######################################
# link script
LDSCRIPT = STM32G431RBTx_FLASH.ld

# libraries
#LIBS = -lc -lm -lnosys 
LIBS = -lc -lm -lrdimon
LIBS += -lstdc++

LIBDIR = 
#LDFLAGS = $(MCU) -specs=nano.specs -T$(LDSCRIPT) $(LIBDIR) $(LIBS) -Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref -Wl,--gc-sections
LDFLAGS = $(MCU) -specs=nosys.specs -specs=rdimon.specs -T$(LDSCRIPT) $(LIBDIR) $(LIBS) -Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref -Wl,--gc-sections

# default action: build all
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin

#######################################
# build the application
#######################################
# list of objects
OBJECTS = $(addprefix $(BUILD_DIR)/,$(notdir $(C_SOURCES:.c=.o)))
vpath %.c $(sort $(dir $(C_SOURCES)))
# list of c++ objects
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(CPP_SOURCES:.cpp=.o)))
vpath %.cpp $(sort $(dir $(CPP_SOURCES)))
# list of ASM program objects
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASM_SOURCES:.s=.o)))
vpath %.s $(sort $(dir $(ASM_SOURCES)))

$(BUILD_DIR)/%.o: %.c Makefile | $(BUILD_DIR) 
	$(CC) -c $(CFLAGS) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(notdir $(<:.c=.lst)) $< -o $@
	
$(BUILD_DIR)/%.o: %.cpp Makefile | $(BUILD_DIR) 
	$(CXX) -c $(CPPFLAGS) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(notdir $(<:.cpp=.lst)) $< -o $@

$(BUILD_DIR)/%.o: %.s Makefile | $(BUILD_DIR)
	$(AS) -c $(CFLAGS) $< -o $@

$(BUILD_DIR)/$(TARGET).elf: $(OBJECTS) Makefile
#	$(CC) $(OBJECTS) $(LDFLAGS) -o $@ #c Link
	$(CXX) $(OBJECTS) $(LDFLAGS) -o $@ #cpp Link
	$(SZ) $@

$(BUILD_DIR)/%.hex: $(BUILD_DIR)/%.elf | $(BUILD_DIR)
	$(HEX) $< $@
	
$(BUILD_DIR)/%.bin: $(BUILD_DIR)/%.elf | $(BUILD_DIR)
	$(BIN) $< $@	
	
$(BUILD_DIR):
	mkdir $@		

#######################################
# clean up
#######################################
clean:
	-rm -fR $(BUILD_DIR)
  
#######################################
# dependencies
#######################################
-include $(wildcard $(BUILD_DIR)/*.d)

前回との差分はこちらをご覧ください。

https://github.com/YutakaNakamura/G431LEDBlinkMakeProj/compare/LEDBlink_with_C…LEDBlink_with_C++

また、main.cを、main.cppとし、cppが正しくコンパイルできている確認として、
次のテンプレートクラスを追加しています。

template<typename T> class mySqrt{
private:
	T mOldVal;
public:
	mySqrt(T pInitVal) {
		mOldVal = pInitVal;
	}
	constexpr T Calc(const T &pInput) {
		T val = (mOldVal + pInput/mOldVal) * (T)0.5;
		mOldVal = val;
		return val;
	}
};

これはニュートン法で平方根の値を求めるようなクラスです。

Lチカメゾットも0.1*√5 =0.2236秒周期に収束するようなLチカをするようにしています。

  while (1)
  {
    /* USER CODE END WHILE */
	float sqrt5 = msqrt.Calc(5.0f);
	int delay = 100 * sqrt5;
	HAL_Delay(delay);
	HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
	HAL_Delay(delay);
	HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
    /* USER CODE BEGIN 3 */
  }

以下にプロジェクトのリポジトリを残します。詰まったときに参考にしてください。

https://github.com/YutakaNakamura/G431LEDBlinkMakeProj/tree/LEDBlink_with_C++

git clone

https://github.com/YutakaNakamura/G431LEDBlinkMakeProj/tree/LEDBlink_with_C/G431RB_Proj -b LEDBlink_with_C++

Makefile+CubeMX+CubeIDEでSTM32開発

標準のCubeIDEの使い方は、

①CubeIDEでプロジェクトを作る
②CubeIDE内 CubeMXでコード生成
③CubeIDEでデバッグ

とCubeIDEのみで全て完結します。
一方で、この手法だと次のような欠点があります。

・CubeIDEのバージョンアップやOS間、IDE間の移動に弱い
CubeIDEは、基本的に同一のバージョンで利用することで安定したビルド環境が構築されますが、Makefileで管理すれば、CubeIDEだけでなく、VSCodeや他のIDEでもビルド環境が整います。面倒ですが、コマンドベースでの管理も可能です。

・CubeIDE内のCubeMXが非常に酷なGUI
狭い環境での操作を強要されます。

(FullHDだと、ピン配置を見ながらタイマの設定なんてできたもんじゃないです。)
CubeIDE内のMXではなく、CubeMXを単体で起動することで、ある程度開放されます。

・プロジェクトファイルの管理がGUIベース
インクルードパスなどの設定がEclipseベースGUIのため、ソースで管理しにくいです。

xmlなので、ゴリ押し設定をできなくはないですが、そこまでしてやる意味あるの?と言われてしまうと疑問です。

これらを解決するために、次のような手法を取ることで、より簡単に開発することができます。

方針
①CubeMXでMakefile Projectを作成する
②CubeIDEでEmpty STM32 Projectを作成する
③作成したMakefile ProjectをEmpty STM32 Projectにマージする
④以降、Makefileベースのビルドと、STM32 MCU Debugを利用して開発をすすめる

以下に概要図を載せます。

それでは実際に作ってみましょう。

今回はSTM32G431RBTの載った、NUCLEO-G431RBを使ってLチカをするプロジェクトを実際に作ってみます。

今回は特にバージョンに縛られませんが、以下の環境にて確認致しました。

IDE
STM32CubeIDE
Version: 1.0.0
Build: 2872_20190423-2022 (UTC)
CubeMX
STM32CubeMX
Version: 5.4.0
STM32G431 Firmware
STM32Cube FW_G4 V1.1.0

①Makefile Projectを作成

CubeMXを利用してMakefileのプロジェクトを作成します。

Fileタブ -> New Projectから、マイコンを選ぶ。
今回は「NUCLEO-G431RB」

Start Projectを押すと、「Initialize all peripherals with their default Mode?」の文字が出るので、迷わずYes。
これはマイコンボードの標準の配置に(LEDなどすでにピンが確定しているもの)勝手に配置してくれます。

このページを見ている皆様には釈迦に説法かもしれませんが、このページでピン配置や内部機能を設定することができます。

今回はLチカができれば良いので、何も触らない。

Project Managerタブに移り、ProjectNameを入力。今回は「G431RBMakeProj」とした。
Toolchain/IDEに「Makefile」を入力。

Code Generatorに移り、Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheralにチェックを入れる。これを入れることで、main.cにすべてのイニシャライズコードが記述されず、ソースが分離されるので管理しやすくなる。

ここでGENERATE CODEを押すとMakefile Projectのコードが作られる。

②Empty STM32 Projectを作成

CubeIDEを利用してEmpty STM32 Projectを作成します。
Project Explorer(右クリック)→New->STM32 Project

こちらもNUCLEO-G431RBを選んでNextを押す。

今回はProjectNameを「G431RB_Proj」としました。
Targeted Project TypeにEmptyが選択されていることに注意。

Finishを押すことでプロジェクトが生成されます。
ここでプロジェクト内のすべてを消しておいてください。

③プロジェクトをマージする

作っておいたMakefileのプロジェクトから、Empty プロジェクトへ中身をコピーします。
重複しているものは上書き保存です。

CubeIDEに戻ります。
このままだと、CubeIDEを再起動するまでコピーしたものが見えないので、プロジェクトをリフレッシュします。

最後に、プロジェクトのプロパティ->C/C++ Build -> Builder Settingsから次のように変更します。
・Generate Makefiles automaticallyのチェックを外す。
・Build directoryを次のようにする。(Buildを消す)

これでプロジェクトの設定が終了しました。

本当はこの段階ですべての工程が終了して、正しくビルド・デバッグが動作するはずですが、
CubeMXのいつものガバで正しくビルドができないと思います。
以下の工程は、そのうち必要なくなるかと思います。

④Makefileを修正する

Makefileの中のCPUを次のように直します。

#######################################
# CFLAGS
#######################################
# cpu
CPU = -mcpu=cortex-m4

⑤Lチカする

main関数にLチカコードを記述します。

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */
  

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_LPUART1_UART_Init();
  /* USER CODE BEGIN 2 */

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
		HAL_Delay(500);
		HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
		HAL_Delay(500);
		HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

手順は以上です。お疲れさまでした。

以下から本日作成したソースを取得できます。
トラブルの際にご活用ください。

https://github.com/YutakaNakamura/G431LEDBlinkMakeProj/tree/LEDBlink_with_C/G431RB_Proj

git clone

git clone https://github.com/YutakaNakamura/G431LEDBlinkMakeProj/tree/LEDBlink_with_C/G431RB_Proj -b LEDBlink_with_C

以下に続きを書きました。Makefileを編集してcppのビルドに対応します。