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 devicehal::micromod::v1::uptime_clock
: Used for telling timehal::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.
Note
We plan to eliminate this flow once the CanOpener website supports flashing devices. The aim is to provide an "hardware update" button that will flash your device for you. It would present a screen that provides a list of all of the released versions and allow the user to select which one they want to install or simply install the latest..
Steps to upgrade firmware are:
- Connect CanOpener device to computer using a USB cable.
- Download CanOpener/0.0.0.
- Program the device by using the stm-serial-flasher website.
- To use this website, click "Select Port"
- 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
. - Click the "x" to close the modal screen.
- Click "Connect".
- Click "Open File" and navigate to where the file was downloaded select it.
- Now click "Flash" and wait for the board to be flashed.
- Click disconnect.
- Now go to the CanOpener website and connect your device to the website.
- You are done ๐
Warning
If you are not using a CanOpener USB to CAN adaptor board and you are using your own board, then make sure to have the can transceiver connected. Without it connected, some CAN peripherals may hang at initialization and may hang when attempting to transmit a message. If you're device is not working with the CanOpener website, consider checking the state of your CAN transceiver IC or board.
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
Caution
The Release
version of the binary doesn't seem to work well so users should
stick to the Debug
version until this notice is removed.
Important
Make sure to replace the --device
and port -p
(examples uses
/dev/tty.usbserial-100
) serial device paths and names to the correct
ones for your platform.
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