a2573f5acd
* convert gen_upload_docs.bat * convert run.bat * forgot to add run.sh * convert gen_upload_docs.bat * remove checking from bats * fix path * fix path again * fix file extension * remove escapes * added missing quotation and escapes * add escapes * change config for testing * convert build_current_bundle * convert clean_bootloader * convert compile_bootloader_discovery * convert compile_bootloader * fix path * convert run.sh * fix path again * convert hw_test * convert flash_erase407 * convert flash_openocd407 * fix missing or * fix another missing or * fix quote * add quotes * add more quotes * remove spurious call * add more quotes * convert simulator_test * Add simulator_test * Added semicolon * add exports * change destination path * add quotes and error check * moved rm and changed path back * change path * let the dead be * add env var to skip hw test * redo logic Co-authored-by: David Holdeman <David Holdeman> |
||
---|---|---|
.. | ||
ChibiOS@1a2c5967dc | ||
ChibiOS-Contrib@8f7c2d187b | ||
bootloader | ||
config | ||
console | ||
controllers | ||
development | ||
docs | ||
ext | ||
ext_algo | ||
hw_layer | ||
iar_egt | ||
init | ||
integration | ||
tunerstudio | ||
util | ||
.cproject | ||
.gitattributes | ||
.gitignore | ||
.project | ||
Doxyfile | ||
DoxygenLayout.xml | ||
Makefile | ||
build-notes.txt | ||
clean.bat | ||
clean.sh | ||
clean_build.bat | ||
clean_compile_two_versions.bat | ||
clean_compile_two_versions.sh | ||
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 | ||
flash_dfu.sh | ||
flash_erase407.bat | ||
flash_erase407.sh | ||
flash_erase767.bat | ||
flash_openocd407.bat | ||
flash_openocd407.sh | ||
flash_openocd767.bat | ||
flash_reboot_dfu.bat | ||
flash_release.bat | ||
gen_config.bat | ||
gen_config.sh | ||
gen_config_board.bat | ||
gen_config_board.sh | ||
gen_enum_to_string.bat | ||
gen_enum_to_string.sh | ||
gen_firing_order.bat | ||
gen_fsio_example.bat | ||
gen_live_documentation.bat | ||
gen_live_documentation.sh | ||
gen_ptrace_enums.bat | ||
gen_signature.sh | ||
gen_system_fsio.bat | ||
gen_trigger_images.bat | ||
generate_docs.bat | ||
generate_memory_usage_report.bat | ||
global.h | ||
globalaccess.h | ||
kill_for_coverity.c | ||
license.txt | ||
main.cpp | ||
main_hardfault.c | ||
make4.bat | ||
os_access.h | ||
readme.md | ||
reboot_ecu.bat | ||
run_hw_test.bat | ||
rusefi.cpp | ||
rusefi.h | ||
rusefi.mk | ||
rusefi_rules.mk | ||
svnversion.h | ||
update_version.bat | ||
update_version.sh |
readme.md
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.