rusefi/firmware
rusefi 36ec8e565f start/stop progress 2020-03-25 01:41:15 -04:00
..
.vscode vscode usability (#938) 2019-09-16 07:07:42 -04:00
ChibiOS@85cf4582a9 different handling of SD card loss 2019-09-21 12:40:40 -04:00
ChibiOS-Contrib@8f7c2d187b we might not use Contrib at the moment 2019-09-22 09:56:47 -04:00
bootloader save some ram (#1211) 2020-03-22 19:06:29 -04:00
config startStopDialog 2020-03-25 00:58:59 -04:00
console launch control #203 2020-03-24 19:55:12 -04:00
controllers start/stop progress 2020-03-25 01:41:15 -04:00
development Remove old monitoring timestamps (#1217) 2020-03-24 20:19:19 -04:00
docs
ext
ext_algo
hw_layer Remove old monitoring timestamps (#1217) 2020-03-24 20:19:19 -04:00
iar_egt
init Proxy sensor for extra magic (#1210) 2020-03-22 17:29:01 -04:00
integration startStopDialog 2020-03-25 00:58:59 -04:00
tunerstudio startStopDialog 2020-03-25 00:58:59 -04:00
util fine 2020-03-24 16:46:36 -04:00
.cproject
.gitignore
.project
Doxyfile add sensor framework, tests (#929) 2019-09-21 14:33:38 -04:00
DoxygenLayout.xml
Makefile proteus-f4 was requested 2020-03-18 11:37:53 -04:00
build-notes.txt skeleton & docs (#995) 2019-11-03 08:41:14 -05:00
clean.bat
clean_build.bat
clean_compile_two_versions.bat Remove chibios trace flag (#1037) 2019-12-02 19:11:07 -05:00
compile.bat
compile_and_program.bat
cov_config.bat
cov_run.bat
coverity.yml
dump.bat
dump_iar.bat
dump_release.bat
egt2can.cpp
exception.txt
flash.bat
flash_dfu.bat notes to self 2019-12-16 01:47:34 -05:00
flash_dfu.sh A Unix shell script matching the functionality flash_dfu.bat 2019-11-11 20:25:55 -05:00
flash_erase407.bat
flash_erase767.bat
flash_openocd407.bat
flash_openocd767.bat
flash_release.bat
gen_config.bat more Proteus CI 2020-02-02 08:42:05 -05:00
gen_config.sh scripts: add gen_config, gen_config_board and gen_enum_to_string for Linux (#1081) 2020-01-02 18:58:28 -05:00
gen_config_board.bat
gen_config_board.sh scripts: add gen_config, gen_config_board and gen_enum_to_string for Linux (#1081) 2020-01-02 18:58:28 -05:00
gen_enum_to_string.bat
gen_enum_to_string.sh scripts: add gen_config, gen_config_board and gen_enum_to_string for Linux (#1081) 2020-01-02 18:58:28 -05:00
gen_firing_order.bat firing order tool integration 2019-11-24 23:49:05 -05:00
gen_fsio_example.bat
gen_live_documentation.bat better script name 2020-02-22 15:38:21 -05:00
gen_ptrace_enums.bat PerfTraceTool 2019-11-25 00:57:36 -05:00
gen_system_fsio.bat
gen_trigger_images.bat
generate_docs.bat
generate_memory_usage_report.bat
global.h Dont cache dma buffers (#1110) 2020-01-29 00:32:43 -05:00
globalaccess.h happy new year 2020-01-08 00:02:40 -05:00
kill_for_coverity.c
license.txt
main.cpp happy new year unification 2020-01-13 21:57:43 -05:00
main_hardfault.c This black magic improves hard fault debugging experience 2019-09-22 21:28:19 -04:00
make4.bat
os_access.h happy new year 2020-01-08 00:02:40 -05:00
readme.md skeleton & docs (#995) 2019-11-03 08:41:14 -05:00
reboot_ecu.bat
run_hw_test.bat docs :( 2019-12-21 19:50:16 -05:00
rusefi.cpp happy new year unification 2020-01-13 21:57:43 -05:00
rusefi.h code style 2020-01-26 13:58:47 -05:00
rusefi.mk remove (#1188) 2020-03-13 17:19:29 -04:00
rusefi_rules.mk Fix master (#1134) 2020-02-08 16:34:29 -05:00
svnversion.h poke CI 2020-02-21 19:50:43 -05:00
update_version.bat

readme.md

Doxygen

Q&A on source code

See also ../unit_tests

This directory contains the source code for the RusEFI firmware.

The ideal is that typical end users should be able to use pre-built firmware. They should not need to modify or even rebuild from the source code for basic use, but building from the source code provides the opportunity for optimization, supporting unexpected engine configurations, and specialized enhancements.

TL;DR

make PROJECT_BOARD=microrusefi PROJECT_CPU=ARCH_STM32F4

Environment

Rebuilding from source code requires this firmware, a modern C/C++ compiler for embedded ARM systems, and a platform that supports 'make' based builds.

While many compilers have the potential to work, we suggest using the official ARM version of GCC available at launchpad.net.

Linux and MacOS systems should have the software development tools, primarily 'make', pre-installed or readily installed. MS-Windows requires selecting and installing a Unix-compatible system environment.

Note that the developers are volunteers, with varied motivations. These motivations often include using leading-edge language and build system concepts, requiring recent versions of tools. Should you encounter build problems, review the latest version of this document.

Expected Future Changes

The firmware build is moving toward a system that separates board features from processor features. This will require specifying both the board type and specific processor.

The existing system evolved based on the original RusEFI boards. Those used 'STM32 Discovery' development boards plugged into base boards that held the ECU-specific chips. That approach resulted in hard-coded assumption about pin assignments, and associations of hardware with a specific processor variant. That legacy is slowly being cleaned up, but is still evident in some settings and limitations.