usage: waf [commands] [options]
Main commands (example: ./waf build -j4)
bootstrap_library_project : creates a library project
build : executes the build
build_all : builds all variants
build_app_doxygen : builds the doxygen documentation for the app
build_app_spa_ti_arm_cgt : builds the SPA artifact of the app in TI ARM CGT configuration
build_app_ti_arm_cgt : builds the binary of the app for the target
build_app_unit_test_doxygen : builds the doxygen documentation for the app's unit tests
build_app_unit_test_gcc : builds the unit tests for the app on the host
build_app_unit_test_spa_gcc : builds the SPA artifact of the unit tests of the app
build_bootloader_doxygen : builds the doxygen documentation for the bootloader
build_bootloader_spa_ti_arm_cgt : builds the SPA artifact of the bootloader in TI ARM CGT configuration
build_bootloader_ti_arm_cgt : builds the binary of the bootloader for the target
build_bootloader_unit_test_doxygen : builds the doxygen documentation for the bootloader's unit tests
build_bootloader_unit_test_gcc : builds the unit tests for the bootloader on the host
build_bootloader_unit_test_spa_gcc : builds the SPA artifact of the unit tests of the bootloader
build_bootloader_unit_test_ti_arm_cgt: builds the unit tests of the bootloader for the target
build_docs : builds the general documentation
clean : cleans the project
clean_all : cleans all variants
clean_app_doxygen : cleans the doxygen documentation for the app
clean_app_spa_ti_arm_cgt : cleans the SPA artifact of the app in TI ARM CGT configuration
clean_app_ti_arm_cgt : cleans the binary of the app for the target
clean_app_unit_test_doxygen : cleans the doxygen documentation for the app's unit tests
clean_app_unit_test_gcc : cleans the unit tests for the app on the host
clean_app_unit_test_spa_gcc : cleans the SPA artifact of the unit tests of the app
clean_bootloader_doxygen : cleans the doxygen documentation for the bootloader
clean_bootloader_spa_ti_arm_cgt : cleans the SPA artifact of the bootloader in TI ARM CGT configuration
clean_bootloader_ti_arm_cgt : cleans the binary of the bootloader for the target
clean_bootloader_unit_test_doxygen : cleans the doxygen documentation for the bootloader's unit tests
clean_bootloader_unit_test_gcc : cleans the unit tests for the bootloader on the host
clean_bootloader_unit_test_spa_gcc : cleans the SPA artifact of the unit tests of the bootloader
clean_bootloader_unit_test_ti_arm_cgt: cleans the unit tests of the bootloader for the target
clean_docs : Custom clean command that removes generated documentation artifacts.
configure : configures the project
dist : makes a tarball for redistributing the sources
distcheck : checks if the project compiles (tarball from 'dist')
distclean : removes build folders and data
list : lists the targets to execute
list_app_spa_ti_arm_cgt : lists the SPA artifact of the app in TI ARM CGT configuration
list_app_ti_arm_cgt : lists the binary of the app for the target
list_app_unit_test_gcc : lists the unit tests for the app on the host
list_app_unit_test_spa_gcc : lists the SPA artifact of the unit tests of the app
list_bootloader_spa_ti_arm_cgt : lists the SPA artifact of the bootloader in TI ARM CGT configuration
list_bootloader_ti_arm_cgt : lists the binary of the bootloader for the target
list_bootloader_unit_test_gcc : lists the unit tests for the bootloader on the host
list_bootloader_unit_test_spa_gcc : lists the SPA artifact of the unit tests of the bootloader
list_bootloader_unit_test_ti_arm_cgt : lists the unit tests of the bootloader for the target
step : executes tasks in a step-by-step fashion, for debugging
step_app_spa_ti_arm_cgt : steps the SPA artifact of the app in TI ARM CGT configuration
step_app_ti_arm_cgt : steps the binary of the app for the target
step_app_unit_test_gcc : steps the unit tests for the app on the host
step_app_unit_test_spa_gcc : steps the SPA artifact of the unit tests of the app
step_bootloader_spa_ti_arm_cgt : steps the SPA artifact of the bootloader in TI ARM CGT configuration
step_bootloader_ti_arm_cgt : steps the binary of the bootloader for the target
step_bootloader_unit_test_gcc : steps the unit tests for the bootloader on the host
step_bootloader_unit_test_spa_gcc : steps the SPA artifact of the unit tests of the bootloader
step_bootloader_unit_test_ti_arm_cgt : steps the unit tests of the bootloader for the target
vscode : Entry point that chains all VS Code workspace generation commands.
vscode_app_ti_arm_cgt : Generate the embedded app VS Code workspace configuration.
vscode_app_unit_test_gcc : Generate the app unit test VS Code workspace configuration.
vscode_bootloader_ti_arm_cgt : Generate the embedded bootloader VS Code workspace configuration.
vscode_bootloader_unit_test_gcc : Generate the bootloader unit test VS Code workspace configuration.
vscode_cli : Generate the CLI VS Code workspace configuration.
vscode_generic : Generate the generic VS Code workspace configuration.
options:
-c, --color {yes,no,auto}
whether to use colors (yes/no/auto) [default: auto]
-j, --jobs JOBS amount of parallel jobs (12)
-k, --keep continue despite errors (-kk to try harder)
-v, --verbose verbosity level -v -vv or -vvv [default: 0]
--zones ZONES debugging zones (task_gen, deps, tasks, etc)
-h, --help show this help message and exit
--version show the Waf version and exit
--extcmd activate external command display for Doxygen
--doxygen-timeout DOXYGEN_TIMEOUT
set the Doxygen timeout in seconds
--run-nm Run nm tool on object and linked files.
--run-size Run size tool on object and linked files.
--preprocess-files activating C file preprocessing
--generate-listings activating generation of listings for C files
--coverage activating code coverage with gcov
--confcache Use a configuration cache
--lauterbach-installation-directory LAUTERBACH_BASE
Installation directory of Lauterbach tools
--lauterbach-use-tcp Use TCP as connection for the debugger.
--notests Exec no unit tests
--alltests Exec all unit tests
--clear-failed Force failed unit tests to run again next time
--testcmd TESTCMD Run the unit tests using the test-cmd string. For example --testcmd="valgrind --error-exitcode=1 %s" to run under valgrind
--dump-test-scripts Create python scripts to help debug tests
Build and installation options:
-p, --progress -p: progress bar; -pp: ide output
--targets TARGETS task generators, e.g. "target1,target2"
Step options:
--files FILES files to process, by regexp, e.g. "*/main.c,*/test/main.o"
Installation and uninstallation options:
--distcheck-args ARGS
arguments to pass to distcheck
