rusefi/firmware
GitHub set-date Action 3f9d0d1dfe Update date 2020-07-06 00:30:06 +00:00
..
ChibiOS@1a2c5967dc Update chibios (#1364) 2020-04-25 16:32:32 -04:00
ChibiOS-Contrib@8f7c2d187b Revert "Fresh generated - auto" 2020-04-18 19:11:47 -04:00
bootloader Convert integration_and_primary_bundle scripts to sh (#1562) 2020-07-03 11:03:50 -04:00
config Auto-generated configs and docs 2020-07-06 00:06:17 +00:00
console plumb new load channels (#1573) 2020-07-05 16:25:19 -04:00
controllers Update date 2020-07-06 00:30:06 +00:00
development connecting time units 2020-05-26 01:08:21 -04:00
docs getting ready for #631 2019-01-27 21:32:41 -05:00
ext
ext_algo
hw_layer docs 2020-07-04 21:38:52 -04:00
iar_egt better file name 2020-05-25 13:02:05 -04:00
init better file name 2020-05-25 13:02:05 -04:00
integration PROTOCOL_SIGNATURE_PREFIX 2020-07-05 20:01:37 -04:00
tunerstudio Auto-generated configs and docs 2020-07-06 00:06:17 +00:00
util idle_min through FSIO not working as intended #1553 2020-07-04 21:32:12 -04:00
.cproject
.gitattributes is this the problem? 2020-06-16 14:19:40 -04:00
.gitignore XML export progress 2020-05-20 01:24:26 -04:00
.project
Doxyfile
DoxygenLayout.xml
Makefile Makefile clean-up 2020-05-25 13:42:55 -04:00
build-notes.txt skeleton & docs (#995) 2019-11-03 08:41:14 -05:00
clean.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
clean.sh Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
clean_build.bat
clean_compile_two_versions.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
clean_compile_two_versions.sh trying to apply same remedy 2020-07-01 18:37:24 -04: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
flash_erase407.bat Convert integration_and_primary_bundle scripts to sh (#1562) 2020-07-03 11:03:50 -04:00
flash_erase407.sh Convert integration_and_primary_bundle scripts to sh (#1562) 2020-07-03 11:03:50 -04:00
flash_erase767.bat
flash_openocd407.bat Convert integration_and_primary_bundle scripts to sh (#1562) 2020-07-03 11:03:50 -04:00
flash_openocd407.sh Convert integration_and_primary_bundle scripts to sh (#1562) 2020-07-03 11:03:50 -04:00
flash_openocd767.bat
flash_reboot_dfu.bat command line switch to DFU 2020-05-08 21:11:11 -04:00
flash_release.bat
gen_config.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
gen_config.sh steps towards Android 2020-07-03 14:53:47 -04:00
gen_config_board.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
gen_config_board.sh Gen config refactor 2 (#1560) 2020-07-02 12:33:31 -04:00
gen_enum_to_string.bat more bash 2020-07-04 21:02:50 -04:00
gen_enum_to_string.sh typo kinetis 2020-07-05 00:20:51 -04:00
gen_firing_order.bat
gen_fsio_example.bat
gen_live_documentation.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
gen_live_documentation.sh Gen config refactor 1 (#1558) 2020-07-02 08:16:18 -04:00
gen_ptrace_enums.bat
gen_signature.sh gen_config new hash (#1561) 2020-07-02 14:19:35 -04:00
gen_system_fsio.bat
gen_trigger_images.bat :) 2020-05-14 20:53:47 -04:00
generate_docs.bat
generate_memory_usage_report.bat
global.h nope, unit tests did not just fix themselves 2020-06-17 08:42:37 -04:00
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 a few unneeded properties 2020-06-13 22:46:10 -04:00
rusefi.h
rusefi.mk
rusefi_rules.mk
svnversion.h poke 2020-07-01 16:14:44 -04:00
update_version.bat Convert jenkins build_extra_bundles scripts to sh (#1554) 2020-07-01 14:09:01 -04:00
update_version.sh fix git command (#1531) 2020-06-22 18:43:01 -04:00

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.