lc4 / canable-fw

Firmware for the CANable USB to CAN adapter

CANable Firmware

This repository contains sources for the slcan CANable firmware, based off of the CANtact firwmare. This firmware may still compile and run on the CANtact.

Supported Commands

• O - Open channel
• C - Close channel
• S0 - Set bitrate to 10k
• S1 - Set bitrate to 20k
• S2 - Set bitrate to 50k
• S3 - Set bitrate to 100k
• S4 - Set bitrate to 125k
• S5 - Set bitrate to 250k
• S6 - Set bitrate to 500k
• S7 - Set bitrate to 750k
• S8 - Set bitrate to 1M
• M0 - Set mode to normal mode (default)
• M1 - Set mode to silent mode
• A0 - Disable automatic retransmission
• A1 - Enable automatic retransmission (default)
• TIIIIIIIILDD... - Transmit data frame (Extended ID) [ID, length, data]
• tIIILDD... - Transmit data frame (Standard ID) [ID, length, data]
• RIIIIIIIIL - Transmit remote frame (Extended ID) [ID, length]
• rIIIL - Transmit remote frame (Standard ID) [ID, length]
• V - Returns firmware version and remote path as a string

Note: Channel configuration commands must be sent before opening the channel. The channel must be opened before transmitting frames.

This firmware currently does not provide any ACK/NACK feedback for serial commands.

Building

Firmware builds with GCC. Specifically, you will need gcc-arm-none-eabi, which is packaged for Windows, OS X, and Linux on Launchpad. Download for your system and add the bin folder to your PATH.

Your Linux distribution may also have a prebuilt package for arm-none-eabi-gcc, check your distro's repositories to see if a build exists.

• If you have a CANable device, you can compile using make.
• If you have a CANtact or other device with external oscillator, you can compile using make INTERNAL_OSCILLATOR=1

Flashing with the Bootloader

Simply plug in your CANable with the BOOT jumper enabled (or depress the boot button on the CANable Pro while plugging in). Next, type make flash and your CANable will be updated to the latest firwmare. Unplug/replug the device after moving the boot jumper back, and your CANable will be up and running.

Debugging

Debugging and flashing can be done with any STM32 Discovery board as a programmer, or an st-link. You can also use other tools that support SWD.

To use an STM32 Discovery, run OpenOCD using the stm32f0x.cfg file: openocd -f fw/stm32f0x.cfg.

With OpenOCD running, arm-none-eabi-gdb can be used to load code and debug.

Contributors

• Ethan Zonca - New features, HAL updates, Makefile fixes and code size optimization, updates for CANable
• onejope - Fixes to extended ID handling
• Phil Wise - Added dfu-util compatibility to Makefile

License

See LICENSE.md