switches to clangd as a language server

.clangd

@@ -0,0 +1,2 @@
+CompileFlags:
+  CompilationDatabase: "firmware/build"

firmware/Makefile

@@ -1,15 +1,20 @@
 PLATFORM =
 PROJECT = 
 
-BUILD_DIR = build/$(PROJECT)/$(PLATFORM)
+BUILD = build
+BUILD_DIR = $(BUILD)/$(PROJECT)/$(PLATFORM)
 CUBEMX_DIR := projects/$(PROJECT)/platforms/$(PLATFORM)/cubemx
 
+COMPILE_COMMANDS_DEST = $(BUILD)/compile_commands.json
+
 build: FORCE
-	cmake -B $(BUILD_DIR) -S. -G"Unix Makefiles" -DPROJECT=$(PROJECT) -DPLATFORM=$(PLATFORM) 
+	cmake -B $(BUILD_DIR) -S. -G"Unix Makefiles" -DPROJECT=$(PROJECT) -DPLATFORM=$(PLATFORM) -D CMAKE_EXPORT_COMPILE_COMMANDS=1
 	cmake --build $(BUILD_DIR)
+	cp $(BUILD_DIR)/compile_commands.json $(COMPILE_COMMANDS_DEST)
 
 clean: FORCE
 	rm -rf $(BUILD_DIR)
+	rm $(COMPILE_COMMANDS_DEST)
 
 deepclean: clean
 ifeq ($(findstring stm32,$(PLATFORM)),stm32)

firmware/README.md

@@ -22,3 +22,9 @@ The following dependecies must be installed __and added to your PATH variable.__
 * STM32CubeMX 6.8.1 - [link](https://www.st.com/en/development-tools/stm32cubemx)
   * Select the 6.8.1 version in the __Get Software__ section.
   * Verify by running `stm32cubemx`. The application should open.
+
+* clangd - [link](https://clangd.llvm.org/installation)
+  * This is our "official" C/C++ language server.
+  * You should also install the __clangd__ extension for your IDE.
+    * If you have the Microsoft __C/C++__ extension installed, disable it for the `racecar` workspace.
+  * Verify with ``clangd --version``.