CANable 2.0 Firmware

This repository contains sources for the slcan CANable 2.0 firmware. This firmware implements non-standard slcan commands to support CANFD messaging alongside a LAWICEL-style command set.

Supported Commands

• O - Open channel in normal mode
• L - Open channel in silent mode
• C - Close channel
• S0 - Set nominal bitrate to 10k
• S1 - Set nominal bitrate to 20k
• S2 - Set nominal bitrate to 50k
• S3 - Set nominal bitrate to 100k
• S4 - Set nominal bitrate to 125k (default)
• S5 - Set nominal bitrate to 250k
• S6 - Set nominal bitrate to 500k
• S7 - Set nominal bitrate to 800k
• S8 - Set nominal bitrate to 1M
• sddxxyyzz - Set nominal bitrate and bittiming
• Y0 - Set data bitrate to 500k
• Y1 - Set data bitrate to 1M
• Y2 - Set data bitrate to 2M (default)
• Y4 - Set data bitrate to 4M
• Y5 - Set data bitrate to 5M
• Y8 - Set data bitrate to 8M (If supported by the CAN tranceiver)
• yddxxyyzz - Set data bitrate and bittiming
• riiil - Transmit remote frame (Standard ID) [ID, length]
• Riiiiiiiil - Transmit remote frame (Extended ID) [ID, length]
• tiiildd... - Transmit data frame (Standard ID) [ID, length, data]
• Tiiiiiiiildd... - Transmit data frame (Extended ID) [ID, length, data]
• diiildd... - Transmit CAN FD standard ID (no BRS) [ID, length, data]
• Diiiiiiiildd... - Transmit CAN FD extended ID (no BRS) [ID, length, data]
• biiildd... - Transmit CAN FD BRS standard ID [ID, length, data]
• Biiiiiiiildd... - Transmit CAN FD BRS extended ID [ID, length, data]
• V and v - Returns firmware version and remote path as a string
• N - Returns and sets serial number
• I and i - Returns CAN controller information
• Z and z - Configure reporting mechanism including time stamp and Tx event
• M and m - Configure CAN acceptance filter
• F and f - Returns status flags and detailed status
• Q - Turn on or off auto-startup feature

Please find more information in the doc directory or the wiki.

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

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 or gcc-arm-none-eabi, check your distro's repositories to see if a build exists. Simply compile by running make.

Flashing with the Bootloader

Plug in your CANable2 while boot pins are shorted with jumper. Neither the blue nor the green LED should be illuminated. 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 CANable2 will be up and running.

License

See LICENSE.md