Can Opener is an open source cross platform firmware application that implements the Lawicel slcan (Serial CANBUS) protocol using libhal and its ecosystem.

Currently this project only supports SparkFun's MicroMod boards.

Any MicroMod board should work so long as it implements the following APIs:

• hal::micromod::v1::can: Used to communication over CAN.
• hal::micromod::v1::led: Used as an indicator in the application.
• hal::micromod::v1::console: Used to communicate over serial to a host device
• hal::micromod::v1::uptime_clock: Used for telling time
• hal::micromod::v1::reset: Used to reset the device

We provide prebuilt binaries for each of our releases. You can use these to program your microcontroller with the CanOpener firmware.

Steps to upgrade firmware are:

1. Connect CanOpener device to computer using a USB cable.
2. Download CanOpener/0.0.0.
3. Program the device by using the stm-serial-flasher website.
   1. To use this website, click "Select Port"
   2. Then click "Pair New Port" and look for a the serial port for your device. It should have a name like COM8, /dev/ttyUSB2, /dev/ttyACM1, or /dev/tty.serial-1100.
   3. Click the "x" to close the modal screen.
   4. Click "Connect".
   5. Click "Open File" and navigate to where the file was downloaded select it.
   6. Now click "Flash" and wait for the board to be flashed.
   7. Click disconnect.
4. Now go to the CanOpener website and connect your device to the website.
5. You are done 😄

libhal applications use the Conan package manager. To use libhal you will need to install conan. Conan and libhal will handle installing the appropriate compiler and build systems for you. No need to install them yourself.

Follow the "🚀 libhal Getting Started" guide and stop when you reach "🛠️ Building Demos". Come back to this page to continue the build steps. The link to the guide is here.

Download the MicroMod profiles using:

conan config install -sf conan/profiles/v1 -tf profiles https://github.com/libhal/libhal-micromod.git

Download the ARM GCC profiles:

conan config install -tf profiles -sf conan/profiles/v1 https://github.com/libhal/arm-gnu-toolchain.git

To build for the stm32f1 MicroMod v4:

conan build . -pr mod-stm32f1-v4 -pr arm-gcc-12.3 -s build_type=Debug

To build for the lcp40 MicroMod v5:

conan build . -pr mod-lcp40-v5  -pr arm-gcc-12.3  -s build_type=Debug

For the lpc40 v5 board:

nxpprog --device /dev/tty.usbserial-100 --control --cpu lpc4078 --binary build/micromod/mod-lpc40-v5/Debug/app.elf.bin

For the stm32f1 v5 board:

stm32loader -p /dev/tty.usbserial-100 -e -w -v -B build/micromod/mod-stm32f1-v4/Debug/app.elf.bin

For the stm32f1 v4 board:

stm32loader -p /dev/tty.usbserial-100 -e -w -v build/micromod/mod-stm32f1-v4/Debug/app.elf.bin