Add embedded sharepoint, MCP23S17 driver and basic tests

.github/workflows/build-tests_TestBoard_TPS27SA08-Q1.yml

@@ -0,0 +1,35 @@
+name: Build Tests (TestBoard_TPS27SA08-Q1)
+
+on:
+  push:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Initialize Submodules
+        run: git submodule update --init ./firmware/Embedded-Sharepoint
+
+      - name: Cache Nix
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cache/nix
+          key: nix-${{ runner.os }}-${{ hashFiles('flake.lock') }}
+          restore-keys: |
+            nix-${{ runner.os }}-
+
+      - name: Install Nix Action
+        uses: cachix/install-nix-action@v31
+
+      - name: Clean & Build tests
+        run: |
+          nix develop ./firmware/Embedded-Sharepoint/ --accept-flake-config --command bash -c "
+            cd firmware
+            cd TestBoard_TPS27SA08-Q1
+            make clean
+            python test/MakeAllTests_TestBoard_TPS27SA08-Q1.py
+          "

.gitignore

@@ -1,3 +1,6 @@
+# -----------------------------------------------------------------------------
+# HARDWARE (KICAD)
+# -----------------------------------------------------------------------------
 # For PCBs designed using KiCad: https://www.kicad.org/
 # Format documentation: https://kicad.org/help/file-formats/
 
@@ -37,4 +40,36 @@ fp-info-cache
 **/*-backups/*.zip
 
 # Local project settings
-*.kicad_prl
+*.kicad_prl
+
+# -----------------------------------------------------------------------------
+# FIRMWARE
+# -----------------------------------------------------------------------------
+
+# VS Code
+.vscode/
+compile_commands.json
+
+# Build files
+build
+.dockerfile.hash
+.cache
+/can/CANMetaData.*
+Madefile
+
+# Python
+*venv
+__pycache__/
+.env
+
+# Nix
+flake.lock
+
+# Documentation toolset
+docs/doxygen/
+site/*
+!site/empty.a
+Zone.Identifier
+
+# Mac specific files
+.DS_Store

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "hardware/lib/KiCAD-Sharepoint"]
 	path = hardware/lib/KiCAD-Sharepoint
 	url = git@github.com:lhr-solar/KiCAD-Sharepoint.git
+[submodule "firmware/Embedded-Sharepoint"]
+	path = firmware/Embedded-Sharepoint
+	url = https://github.com/lhr-solar/Embedded-Sharepoint.git

firmware/TestBoard_TPS27SA08-Q1/Makefile

@@ -0,0 +1,157 @@
+# CRAZY COLORS ----------------------------------------------------------------
+RED=\033[0;31m
+GREEN=\033[0;32m
+ORANGE=\033[0;33m
+BLUE=\033[0;34m
+PURPLE=\033[0;35m
+CYAN=\033[0;36m
+LIGHTGRAY=\033[0;37m
+DARKGRAY=\033[1;30m
+YELLOW=\033[0;33m
+NC=\033[0m # No Color
+# -----------------------------------------------------------------------------
+
+# generate paths
+MAKEFILE_DIR = $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+# PROJECT CONFIGURATION -------------------------------------------------------
+TEST ?= main
+
+# COMMON TARGETS
+# LSOM: stm32g473xx
+# PSOM: stm32l431cbt
+# FAT NUCLEO: stm32g474xx
+# BAD NUCLEO: stm32l432kcu
+PROJECT_TARGET ?= stm32l432kcu
+
+# SOURCE AND INCLUDE DIRECTORIES
+PROJECT_C_INCLUDES = $(wildcard core/inc) $(wildcard ../driver/inc)
+PROJECT_C_SOURCES = $(wildcard core/src/*.c) $(wildcard ../driver/src/*.c)
+PROJECT_MAIN_DIR ?= core/src
+
+# BUILD DIRECTORIES
+PROJECT_BUILD_DIR = build
+BUILD_MAKEFILE_DIR ?= ../Embedded-Sharepoint
+
+MADEFILE ?= true
+MADEFILE_DIR = ${MAKEFILE_DIR}
+# -----------------------------------------------------------------------------
+
+
+# remove main and add test folders if running test
+ifneq ($(TEST), "main")
+	PROJECT_C_SOURCES := $(filter-out $(PROJECT_MAIN_DIR)/main.c, $(PROJECT_C_SOURCES))
+	PROJECT_C_SOURCES += $(wildcard test/src/${TEST}.c)
+
+	PROJECT_C_INCLUDES += $(wildcard test/inc)
+endif
+
+# Convert relative paths to absolute paths for passing to Embedded-Sharepoint build
+PROJECT_C_SOURCES := $(addprefix $(MAKEFILE_DIR)/, $(PROJECT_C_SOURCES))
+PROJECT_C_INCLUDES := $(addprefix $(MAKEFILE_DIR)/, $(PROJECT_C_INCLUDES))
+
+# Debug
+PRINT_DEBUG ?= true
+
+ifeq ($(PRINT_DEBUG), true)
+$(info SOURCES: $(PROJECT_C_SOURCES))
+$(info INCLUDES: $(PROJECT_C_INCLUDES))
+endif
+
+# generate paths (cont.d)
+PROJECT_BUILD_DIR := $(addprefix $(MAKEFILE_DIR)/, $(PROJECT_BUILD_DIR))
+
+# export variables 
+export PROJECT_TARGET
+export PROJECT_C_SOURCES
+export PROJECT_C_INCLUDES
+export PROJECT_BUILD_DIR
+
+
+# -----------------------------------------------------------------------------
+# Clang
+BEAR_PREFIX := 
+# check if bear is installed
+BEAR_INSTALLED := $(shell command -v bear >/dev/null 2>&1 && echo yes || echo no)
+
+# define path of .vscode (create if missing)
+VS_CODE_DIR := $(MAKEFILE_DIR)/.vscode
+$(shell mkdir -p $(VS_CODE_DIR))
+
+ifeq ($(BEAR_INSTALLED),yes)
+BEAR_PREFIX := bear --output $(VS_CODE_DIR)/compile_commands.json --append --
+endif
+# -----------------------------------------------------------------------------
+
+
+# BUILD -----------------------------------------------------------------------
+ifeq ($(MAKECMDGOALS),)
+default: build_code
+else ifeq ($(MAKECMDGOALS), all)
+all: build_code
+else
+%:
+	$(BEAR_PREFIX) $(MAKE) -C $(BUILD_MAKEFILE_DIR) $(MAKECMDGOALS)
+endif
+
+
+build_code:
+ifeq ($(MADEFILE), true)
+	@echo -e "Make initiated at $(shell date)\n" > ${MADEFILE_DIR}/Madefile
+endif
+
+ifneq ($(TEST), main)
+	@echo -e "Making ${PURPLE}$(PROJECT_TARGET)${NC}build for ${BLUE}TEST=${PURPLE}${TEST}${NC}"
+    ifeq ($(MADEFILE), true)
+		@echo -e "Making $(PROJECT_TARGET) build for TEST=${TEST}\n" >> ${MADEFILE_DIR}/Madefile
+    endif
+else
+	@echo -e "Making ${PURPLE}$(PROJECT_TARGET)${NC}build with ${ORANGE}main.${NC}"
+    ifeq ($(MADEFILE), true)
+		@echo -e "Making $(PROJECT_TARGET) build with main.\n" >> ${MADEFILE_DIR}/Madefile
+    endif
+endif
+
+ifeq ($(MADEFILE), true)
+	@set -o pipefail; if $(BEAR_PREFIX) $(MAKE) -C $(BUILD_MAKEFILE_DIR) all -j | tee -a ${MADEFILE_DIR}/Madefile; then \
+		echo -e "${GREEN}Compiled! Splendid! Jolly Good!!!\n${NC}"; \
+		echo -e "\nCompiled! Splendid! Jolly Good!!\n" >> ${MADEFILE_DIR}/Madefile; \
+	else \
+		echo -e "${RED}Build failure.\n${NC}"; \
+		echo -e "\nBuild failure.\n" >> ${MADEFILE_DIR}/Madefile; \
+		exit 1; \
+	fi
+else
+	@set -o pipefail; if $(BEAR_PREFIX) $(MAKE) -C $(BUILD_MAKEFILE_DIR) all -j; then \
+		echo -e "${GREEN}Compiled! Splendid! Jolly Good!!!\n${NC}"; \
+	else \
+		echo -e "${RED}Build failure.\n${NC}"; \
+		exit 1; \
+	fi
+endif
+# -----------------------------------------------------------------------------
+
+
+# FLASH -----------------------------------------------------------------------
+flash:
+	@set -o pipefail; if $(MAKE) -C $(BUILD_MAKEFILE_DIR) flash; then \
+		echo -e "${GREEN}Flash successful.\n${NC}"; \
+	else \
+		echo -e "${RED}Flash failure.\n${NC}"; \
+		exit 1; \
+	fi
+# -----------------------------------------------------------------------------
+
+
+# CLEAN -----------------------------------------------------------------------
+clean:
+	$(MAKE) -C $(BUILD_MAKEFILE_DIR) clean
+	-rm -fR $(MADEFILE_DIR)/Madefile
+# -----------------------------------------------------------------------------
+
+
+# DOCUMENTATION ---------------------------------------------------------------
+# .PHONY: docs
+# docs:
+# 	cd $(BUILD_MAKEFILE_DIR) && mkdocs serve
+# -----------------------------------------------------------------------------

firmware/TestBoard_TPS27SA08-Q1/core/inc/TestBoard_TPS27SA08-Q1_Pins.h

@@ -0,0 +1,14 @@
+#define LED_PIN GPIO_PIN_3
+#define LED_PORT GPIOB
+#define LED_CLOCK_INIT() __HAL_RCC_GPIOB_CLK_ENABLE();
+
+#define VCP_TX_PIN GPIO_PIN_2
+#define VCP_TX_PORT GPIOA
+#define VCP_RX_PIN GPIO_PIN_15
+#define VCP_RX_PORT GPIOA
+
+#define GPIOEXP_CS_PIN GPIO_PIN_3
+#define GPIOEXP_CS_PORT GPIOA
+
+#define GPIOEXP_INTA_PIN GPIO_PIN_5
+#define GPIOEXP_INTA_PORT GPIOA

firmware/TestBoard_TPS27SA08-Q1/core/inc/TestBoard_TPS27SA08-Q1_SPI.h

@@ -0,0 +1,28 @@
+#include "stm32xx_hal.h"
+
+extern SPI_HandleTypeDef hspi1;
+
+/**
+  * @brief SPI1 Initialization Function
+  * @param None
+  * @retval None
+  */
+void MX_SPI1_Init(void);
+
+/**
+  * @brief SPI MSP Initialization
+  * This function configures the hardware resources used in this example
+  * @param hspi: SPI handle pointer
+  * @retval None
+  */
+void HAL_SPI_MspInit(SPI_HandleTypeDef* hspi);
+
+/**
+  * @brief SPI MSP De-Initialization
+  * This function freeze the hardware resources used in this example
+  * @param hspi: SPI handle pointer
+  * @retval None
+  */
+void HAL_SPI_MspDeInit(SPI_HandleTypeDef* hspi);
+
+bool SPI_Init_Dummy_Send(SPI_HandleTypeDef* spi, SemaphoreHandle_t spi2_mutex, SemaphoreHandle_t spi2_done_sem);

firmware/TestBoard_TPS27SA08-Q1/core/inc/TestBoard_TPS27SA08-Q1_UART.h

@@ -0,0 +1,27 @@
+#include "stm32xx_hal.h"
+#include "TestBoard_TPS27SA08-Q1_Pins.h"
+
+extern UART_HandleTypeDef huart2;
+
+/**
+  * @brief USART2 Initialization Function
+  * @param None
+  * @retval None
+  */
+void MX_USART2_UART_Init(void);
+
+/**
+  * @brief UART MSP Initialization
+  * This function configures the hardware resources used in this example
+  * @param huart: UART handle pointer
+  * @retval None
+  */
+void HAL_UART_MspGPIOInit(UART_HandleTypeDef* huart);
+
+/**
+  * @brief UART MSP De-Initialization
+  * This function freeze the hardware resources used in this example
+  * @param huart: UART handle pointer
+  * @retval None
+  */
+void HAL_UART_MspGPIODeInit(UART_HandleTypeDef* huart);