Initial commit of fs-2 bms code

- Update bms code from fs-1 to use mbed os
- Add TartanLlama/optional library for bms
- Add readme with mbed workflow

Author: colescott

.gitignore

@@ -0,0 +1,99 @@
+*.py[cod]
+
+# Distribution dir
+dist
+
+# MANIFEST file
+MANIFEST
+doxygen_objdb_*
+
+# Private settings
+mbed_settings.py
+
+# Default Build Directory
+.build/
+BUILD/
+.mbed
+venv/
+
+# Mbedls
+.mbedls-mock.lock
+
+# Eclipse Project Files
+.cproject
+.project
+.pydevproject
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+nosetests.xml
+.cache
+.hypothesis
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+
+output.txt
+uVision Project/
+
+# Sublime Text Project Files
+*.sublime*
+
+*.bak
+debug.log
+
+# Ignore OS X Desktop Services Store files
+.DS_Store
+
+# Orig diff files
+*.orig
+
+# PyCharm
+*.idea
+
+# Cscope
+cscope.*
+
+# Ctags
+tags
+
+# vim swap files
+*.swp
+*~
+
+# Visual Studio Code
+.vscode/
+
+features/FEATURE_BLE/targets/TARGET_CORDIO/stack_backup/
+
+.pytest_cache
+log
+
+# Icetea related file
+test_suite.json
+
+# default delivery dir
+DELIVERY/

README.md

@@ -0,0 +1,72 @@
+# FS-2
+
+This repo contains all the software for the fs-2 racecar running on mbed os 5 on the LPC1768 microcontroller.
+
+## Projects
+
+- `bms`: LTC6811-based bms code for use with the fs-2 accumulator
+
+## Workflow
+
+The workflow should be used as follows.
+
+### Git
+
+Features/fixes can only be added with a pull request. Branches should be named as follows.
+
+- Fix: `fix/<short description>`
+- Feature: `feature/<short description>`
+
+### Required tools
+- [mbed cli](https://github.com/ARMmbed/mbed-cli)
+- [GNU Arm Embedded Toolchain](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm)
+    - Ubuntu/Debian: `gcc-arm-none-eabi`
+    - Brew: `gcc-arm-embedded`
+    - Nix: `nixpkgs.gcc-arm-embedded`
+- A unix shell
+
+### Installing dependencies
+
+A project's dependencies can be installed by running the following command in the project folder.
+
+```
+mbed update
+```
+
+This will produce warnings about not using source control management. These can be safely ignored.
+
+### Compiling
+
+A project can be compiled using
+
+```
+mbed compile
+```
+
+or if you wish to flash the board after compiling
+
+```
+mbed compile -f
+```
+
+### Connecting to serial terminal
+
+All of our boards use a rate of 115200 baud.
+
+```
+mbed sterm -b 115200
+```
+
+### Adding libraries
+
+Libraries can be added to a project using
+
+```
+mbed add <url>
+```
+
+then the corresponding directory should be added to the `.gitignore` in the project's directory.
+
+### All other issues
+
+For any other issues see the [mbed cli documentation](https://os.mbed.com/docs/mbed-os/v5.15/tools/working-with-mbed-cli.html).

bms/.gitignore

@@ -0,0 +1,2 @@
+mbed-os
+optional

bms/.mbedignore

@@ -0,0 +1 @@
+optional/tests/

bms/mbed-os.lib

@@ -0,0 +1 @@
+https://github.com/ARMmbed/mbed-os/#565ab149819481224ab43f878c3921b14b11d180

bms/mbed_app.json

@@ -0,0 +1,8 @@
+{
+    "target_overrides": {
+        "LPC1768": {
+            "platform.stdio-baud-rate": 115200,
+            "platform.default-serial-baud-rate": 115200
+        }
+    }
+}

bms/optional.lib

@@ -0,0 +1 @@
+https://github.com/TartanLlama/optional/#0dfc7b4e41b1245e47936d6c99bf8e3d80e42b9f

bms/src/BmsConfig.h

@@ -0,0 +1,60 @@
+#pragma once
+
+#include "mbed.h"
+
+extern Serial* serial;
+
+// TODO: So there's an issue here.
+
+// BMS Master Configuration
+
+#define BMS_BANK_COUNT 1
+#define BMS_BANK_CELL_COUNT 7
+#define BMS_BANK_TEMP_COUNT BMS_BANK_CELL_COUNT
+
+#define BMS_FAULT_TEMP_THRESHOLD_HIGH 55
+#define BMS_FAULT_TEMP_THRESHOLD_LOW 0
+
+// Threshold when fault will be thrown for cell voltage
+//
+// Units: millivolts
+#define BMS_FAULT_VOLTAGE_THRESHOLD_HIGH 4200
+#define BMS_FAULT_VOLTAGE_THRESHOLD_LOW 2550
+
+// Threshold when cells will be discharged when discharging is enabled.
+//
+// Units: millivolts
+#define BMS_DISCHARGE_THRESHOLD 15
+
+// IO Configuration
+
+/*
+#define LINE_BMS_FLT PAL_LINE(GPIOB, 0)
+#define LINE_BMS_FLT_LAT PAL_LINE(GPIOF, 1)
+#define LINE_IMD_STATUS PAL_LINE(GPIOF, 0)
+#define LINE_IMD_FLT_LAT PAL_LINE(GPIOA, 8)
+#define LINE_CHARGER_CONTROL PAL_LINE(GPIOB, 1)
+#define LINE_SIG_CURRENT LINE_ARD_A0 // => (GPIOA, 0)
+
+// SPI Configuration
+
+#define BMS_SPI_DRIVER SPID1
+#define BMS_SPI_CR1 (SPI_CR1_BR_2 | SPI_CR1_BR_1)  // Prescalar of 128
+#define BMS_SPI_CR2 (SPI_CR2_DS_2 | SPI_CR2_DS_1 | SPI_CR2_DS_0)  // 8 bits data
+
+#define LINE_SPI_MOSI PAL_LINE(GPIOA, 7)
+#define LINE_SPI_MISO PAL_LINE(GPIOA, 6)
+#define LINE_SPI_SCLK PAL_LINE(GPIOA, 5)
+#define LINE_SPI_SSEL PAL_LINE(GPIOA, 4)
+
+// CAN Configuration
+#define BMS_CAN_DRIVER CAND1
+#define BMS_CAN_CR1 CAN_MCR_ABOM | CAN_MCR_AWUM | CAN_MCR_TXFP
+#define BMS_CAN_CR2 CAN_BTR_SJW(1) | CAN_BTR_TS1(5) | CAN_BTR_TS2(0) | CAN_BTR_BRP(2)
+
+#define LINE_CAN_TX PAL_LINE(GPIOA, 12)
+#define LINE_CAN_RX PAL_LINE(GPIOA, 11)
+*/
+
+// BMS Cell lookup
+const int BMS_CELL_MAP[12] = {0, 1, 2, 3, -1, -1, 4, 5, 6, -1, -1, -1};