From cf4575b94a3c65e6535a159fc71fc885aebc2620 Mon Sep 17 00:00:00 2001 From: Drashna Jaelre Date: Fri, 2 Aug 2019 14:02:40 -0700 Subject: Fix the LUFA lib to use a submodule instead of just files (#6245) * Remove LUFA files * Update descriptions for newer version of LUFA * Create PR6245.md * Fix CDC(Serial) type errors * Fix missed merge conflict for AUDIO_DTYPE_CSInterface --- lib/lufa/LUFA/Build/DMBS/.gitignore | 9 - .../DMBS/HID_EEPROM_Loader/HID_EEPROM_Loader.c | 39 --- .../Build/DMBS/DMBS/HID_EEPROM_Loader/makefile | 35 --- lib/lufa/LUFA/Build/DMBS/DMBS/License.txt | 32 --- lib/lufa/LUFA/Build/DMBS/DMBS/ModulesOverview.md | 38 --- .../LUFA/Build/DMBS/DMBS/WritingYourOwnModules.md | 95 ------- lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md | 119 --------- lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.mk | 68 ----- lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.md | 124 ---------- lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.mk | 52 ---- lib/lufa/LUFA/Build/DMBS/DMBS/core.md | 136 ---------- lib/lufa/LUFA/Build/DMBS/DMBS/core.mk | 147 ----------- lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.md | 134 ---------- lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.mk | 66 ----- lib/lufa/LUFA/Build/DMBS/DMBS/dfu.md | 122 --------- lib/lufa/LUFA/Build/DMBS/DMBS/dfu.mk | 62 ----- lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.md | 118 --------- lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.mk | 62 ----- lib/lufa/LUFA/Build/DMBS/DMBS/gcc.md | 211 ---------------- lib/lufa/LUFA/Build/DMBS/DMBS/gcc.mk | 273 --------------------- lib/lufa/LUFA/Build/DMBS/DMBS/hid.md | 129 ---------- lib/lufa/LUFA/Build/DMBS/DMBS/hid.mk | 57 ----- lib/lufa/LUFA/Build/DMBS/Readme.md | 123 ---------- lib/lufa/LUFA/Build/DMBS/Template/Template.c | 12 - lib/lufa/LUFA/Build/DMBS/Template/makefile | 32 --- lib/lufa/LUFA/Build/LUFA/lufa-gcc.mk | 43 ---- lib/lufa/LUFA/Build/LUFA/lufa-sources.mk | 95 ------- lib/lufa/LUFA/Build/lufa_atprogram.mk | 10 - lib/lufa/LUFA/Build/lufa_avrdude.mk | 10 - lib/lufa/LUFA/Build/lufa_build.mk | 12 - lib/lufa/LUFA/Build/lufa_core.mk | 10 - lib/lufa/LUFA/Build/lufa_cppcheck.mk | 10 - lib/lufa/LUFA/Build/lufa_dfu.mk | 10 - lib/lufa/LUFA/Build/lufa_doxygen.mk | 10 - lib/lufa/LUFA/Build/lufa_hid.mk | 10 - lib/lufa/LUFA/Build/lufa_sources.mk | 10 - 36 files changed, 2525 deletions(-) delete mode 100644 lib/lufa/LUFA/Build/DMBS/.gitignore delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/HID_EEPROM_Loader.c delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/makefile delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/License.txt delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/ModulesOverview.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/WritingYourOwnModules.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/core.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/core.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/dfu.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/dfu.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/gcc.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/gcc.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/hid.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/DMBS/hid.mk delete mode 100644 lib/lufa/LUFA/Build/DMBS/Readme.md delete mode 100644 lib/lufa/LUFA/Build/DMBS/Template/Template.c delete mode 100644 lib/lufa/LUFA/Build/DMBS/Template/makefile delete mode 100644 lib/lufa/LUFA/Build/LUFA/lufa-gcc.mk delete mode 100644 lib/lufa/LUFA/Build/LUFA/lufa-sources.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_atprogram.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_avrdude.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_build.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_core.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_cppcheck.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_dfu.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_doxygen.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_hid.mk delete mode 100644 lib/lufa/LUFA/Build/lufa_sources.mk (limited to 'lib/lufa/LUFA/Build') diff --git a/lib/lufa/LUFA/Build/DMBS/.gitignore b/lib/lufa/LUFA/Build/DMBS/.gitignore deleted file mode 100644 index 938768908a..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/.gitignore +++ /dev/null @@ -1,9 +0,0 @@ -*.lss -*.bin -*.elf -*.hex -*.eep -*.map -*.o -*.d -*.sym diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/HID_EEPROM_Loader.c b/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/HID_EEPROM_Loader.c deleted file mode 100644 index 35ea2d79b7..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/HID_EEPROM_Loader.c +++ /dev/null @@ -1,39 +0,0 @@ -/* - DMBS Build System - Released into the public domain. - - dean [at] fourwalledcubicle [dot] com - www.fourwalledcubicle.com - */ - -/** \file - * - * Special application to extract an EEPROM image stored in FLASH memory, and - * copy it to the device EEPROM. This application is designed to be used with - * the HID build system module of DMBS to program the EEPROM of a target device - * that uses the HID bootloader protocol, which does not have native EEPROM - * programming support. - */ - -#include -#include -#include - -/* References to the binary EEPROM data linked in the AVR's FLASH memory space */ -extern const char _binary_InputEEData_bin_start[]; -extern const char _binary_InputEEData_bin_end[]; -extern const char _binary_InputEEData_bin_size[]; - -/* Friendly names for the embedded binary data stored in FLASH memory space */ -#define InputEEData _binary_InputEEData_bin_start -#define InputEEData_size ((int)_binary_InputEEData_bin_size) - -int main(void) -{ - /* Copy out the embedded EEPROM data from FLASH to EEPROM memory space */ - for (uint16_t i = 0; i < InputEEData_size; i++) - eeprom_update_byte((uint8_t*)i, pgm_read_byte(&InputEEData[i])); - - /* Infinite loop once complete */ - for (;;); -} diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/makefile b/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/makefile deleted file mode 100644 index 879eda8cf2..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/HID_EEPROM_Loader/makefile +++ /dev/null @@ -1,35 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -# Run "make help" for target help. - -MCU = atmega128 -ARCH = AVR8 -F_CPU = 1000000 -OPTIMIZATION = s -TARGET = HID_EEPROM_Loader -SRC = $(TARGET).c -CC_FLAGS = -LD_FLAGS = -OBJECT_FILES = InputEEData.o - -# Default target -all: - -# Determine the AVR sub-architecture of the build main application object file -FIND_AVR_SUBARCH = avr$(shell avr-objdump -f $(TARGET).o | grep architecture | cut -d':' -f3 | cut -d',' -f1) - -# Create a linkable object file with the input binary EEPROM data stored in the FLASH section -InputEEData.o: InputEEData.bin $(TARGET).o $(MAKEFILE_LIST) - @echo $(MSG_OBJCPY_CMD) Converting \"$<\" to a object file \"$@\" - avr-objcopy -I binary -O elf32-avr -B $(call FIND_AVR_SUBARCH) --rename-section .data=.progmem.data,contents,alloc,readonly,data $< $@ - -# Include LUFA build script makefiles -include ../core.mk -include ../gcc.mk -include ../hid.mk diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/License.txt b/lib/lufa/LUFA/Build/DMBS/DMBS/License.txt deleted file mode 100644 index 322c7624e5..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/License.txt +++ /dev/null @@ -1,32 +0,0 @@ - DMBS Build System - Released into the public domain. - - dean [at] fourwalledcubicle [dot] com - www.fourwalledcubicle.com - - - -This is free and unencumbered software released into the public domain. - -Anyone is free to copy, modify, publish, use, compile, sell, or -distribute this software, either in source code form or as a compiled -binary, for any purpose, commercial or non-commercial, and by any -means. - -In jurisdictions that recognize copyright laws, the author or authors -of this software dedicate any and all copyright interest in the -software to the public domain. We make this dedication for the benefit -of the public at large and to the detriment of our heirs and -successors. We intend this dedication to be an overt act of -relinquishment in perpetuity of all present and future rights to this -software under copyright law. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR -OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -OTHER DEALINGS IN THE SOFTWARE. - -For more information, please refer to diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/ModulesOverview.md b/lib/lufa/LUFA/Build/DMBS/DMBS/ModulesOverview.md deleted file mode 100644 index 1fd9cc11cc..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/ModulesOverview.md +++ /dev/null @@ -1,38 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Modules Overview ----------------- - -The following modules are currently included: - - - [ATPROGRAM](atprogram.md) - Device Programming - - [AVRDUDE](avrdude.md) - Device Programming - - [CORE](core.md) - DMBS Core Functionality - - [CPPCHECK](cppcheck.md) - Static Code Analysis - - [DFU](dfu.md) - Device Programming - - [DOXYGEN](doxygen.md) - Automated Source Code Documentation - - [GCC](gcc.md) - Compiling/Assembling/Linking with GCC - - [HID](hid.md) - Device Programming - -## Importing modules into your project makefile - -To use a module, it is recommended to add the following boilerplate to your -makefile: - - # Include DMBS build script makefiles - DMBS_PATH ?= ../DMBS - -Which can then used to indicate the location of your DMBS installation, relative -to the current directory, when importing modules. For example: - - DMBS_PATH ?= ../DMBS - include $(DMBS_PATH)/core.mk - include $(DMBS_PATH)/gcc.mk - -Imports the `CORE` and `GCC` modules from DMBS using a single path relative to -your project's makefile. - -If you wish to write your own DMBS module(s), -[see the documentation here for more details.](WritingYourOwnModules.md) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/WritingYourOwnModules.md b/lib/lufa/LUFA/Build/DMBS/DMBS/WritingYourOwnModules.md deleted file mode 100644 index 16df7a53bb..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/WritingYourOwnModules.md +++ /dev/null @@ -1,95 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Writing Your Own Modules ------------------------- - -A DMBS module consists of the several boilerplate sections, explained below. - -## The DMBS module hooks - -Your module needs to advertise to DMBS its name, its makefile targets, the -required and optional variables, and the variables and macros the module -provides for use elsewhere. This is achieved with the following section: - - DMBS_BUILD_MODULES += EXAMPLE - DMBS_BUILD_TARGETS += example-target another-target - DMBS_BUILD_MANDATORY_VARS += MANDATORY_NAME ALSO_MANDATORY - DMBS_BUILD_OPTIONAL_VARS += OPTIONAL_NAME ALSO_OPTIONAL - DMBS_BUILD_PROVIDED_VARS += MEANING_OF_LIFE - DMBS_BUILD_PROVIDED_MACROS += STRIP_WHITESPACE - -The example above declares that this module is called `EXAMPLE`, and exposes the -listed targets, variable requirements and provides variables and macros. - -Your module name and provided variable/macro names must be unique, however you -can (and should) re-use variable names where appropriate if they apply to -several modules (such as `ARCH` to specify the project's microcontroller -architecture). Re-using targets is not recommended, but can be used to extend -the dependencies of another module's targets. - -## Importing the CORE module - -Next, your module should always import the DMBS `CORE` module, via the -following: - - # Conditionally import the CORE module of DMBS if it is not already imported - DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) - ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk - endif - -This ensures that the `make help` target is always available. In addition, the -`CORE` module exposes some [commonly used macros and variables](core.md) to -your module. - -## Setting optional variable's defaults - -If a variable is optional, you should provide a default value. Do this via the -`?=` operator of `make`, which sets a variable's value if it has not yet been -set: - - MY_OPTIONAL_VARIABLE ?= some_default_value - -## Sanity checking user input - -Sanity checks are what make DMBS useful. Where possible, validate user input and -convert generated errors to human-friendly messages. This can be achieved by -enforcing that all the declared module mandatory variables have been set by the -user: - - # Sanity-check values of mandatory user-supplied variables - $(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) - -As well as complaining if they are set, but currently empty: - - $(call ERROR_IF_EMPTY, SOME_MANDATORY_VARIABLE) - $(call ERROR_IF_EMPTY, SOME_OPTIONAL_BUT_NON_EMPTY_VARIABLE) - -Or even if they are boolean (`Y` or `N`) variables that have an invalid value: - - $(call ERROR_IF_NONBOOL, SOME_BOOL_VARIABLE) - -## Adding targets - -The meat of a DMBS module is the targets, which are run when the user types -`make {target name}` from the command line. These can be as complex or simple -as you like. See the GNU make manual for information on writing make targets. - - example-target: - echo "Your DMBS module works!" - -## And finally, list the PHONYs - -Important in GNU Make is the concept of phony targets; this special directive -tells make that a given target should never be considered a valid file. Listing -phonies ensures that, for example, if your module had a target called `build`, -it would always run when the user types `make build` from the command line, even -if a file called `build` existed in the user project folder. - -You can list module-internal targets here, as well as mark all public targets -via the module header's `DMBS_BUILD_TARGETS` variable. - - # Phony build targets for this module - .PHONY: $(DMBS_BUILD_TARGETS) some-module-internal-target another-internal-target diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md b/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md deleted file mode 100644 index ea1b0d9194..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md +++ /dev/null @@ -1,119 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: ATPROGRAM ------------------ - -The ATPROGRAM module provides build targets for use with the official -`ATPROGRAM` back-end utility distributed with the free -[Atmel Studio](http://www.atmel.com) software released by Atmel. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/atprogram.mk - -## Prerequisites: - -This module requires the `atprogram.exe` utility to be available in your -system's `PATH` variable. The `atprogram.exe` utility is distributed in Atmel -Studio (usually) inside the application install folder's `atbackend` -subdirectory. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - -
atprogramProgram the device FLASH memory with the application's executable data.
atprogram-eeProgram the device EEPROM memory with the application's EEPROM data.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - - - - - -
MCUName of the Atmel processor model (e.g. `at90usb1287`).
TARGETName of the application output file prefix (e.g. `TestApplication`).
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - - - - - - - - - -
ATPROGRAM_PROGRAMMERName of the Atmel programmer or debugger tool to communicate with (e.g. `jtagice3`). Default is `atmelice`.
ATPROGRAM_INTERFACEName of the programming interface to use when programming the target (e.g. `spi`). Default is `jtag`.
ATPROGRAM_PORTName of the communication port to use when when programming with a serially connected tool (e.g. `COM2`). Default is `usb`.
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
N/AThis module provides no variables.
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - -
N/AThis module provides no macros.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.mk deleted file mode 100644 index a505275aed..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.mk +++ /dev/null @@ -1,68 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += ATPROGRAM -DMBS_BUILD_TARGETS += atprogram atprogram-ee -DMBS_BUILD_MANDATORY_VARS += MCU TARGET -DMBS_BUILD_OPTIONAL_VARS += ATPROGRAM_PROGRAMMER ATPROGRAM_INTERFACE ATPROGRAM_PORT -DMBS_BUILD_PROVIDED_VARS += -DMBS_BUILD_PROVIDED_MACROS += - -# Conditionally import the CORE module of DMBS if it is not already imported -DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) -ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk -endif - -# Default values of optionally user-supplied variables -ATPROGRAM_PROGRAMMER ?= atmelice -ATPROGRAM_INTERFACE ?= jtag -ATPROGRAM_PORT ?= - -# Sanity check user supplied values -$(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) -$(call ERROR_IF_EMPTY, MCU) -$(call ERROR_IF_EMPTY, TARGET) -$(call ERROR_IF_EMPTY, ATPROGRAM_PROGRAMMER) -$(call ERROR_IF_EMPTY, ATPROGRAM_INTERFACE) - -# Output Messages -MSG_ATPROGRAM_CMD := ' [ATPRGRM] :' - -# Construct base atprogram command flags -BASE_ATPROGRAM_FLAGS := --tool $(ATPROGRAM_PROGRAMMER) --interface $(ATPROGRAM_INTERFACE) --device $(MCU) -ifneq ($(ATPROGRAM_PORT),) - BASE_ATPROGRAM_FLAGS += --port $(ATPROGRAM_PORT) -endif - -# Construct the flags to use for the various memory spaces -ifeq ($(ARCH), AVR8) - ATPROGRAM_FLASH_FLAGS := --chiperase --flash - ATPROGRAM_EEPROM_FLAGS := --eeprom -else ifeq ($(ARCH), XMEGA) - ATPROGRAM_FLASH_FLAGS := --erase --flash - ATPROGRAM_EEPROM_FLAGS := --eeprom -else ifeq ($(ARCH), UC3) - ATPROGRAM_FLASH_FLAGS := --erase - ATPROGRAM_EEPROM_FLAGS := --eeprom -else - $(error Unsupported architecture "$(ARCH)") -endif - -# Programs in the target FLASH memory using ATPROGRAM -atprogram: $(TARGET).elf $(MAKEFILE_LIST) - @echo $(MSG_ATPROGRAM_CMD) Programming device \"$(MCU)\" FLASH using \"$(ATPROGRAM_PROGRAMMER)\" - atprogram $(BASE_ATPROGRAM_FLAGS) program $(ATPROGRAM_FLASH_FLAGS) --file $< - -# Programs in the target EEPROM memory using ATPROGRAM -atprogram-ee: $(TARGET).elf $(MAKEFILE_LIST) - @echo $(MSG_ATPROGRAM_CMD) Programming device \"$(MCU)\" EEPROM using \"$(ATPROGRAM_PROGRAMMER)\" - atprogram $(BASE_ATPROGRAM_FLAGS) program $(ATPROGRAM_EEPROM_FLAGS) --file $< - -# Phony build targets for this module -.PHONY: $(DMBS_BUILD_TARGETS) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.md b/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.md deleted file mode 100644 index d6c71ce6db..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.md +++ /dev/null @@ -1,124 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: AVRDUDE ------------------ - -The AVRDUDE module provides build targets for use with the official -open source `AVRDUDE` programmer utility, for the reprogramming of Atmel devices -using a wide variety of official and non-official programming devices and -bootloaders. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/avrdude.mk - -## Prerequisites: - -This module requires the `avrdude` utility to be available in your -system's `PATH` variable. The `avrdude` utility is distributed on the project's -[official site](https://savannah.nongnu.org/projects/avrdude) but is also -made available in many *nix operating system's package managers. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - -
avrdudeProgram the device FLASH memory with the application's executable data.
avrdude-eeProgram the device EEPROM memory with the application's EEPROM data.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - - - - - -
MCUName of the Atmel processor model (e.g. `at90usb1287`).
TARGETName of the application output file prefix (e.g. `TestApplication`).
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - - - - - - - - - - - - - -
AVRDUDE_PROGRAMMERName of the programmer/debugger tool or bootloader to communicate with (e.g. `jtagicemkii`). Default is `jtagicemkii`.
AVRDUDE_PORTName of the communication port to use when when programming with a serially connected tool (e.g. `COM2`). Default is `usb`.
AVRDUDE_FLAGSAdditional flags to pass to `avrdude` when invoking the tool. Default is empty (no additional flags).
AVRDUDE_MEMORYMemory space to program when executing the `avrdude` target (e.g. 'application` for an XMEGA device). Default is `flash`.
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
N/AThis module provides no variables.
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - -
N/AThis module provides no macros.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.mk deleted file mode 100644 index c4bac8fd0e..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/avrdude.mk +++ /dev/null @@ -1,52 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += AVRDUDE -DMBS_BUILD_TARGETS += avrdude avrdude-ee -DMBS_BUILD_MANDATORY_VARS += MCU TARGET -DMBS_BUILD_OPTIONAL_VARS += AVRDUDE_PROGRAMMER AVRDUDE_PORT AVRDUDE_FLAGS AVRDUDE_MEMORY -DMBS_BUILD_PROVIDED_VARS += -DMBS_BUILD_PROVIDED_MACROS += - -# Conditionally import the CORE module of DMBS if it is not already imported -DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) -ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk -endif - -# Default values of optionally user-supplied variables -AVRDUDE_PROGRAMMER ?= jtagicemkii -AVRDUDE_PORT ?= usb -AVRDUDE_FLAGS ?= -AVRDUDE_MEMORY ?= flash - -# Sanity check user supplied values -$(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) -$(call ERROR_IF_EMPTY, MCU) -$(call ERROR_IF_EMPTY, TARGET) -$(call ERROR_IF_EMPTY, AVRDUDE_PROGRAMMER) -$(call ERROR_IF_EMPTY, AVRDUDE_PORT) - -# Output Messages -MSG_AVRDUDE_CMD := ' [AVRDUDE] :' - -# Construct base avrdude command flags -BASE_AVRDUDE_FLAGS := -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) - -# Programs in the target FLASH memory using AVRDUDE -avrdude: $(TARGET).hex $(MAKEFILE_LIST) - @echo $(MSG_AVRDUDE_CMD) Programming device \"$(MCU)\" FLASH using \"$(AVRDUDE_PROGRAMMER)\" on port \"$(AVRDUDE_PORT)\" - avrdude $(BASE_AVRDUDE_FLAGS) -U $(AVRDUDE_MEMORY):w:$< $(AVRDUDE_FLAGS) - -# Programs in the target EEPROM memory using AVRDUDE -avrdude-ee: $(TARGET).eep $(MAKEFILE_LIST) - @echo $(MSG_AVRDUDE_CMD) Programming device \"$(MCU)\" EEPROM using \"$(AVRDUDE_PROGRAMMER)\" on port \"$(AVRDUDE_PORT)\" - avrdude $(BASE_AVRDUDE_FLAGS) -U eeprom:w:$< $(AVRDUDE_FLAGS) - -# Phony build targets for this module -.PHONY: $(DMBS_BUILD_TARGETS) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/core.md b/lib/lufa/LUFA/Build/DMBS/DMBS/core.md deleted file mode 100644 index 406abfecd7..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/core.md +++ /dev/null @@ -1,136 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: CORE ------------- - -The CORE module provides the core DMBS infrastructure used by other DMBS -modules, and must always be imported. Additionally, this module provides the -help system for DMBS. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/core.mk - -## Prerequisites: - -None. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
helpShow help for the current project, including a list of all available targets, variables and macros from the imported modules.
list_targetsShow a list of all build targets from the imported modules.
list_modulesShow a list of all imported modules.
list_mandatoryShow a list of all mandatory variables from the imported modules.
list_optionalShow a list of all optional variables from the imported modules.
list_providedShow a list of all variables provided by the imported modules.
list_macrosShow a list of all macros provided by the imported modules.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - -
N/AThis module has no mandatory variables.
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - -
N/AThis module has no optional variables.
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
DMBS_VERSIONCurrent version of this DMBS release, as a ISO 8601 integer (such as `20160403` for `2016-04-03`).
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - - - - - - - - - - - - - -
DMBS_CHECK_VERSIONMacro to check the current DMBS version against the first argument and abort if the required version is newer than the current version.
ERROR_IF_UNSETMacro to check the given makefile variable name passed as the first argument, and abort if it has not been set by any makefile module.
ERROR_IF_EMPTYMacro to check the given makefile variable name passed as the first argument, and abort if it has an empty value.
ERROR_IF_NONBOOLMacro to check the given makefile variable name passed as the first argument, and abort if it has a value other than `Y` or `N`.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/core.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/core.mk deleted file mode 100644 index 1edbd178c1..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/core.mk +++ /dev/null @@ -1,147 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += CORE -DMBS_BUILD_TARGETS += help list_targets list_modules list_mandatory list_optional list_provided list_macros -DMBS_BUILD_MANDATORY_VARS += -DMBS_BUILD_OPTIONAL_VARS += -DMBS_BUILD_PROVIDED_VARS += DMBS_VERSION -DMBS_BUILD_PROVIDED_MACROS += DMBS_CHECK_VERSION ERROR_IF_UNSET ERROR_IF_EMPTY ERROR_IF_NONBOOL - -SHELL = /bin/sh - -# Current DMBS release version -DMBS_VERSION := 20170426 - -# Macro to check the DMBS version, aborts if the given DMBS version is below the current version -DMBS_CHECK_VERSION ?= $(if $(filter-out 0, $(shell test $(DMBS_VERSION) -lt $(1); echo $$?)), , $(error DMBS version $(1) or newer required, current version is $(DMBS_VERSION))) - -# Macros to use in other modules to check various conditions -ERROR_IF_UNSET ?= $(if $(filter undefined, $(origin $(strip $(1)))), $(error Makefile $(strip $(1)) value not set)) -ERROR_IF_EMPTY ?= $(if $(strip $($(strip $(1)))), , $(error Makefile $(strip $(1)) option cannot be blank)) -ERROR_IF_NONBOOL ?= $(if $(filter Y N, $($(strip $(1)))), , $(error Makefile $(strip $(1)) option must be Y or N)) - -# Converts a given input to a printable output using "(None)" if no items are in the list -CONVERT_TO_PRINTABLE = $(if $(strip $(1)), $(1), (None)) - -# Build sorted and filtered lists of the included build module data -SORTED_DMBS_BUILD_MODULES = $(sort $(DMBS_BUILD_MODULES)) -SORTED_DMBS_BUILD_TARGETS = $(sort $(DMBS_BUILD_TARGETS)) -SORTED_DMBS_MANDATORY_VARS = $(sort $(DMBS_BUILD_MANDATORY_VARS)) -SORTED_DMBS_OPTIONAL_VARS = $(filter-out $(SORTED_DMBS_MANDATORY_VARS), $(sort $(DMBS_BUILD_OPTIONAL_VARS))) -SORTED_DMBS_PROVIDED_VARS = $(sort $(DMBS_BUILD_PROVIDED_VARS)) -SORTED_DMBS_PROVIDED_MACROS = $(sort $(DMBS_BUILD_PROVIDED_MACROS)) - -# Create printable versions of the sorted build module data (use "(None)" when no data is available) -PRINTABLE_DMBS_BUILD_MODULES = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_BUILD_MODULES)) -PRINTABLE_DMBS_BUILD_TARGETS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_BUILD_TARGETS)) -PRINTABLE_DMBS_MANDATORY_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_MANDATORY_VARS)) -PRINTABLE_DMBS_OPTIONAL_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_OPTIONAL_VARS)) -PRINTABLE_DMBS_PROVIDED_VARS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_PROVIDED_VARS)) -PRINTABLE_DMBS_PROVIDED_MACROS = $(call CONVERT_TO_PRINTABLE, $(SORTED_DMBS_PROVIDED_MACROS)) - -help: - @echo "===================================================================" - @echo " The DMBS Build System " - @echo " By Dean Camera { dean @ fourwalledcubicle . com } " - @echo "===================================================================" - @echo "DESCRIPTION: " - @echo " This build system is a set of makefile modules for (GNU) Make, to " - @echo " provide a simple system for building DMBS powered applications. " - @echo " Each makefile module can be included from within a user makefile, " - @echo " to expose the build rules documented in the comments at the top of" - @echo " each build module. " - @echo " " - @echo "USAGE: " - @echo " To execute a rule, define all variables indicated in the desired " - @echo " module as a required parameter before including the build module " - @echo " in your project makefile. Parameters marked as optional will " - @echo " assume a default value in the modules if not user-assigned. " - @echo " " - @echo " By default the target output shows both a friendly summary, as " - @echo " well as the actual invoked command. To suppress the output of the " - @echo " invoked commands and show only the friendly command output, run " - @echo " make with the \"-s\" switch added before the target(s). " - @echo "===================================================================" - @echo " " - @echo " Currently used build system modules in this application: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_BUILD_MODULES:%= - %\n)" - @echo " " - @echo " " - @echo " Currently available build targets in this application: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_BUILD_TARGETS:%= - %\n)" - @echo " " - @echo " " - @echo " Mandatory variables required by the selected build Modules: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_MANDATORY_VARS:%= - %\n)" - @echo " " - @echo " " - @echo " Optional variables required by the selected build Modules: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_OPTIONAL_VARS:%= - %\n)" - @echo " " - @echo " " - @echo " Variables provided by the selected build Modules: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_PROVIDED_VARS:%= - %\n)" - @echo " " - @echo " " - @echo " Macros provided by the selected build Modules: " - @echo " " - @printf " %b" "$(PRINTABLE_DMBS_PROVIDED_MACROS:%= - %\n)" - @echo " " - @echo "===================================================================" - @echo " The DMBS Build System $(DMBS_VERSION) - Making MAKE easier." - @echo "===================================================================" - -# Lists build modules included by the project makefile, in alphabetical order -list_modules: - @echo Currently Used Build System Modules: - @printf " %b" "$(PRINTABLE_DMBS_BUILD_MODULES:%= - %\n)" - -# Lists build targets included by the project makefile, in alphabetical order -list_targets: - @echo Currently Available Build Targets: - @printf " %b" "$(PRINTABLE_DMBS_BUILD_TARGETS:%= - %\n)" - -# Lists mandatory variables that must be set by the project makefile, in alphabetical order -list_mandatory: - @echo Mandatory Variables for Included Modules: - @printf " %b" "$(PRINTABLE_DMBS_MANDATORY_VARS:%= - %\n)" - -# Lists optional variables that must be set by the project makefile, in alphabetical order -list_optional: - @echo Optional Variables for Included Modules: - @printf " %b" "$(PRINTABLE_DMBS_OPTIONAL_VARS:%= - %\n)" - -# Lists variables provided by the included build modules, in alphabetical order -list_provided: - @echo Variables Provided by the Included Modules: - @printf " %b" "$(PRINTABLE_DMBS_PROVIDED_VARS:%= - %\n)" - -# Lists macros provided by the included build modules, in alphabetical order -list_macros: - @echo Macros Provided by the Included Modules: - @printf " %b" "$(PRINTABLE_DMBS_PROVIDED_MACROS:%= - %\n)" - -# Debugging; "make print-VARNAME" will output the variable VARNAME's value -print-%: - @printf "%s = %s" $(@:print-%=%) $($(@:print-%=%)) - -# Disable default in-built make rules (those that are needed are explicitly -# defined, and doing so has performance benefits when recursively building) -ifeq ($(filter -r,$(MAKEFLAGS)),) - MAKEFLAGS += -r -endif -.SUFFIXES: - -# Phony build targets for this module -.PHONY: $(DMBS_BUILD_TARGETS) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.md b/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.md deleted file mode 100644 index ec0e38d020..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.md +++ /dev/null @@ -1,134 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: CPPCHECK ------------------ - -The CPPCHECK module provides build targets to perform static analysis of the -user application, using the open source `cppcheck` tool. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/cppcheck.mk - -## Prerequisites: - -This module requires the `cppcheck` utility to be available in your system's -`PATH` variable. The `cppcheck` utility is distributed on the project's -[official site](http://cppcheck.sourceforge.net/) but is also -made available in many *nix operating system's package managers. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - -
cppcheckScan the project with CPPCHECK, and show all discovered issues.
cppcheck-configCheck the project with CPPCHECK, to find missing header paths.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - -
SRCList of all project source files to scan.
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CPPCHECK_INCLUDESExtra include paths to search, for any missing header files. Default is empty (no additional paths).
CPPCHECK_EXCLUDESList of source files, file paths or path fragments to exclude from the scan. Default is empty (no exclusions).
CPPCHECK_MSG_TEMPLATETemplate for error and warning message output. Default is `{file}:{line}: {severity} ({id}): {message}`.
CPPCHECK_ENABLEList of CPPCHECK checks to enable. Default is `all`.
CPPCHECK_SUPPRESSList of CPPCHECK checks to ignore. Default is `variableScope missingInclude`.
CPPCHECK_FAIL_ON_WARNINGBoolean, if `Y` the build will fail if CPPCHECK discovers any errors or warnings. If `N`, fail only on errors. Default is `Y`.
CPPCHECK_QUIETBoolean, if `Y` CPPCHECK will suppress all output except for discovered errors or warnings. If `N`, scan progress will be emitted. Default is `Y`.
CPPCHECK_FLAGS_Additional flags to pass to CPPCHECK when scans are started. Default is empty (no additional flags).
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
N/AThis module provides no variables.
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - -
N/AThis module provides no macros.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.mk deleted file mode 100644 index 9b82fc3b08..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/cppcheck.mk +++ /dev/null @@ -1,66 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += CPPCHECK -DMBS_BUILD_TARGETS += cppcheck cppcheck-config -DMBS_BUILD_MANDATORY_VARS += SRC -DMBS_BUILD_OPTIONAL_VARS += CPPCHECK_INCLUDES CPPCHECK_EXCLUDES CPPCHECK_MSG_TEMPLATE CPPCHECK_ENABLE \ - CPPCHECK_SUPPRESS CPPCHECK_FAIL_ON_WARNING CPPCHECK_QUIET CPPCHECK_FLAGS -DMBS_BUILD_PROVIDED_VARS += -DMBS_BUILD_PROVIDED_MACROS += - -# Conditionally import the CORE module of DMBS if it is not already imported -DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) -ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk -endif - -# Default values of optionally user-supplied variables -CPPCHECK_INCLUDES ?= -CPPCHECK_EXCLUDES ?= -CPPCHECK_MSG_TEMPLATE ?= {file}:{line}: {severity} ({id}): {message} -CPPCHECK_ENABLE ?= all -CPPCHECK_SUPPRESS ?= variableScope missingInclude -CPPCHECK_FAIL_ON_WARNING ?= Y -CPPCHECK_QUIET ?= Y -CPPCHECK_FLAGS ?= - -# Sanity check user supplied values -$(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) -$(call ERROR_IF_EMPTY, SRC) -$(call ERROR_IF_EMPTY, CPPCHECK_MSG_TEMPLATE) -$(call ERROR_IF_EMPTY, CPPCHECK_ENABLE) -$(call ERROR_IF_NONBOOL, CPPCHECK_FAIL_ON_WARNING) -$(call ERROR_IF_NONBOOL, CPPCHECK_QUIET) - -# Build a default argument list for cppcheck -BASE_CPPCHECK_FLAGS := --template="$(CPPCHECK_MSG_TEMPLATE)" $(CPPCHECK_INCLUDES:%=-I%) $(CPPCHECK_EXCLUDES:%=-i%) --inline-suppr --force --std=c99 - -# Sanity check parameters and construct additional command line arguments to cppcheck -ifeq ($(CPPCHECK_FAIL_ON_WARNING), Y) - BASE_CPPCHECK_FLAGS += --error-exitcode=1 -endif -ifeq ($(CPPCHECK_QUIET), Y) - BASE_CPPCHECK_FLAGS += --quiet -endif - -# Output Messages -MSG_CPPCHECK_CMD := ' [CPPCHECK]:' - -# Checks the CPPCheck configuration as used in the user project, to determine if any paths are missing or invalid -cppcheck-config: $(MAKEFILE_LIST) - @echo $(MSG_CPPCHECK_CMD) Checking cppcheck configuration check on source files - cppcheck $(BASE_CPPCHECK_FLAGS) --check-config $(CPPCHECK_FLAGS) $(SRC) - -# Runs a static analysis using CPPCheck to determine if there are any issues -cppcheck: $(MAKEFILE_LIST) - @echo $(MSG_CPPCHECK_CMD) Performing static analysis on source files - cppcheck $(BASE_CPPCHECK_FLAGS) --enable=$(CPPCHECK_ENABLE) $(CPPCHECK_SUPPRESS:%=--suppress=%) $(CPPCHECK_FLAGS) $(SRC) - -# Phony build targets for this module -.PHONY: $(DMBS_BUILD_TARGETS) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.md b/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.md deleted file mode 100644 index 456bbf6f5f..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.md +++ /dev/null @@ -1,122 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: DFU ------------------ - -The DFU module provides build targets to program a USB connected target running -a DFU class bootloader, via the official Atmel FLIP utility running via the -command line, or the open source `DFU-Programmer` tool. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/dfu.mk - -## Prerequisites: - -This module requires the `batchisp` utility to be available in your system's -`PATH` variable. The `batchisp` utility is distributed as part of Atmel's FLIP -software which can be downloaded from the [official site](http://www.atmel.com). - -This module requires the `dfu-programmer` utility to be available in your -system's `PATH` variable. The `dfu-programmer` utility is distributed from the -[official project site](https://dfu-programmer.github.io/). - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - - - - - - - - - -
flipProgram the application into the device's flash memory, using Atmel FLIP.
flip-eeProgram the application's EEPROM data into the device's EEPROM memory, using Atmel FLIP.
dfuProgram the application into the device's flash memory, using `dfu-programmer`.
dfu-eeProgram the application's EEPROM data into the device's EEPROM memory, using `dfu-programmer`.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - - - - - -
MCUName of the Atmel processor model (e.g. `at90usb1287`).
TARGETName of the application output file prefix (e.g. `TestApplication`).
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - -
N/AThis module has no optional variables.
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
N/AThis module provides no variables.
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - -
N/AThis module provides no macros.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.mk deleted file mode 100644 index 1eb22b864f..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/dfu.mk +++ /dev/null @@ -1,62 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += DFU -DMBS_BUILD_TARGETS += flip flip-ee dfu dfu-ee -DMBS_BUILD_MANDATORY_VARS += MCU TARGET -DMBS_BUILD_OPTIONAL_VARS += -DMBS_BUILD_PROVIDED_VARS += -DMBS_BUILD_PROVIDED_MACROS += - -# Conditionally import the CORE module of DMBS if it is not already imported -DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) -ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk -endif - -# Sanity-check values of mandatory user-supplied variables -$(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) -$(call ERROR_IF_EMPTY, MCU) -$(call ERROR_IF_EMPTY, TARGET) - -# Output Messages -MSG_COPY_CMD := ' [CP] :' -MSG_REMOVE_CMD := ' [RM] :' -MSG_DFU_CMD := ' [DFU] :' - -# Programs in the target FLASH memory using BATCHISP, the command line tool used by FLIP -flip: $(TARGET).hex $(MAKEFILE_LIST) - @echo $(MSG_DFU_CMD) Programming FLASH with batchisp using \"$<\" - batchisp -hardware usb -device $(MCU) -operation erase f loadbuffer $< program - batchisp -hardware usb -device $(MCU) -operation start reset 0 - -# Programs in the target EEPROM memory using BATCHISP, the command line tool used by FLIP -flip-ee: $(TARGET).eep $(MAKEFILE_LIST) - @echo $(MSG_COPY_CMD) Copying EEP file to temporary file \"$<.hex\" - cp $< $<.hex - @echo $(MSG_DFU_CMD) Programming EEPROM with batchisp using \"$<.hex\" - batchisp -hardware usb -device $(MCU) -operation memory EEPROM loadbuffer $<.hex program - batchisp -hardware usb -device $(MCU) -operation start reset 0 - @echo $(MSG_REMOVE_CMD) Removing temporary file \"$<.hex\" - rm $<.hex - -# Programs in the target FLASH memory using DFU-PROGRAMMER -dfu: $(TARGET).hex $(MAKEFILE_LIST) - @echo $(MSG_DFU_CMD) Programming FLASH with dfu-programmer using \"$<\" - dfu-programmer $(MCU) erase - dfu-programmer $(MCU) flash $< - dfu-programmer $(MCU) reset - -# Programs in the target EEPROM memory using DFU-PROGRAMMER -dfu-ee: $(TARGET).eep $(MAKEFILE_LIST) - @echo $(MSG_DFU_CMD) Programming EEPROM with dfu-programmer using \"$<\" - dfu-programmer $(MCU) flash --eeprom $< - dfu-programmer $(MCU) reset - -# Phony build targets for this module -.PHONY: $(DMBS_BUILD_TARGETS) diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.md b/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.md deleted file mode 100644 index 837704aca0..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.md +++ /dev/null @@ -1,118 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: DOXYGEN ------------------ - -The DOXYGEN module provides build targets to automatically generate API -documentation for a project, using the open-source Doxygen tool. - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/doxygen.mk - -## Prerequisites: - -This module requires the `doxygen` utility to be available in your system's -`PATH` variable. The `doxygen` utility is distributed on the project's -[official site](http://doxygen.org/) but is also -made available in many *nix operating system's package managers. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - - - - - -
doxygenGenerate project documentation, via Doxygen.
doxygen-createCreate a new project Doxygen template, which can then be customized.
doxygen-upgradeUpgrade an existing project Doxygen template to the latest Doxygen version.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - -
N/AThis module has no mandatory variables.
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - - - - - - - - - -
DOXYGEN_CONFName of the Doxygen project configuration file that should be used when generating documentation, or creating/upgrading the configuration file.
DOXYGEN_FAIL_ON_WARNINGBoolean, if `Y` the build will fail if Doxygen encounters any errors or warnings. If `N`, fail only on errors. Default is `Y`.
DOXYGEN_OVERRIDE_PARAMSList of `NAME=VALUE` parameters which should override the values specified in the project configuration file, when building documentation.
- -## Provided Variables: - -The following variables may be referenced in a user makefile (via `$(NAME)` -syntax) if desired, as they are provided by this module. - - - - - - - - -
N/AThis module provides no variables.
- -## Provided Macros: - -The following macros may be referenced in a user makefile (via -`$(call NAME, ARG1, ARG2, ...)` syntax) if desired, as they are provided by -this module. - - - - - - - - -
N/AThis module provides no macros.
- -## Module Changelog: - -The changes to this module since its initial release are listed below, as of the -DMBS version where the change was made. - -### 20160403 -Initial release. diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.mk b/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.mk deleted file mode 100644 index 45639ad156..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/doxygen.mk +++ /dev/null @@ -1,62 +0,0 @@ -# -# DMBS Build System -# Released into the public domain. -# -# dean [at] fourwalledcubicle [dot] com -# www.fourwalledcubicle.com -# - -DMBS_BUILD_MODULES += DOXYGEN -DMBS_BUILD_TARGETS += doxygen doxygen-upgrade doxygen-create -DMBS_BUILD_MANDATORY_VARS += -DMBS_BUILD_OPTIONAL_VARS += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRIDE_PARAMS -DMBS_BUILD_PROVIDED_VARS += -DMBS_BUILD_PROVIDED_MACROS += - -# Conditionally import the CORE module of DMBS if it is not already imported -DMBS_MODULE_PATH := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST)))) -ifeq ($(findstring CORE, $(DMBS_BUILD_MODULES)),) - include $(DMBS_MODULE_PATH)/core.mk -endif - -# Default values of optionally user-supplied variables -DOXYGEN_CONF ?= doxyfile -DOXYGEN_FAIL_ON_WARNING ?= Y -DOXYGEN_OVERRIDE_PARAMS ?= QUIET=YES - -# Sanity check user supplied values -$(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR))) -$(call ERROR_IF_EMPTY, DOXYGEN_CONF) -$(call ERROR_IF_NONBOOL, DOXYGEN_FAIL_ON_WARNING) - -# Output Messages -MSG_DOXYGEN_CMD := ' [DOXYGEN] :' - -# Determine Doxygen invocation command -BASE_DOXYGEN_CMD := ( cat $(DOXYGEN_CONF) $(DOXYGEN_OVERRIDE_PARAMS:%=; echo "%") ) | doxygen - -ifeq ($(DOXYGEN_FAIL_ON_WARNING), Y) - DOXYGEN_CMD := if ( $(BASE_DOXYGEN_CMD) 2>&1 | grep -v "warning: ignoring unsupported tag" ;); then exit 1; fi; -else - DOXYGEN_CMD := $(BASE_DOXYGEN_CMD) -endif - -# Error if the specified Doxygen configuration file does not exist -$(DOXYGEN_CONF): - $(error Doxygen configuration file $@ does not exist) - -# Builds the project documentation using the specified configuration file and the DOXYGEN tool -doxygen: $(DOXYGEN_CONF) $(MAKEFILE_LIST) - @echo $(MSG_DOXYGEN_CMD) Configuration file \"$(DOXYGEN_CONF)\" with parameters \"$(DOXYGEN_OVERRIDE_PARAMS)\" - $(DOXYGEN_CMD) - -# Upgrades an existing Doxygen configuration file to the latest Doxygen template, preserving settings -doxygen-upgrade: $(DOXYGEN_CONF) $(MAKEFILE_LIST) - @echo $(MSG_DOXYGEN_CMD) Upgrading configuration file \"$(DOXYGEN_CONF)\" with latest template - doxygen -u $(DOXYGEN_CONF) > /dev/null - -# Creates a new Doxygen configuration file with the set file name -doxygen-create: $(MAKEFILE_LIST) - @echo $(MSG_DOXYGEN_CMD) Creating new configuration file \"$(DOXYGEN_CONF)\" with latest template - doxygen -g $(DOXYGEN_CONF) > /dev/null - - diff --git a/lib/lufa/LUFA/Build/DMBS/DMBS/gcc.md b/lib/lufa/LUFA/Build/DMBS/DMBS/gcc.md deleted file mode 100644 index d28fd9ae45..0000000000 --- a/lib/lufa/LUFA/Build/DMBS/DMBS/gcc.md +++ /dev/null @@ -1,211 +0,0 @@ -DMBS - Dean's Makefile Build System -=================================== - - -Module: GCC ------------------ - -The GCC module provides build targets to compile a user application, using a -variant of GCC for a specific target architecture (such as `avr-gcc`). - -## Importing This Module into a Makefile: - -To use this module in your application makefile, add the following code to your -makefile: - - include $(DMBS_PATH)/gcc.mk - -## Prerequisites: - -This module requires the GCC compiler to be installed and available in the -system's `PATH` variable for the desired target architecture. - -## Build Targets: - -The following targets are supported by this module: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
sizeShow the compiled binary size for the various memory segments.
symbol-sizesShow the size of each symbol in the compiled binary (useful to find large functions to optimize further).
allBuild application and generate all binary (BIN, ELF, HEX) and auxiliary (LSS, MAP, SYM, etc.) output files.
libGenerate a static `.a` library from the application code, containing the flash region's data.
elfGenerate an ELF debug file from the application code, containing all region's data.
binGenerate a flat BIN binary file from the application code, containing the flash region's data.
hexGenerate a pair of Intel HEX files from the application code, containing the flash region's data (HEX) and EEPROM data (EEP).
lssGenerate a LSS listing file showing the disassembly of the compiled application.
cleanRemove all generated project intermediary and binary output files.
mostlycleanRemove all generated project intermediary output files, but preserve the binary output files.
- -## Mandatory Variables: - -The following variables must be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile to be able to use this module: - - - - - - - - - - - - - - - - - - - - -
MCUName of the Atmel processor model (e.g. `at90usb1287`).
TARGETName of the application output file prefix (e.g. `TestApplication`).
ARCHTarget device architecture (e.g. `AVR8`).
SRCList of all project source files (C, C++, ASM).
- -## Optional Variables: - -The following variables may be defined (with a `NAME = VALUE` syntax, one -variable per line) in the user makefile. If not specified, a default value will -be assumed. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
COMPILER_PATHPath to the compiler to use, in case a specific compiler should be substituted for the one in the system's `PATH` variable. Default is blank (use `PATH` provided compiler).
OPTIMIZATIONOptimization level to use when compiling C and C++ source files. Default is `s` (optimize for smallest size).
C_STANDARDC language standard used when compiling C language source files. Default is `gnu99` (C99 standard with GNU extensions)./td> -
CPP_STANDARDC++ language standard used when compiling C++ language source files. Default is `gnu++98` (C++98 standard with GNU extensions)./td> -
F_CPUProcessor core clock frequency, in Hz. This is used by some architectures for functions such as software spin-loop delays. Default is blank (no value defined).
C_FLAGSCommon GCC flags passed to the compiler for C language (C) input files. Default is blank (no additional flags).
CPP_FLAGSCommon GCC flags passed to the compiler for C++ language (CPP) input files. Default is blank (no additional flags).
ASM_FLAGSCommon GCC flags passed to the assembler for assembly language (S) input files. Default is blank (no additional flags).
CC_FLAGSCommon GCC flags passed to the compiler for all source file types. Default is blank (no additional flags).
LD_FLAGSExtra flags to pass to the GNU linker when linking the compiled object files into the resulting binary. Default is blank (no additional flags).
LINKER_RELAXATIONSBoolean, if `Y` linker relaxations will be enabled to slightly reduce the resulting binary's size. Default is `Y`.
JUMP_TABLESBoolean, if `Y` jump tables will be enabled to slightly reduce the resulting binary's size - note that this can cause incorrect jumps if the binary is relocated after compilation, such as for a bootloader. Default is `N`.
OBJDIRDirectory to store the intermediate object files, as they are generated from the source files. Default is `obj`.
OBJECT_FILESList of additional `.o` object files to link into the final binary. Default