Adds Logger and Device Loop

.clang-format

@@ -1,8 +1,6 @@
 ---
 
-# provide suggestions based on Google's Style Guide
-# see https://google.github.io/styleguide/cppguide.html
-BasedOnStyle: Google
+AccessModifierOffset: -3
 
 AlignAfterOpenBracket: true
 
@@ -30,6 +28,10 @@ AllowShortLoopsOnASingleLine: true
 
 AlwaysBreakBeforeMultilineStrings: true
 
+# provide suggestions based on Google's Style Guide
+# see https://google.github.io/styleguide/cppguide.html
+BasedOnStyle: Google
+
 # see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#binpackarguments
 BinPackArguments: false
 BinPackParameters: false
@@ -61,12 +63,21 @@ IndentWidth: 4
 # see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#language
 Language: Cpp
 
+# see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#lineending
+LineEnding: LF
+
 # see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#reflowcomments
 ReflowComments: false
 
 # see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#removeparentheses
 RemoveParentheses: MultipleParentheses
 
+# see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#removesemicolon
 RemoveSemicolon: True
 
+# TODO: update this to `c++23` when it becomes available
+# see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#standard
+Standard: c++20
+
+# see https://clang.llvm.org/docs/ClangFormatStyleOptions.html#usetab
 UseTab: Never

.clangd

@@ -1,25 +1,6 @@
 # see https://clangd.llvm.org/config#if
 If:
-    PathMatch: *
-
-# see https://clangd.llvm.org/config#compileflags
-CompileFlags:
-    Add:
-
+  PathMatch: *
 CompileFlags:
   Add:
-    # ⚠️ If these values are updated, they MUST be updated project-wide
-    - -I.arduino/user/libraries/
-
-    - -I.arduino/data/packages/arduino/hardware/avr/1.8.6/libraries/
-    - -I.arduino/data/internal/arduino_avr_1.8.6_*/cores/arduino/
-    - -I.arduino/data/internal/arduino_avr_1.8.6_*/variants/standard/
-
-    - -I.arduino/data/packages/esp32/hardware/esp32/2.0.17/libraries/
-    - -I.arduino/data/internal/esp32_esp32_2.0.17_*cores/esp32/
-    - -I.arduino/data/internal/esp32_esp32_2.0.17_*variants/esp32/
-
-    - -DARDUINO_ESP32_DEV
-    - -DARDUINO_ARCH_ESP32
-    - -DARDUINO_BOARD="ESP32_DEV"
-    - -DESP32
+    - "-I${HOME}/Library/Arduino15/packages/esp32/hardware/esp32/2.0.17/cores/esp32"

.gitignore

@@ -9,3 +9,9 @@ cmake-build-debug
 ### Project-specific ###
 .doxygen/theme
 docs/
+
+### MacOS sucks
+**/*.DS_Store
+
+### VS CODE
+.history

CMakeLists.txt

@@ -1,5 +1,5 @@
 # see https://cmake.org/cmake/help/v3.30/command/cmake_minimum_required.html
-cmake_minimum_required(VERSION 3.30.0)
+cmake_minimum_required(VERSION 3.29.0)
 
 # see https://cmake.org/cmake/help/v3.30/command/project.html#project
 project(
@@ -9,37 +9,32 @@ project(
     LANGUAGES CXX
 )
 
-# see https://docs.espressif.com/projects/esp-idf/en/v3.30/esp32s3/api-guides/cplusplus.html
-# and https://cmake.org/cmake/help/v3.30/command/set.html
-set(CMAKE_CXX_STANDARD 11)
+# see https://cmake.org/cmake/help/latest/variable/CMAKE_LANG_CLANG_TIDY.html
+set(CMAKE_CXX_CLANG_TIDY clang-tidy -checks=-*,readability-*)
+
+# see https://docs.espressif.com/projects/esp-idf/en/stable/esp32s3/api-guides/cplusplus.html
+set(CMAKE_CXX_STANDARD 23)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
 
 # generate `compile_commands.json` for use with `clangd`
-# see https://cmake.org/cmake/help/v3.30/command/set.html
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
-# set common paths
-# see https://cmake.org/cmake/help/v3.30/command/set.html
 # ⚠️ If this value is updated, it MUST be updated project-wide
 set(ARDUINO_BASE_PATH .arduino)
 
-# see https://cmake.org/cmake/help/v3.30/command/set.html
-set(ARDUINO_DATA_PATH ${ARDUINO_BASE_PATH}/data/packages)
-set(ARDUINO_LIBS_PATH ${ARDUINO_BASE_PATH}/user/libraries)
-
-# set Arduino library version
-# see https://cmake.org/cmake/help/v3.30/command/set.html
+# set Arduino and ESP32 library versions
+# ⚠️ If these values are updated, they MUST be updated project-wide
 set(ARDUINO_LIBRARY_VERSION 1.8.6)
-
-# set ESP32 library version
-# ⚠️ If this value is updated, it MUST be updated project-wide
-# see https://cmake.org/cmake/help/v3.30/command/set.html
 set(ESP32_LIBRARY_VERSION 2.0.17)
 
 # see https://cmake.org/cmake/help/v3.30/command/include_directories.html
 include_directories(
-    ${ARDUINO_LIBS_PATH}
-    ${ARDUINO_DATA_PATH}/arduino/hardware/avr/${ARDUINO_LIBRARY_VERSION}/libraries
-    ${ARDUINO_DATA_PATH}/esp32/hardware/esp32/${ESP32_LIBRARY_VERSION}/libraries
+    SYSTEM ${ARDUINO_BASE_PATH}/data/packages/arduino/hardware/avr/${ARDUINO_LIBRARY_VERSION}/cores/arduino
+    SYSTEM ${ARDUINO_BASE_PATH}/data/packages/arduino/hardware/avr/${ARDUINO_LIBRARY_VERSION}/libraries
+    SYSTEM ${ARDUINO_BASE_PATH}/data/packages/esp32/hardware/esp32/${ESP32_LIBRARY_VERSION}/cores/esp32
+    SYSTEM ${ARDUINO_BASE_PATH}/user/libraries
+    SYSTEM ${ARDUINO_BASE_PATH}/data/packages/esp32/hardware/esp32/${ESP32_LIBRARY_VERSION}/libraries
 )
 
 # include all source files in the `src` directory
@@ -49,6 +44,10 @@ file(GLOB_RECURSE SOURCES "src/*.cpp" "src/*.h")
 # see https://cmake.org/cmake/help/v3.30/command/add_executable.html
 add_executable(pathfinder pathfinder.ino ${SOURCES})
 
+# ignore warning about literal suffixes, specifically for `libraries/Insights/src/Insights.cpp:8`
+# see https://cmake.org/cmake/help/v3.30/command/add_compile_options.html
+add_compile_options(-Wno-literal-suffix)
+
 # explicitly specify language as CXX (C++)
 # see https://cmake.org/cmake/help/v3.30/command/set_target_properties.html
 set_target_properties(pathfinder PROPERTIES LINKER_LANGUAGE CXX)

CPPLINT.cfg

@@ -1,13 +1,11 @@
 # consider this the most top-level configuration file
 set noparent
 
-# scan all relevant files
+# scan Arduino source files
 extensions=ino
 
 # `build/include_order` - ignore checks for include order until false positives are resolved
 # `legal/copyright`     - ignore checks for absence of copyright notices
 filter=-build/include_order,-legal/copyright
 
-linelength=140
-
 root=.