qmk_firmware/lib/lufa/LUFA/Build/DMBS/DMBS/atprogram.md

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 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:

atprogram	Program the device FLASH memory with the application's executable data.
atprogram-ee	Program 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:

MCU	Name of the Atmel processor model (e.g. `at90usb1287`).
TARGET	Name 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_PROGRAMMER	Name of the Atmel programmer or debugger tool to communicate with (e.g. `jtagice3`). Default is `atmelice`.
ATPROGRAM_INTERFACE	Name of the programming interface to use when programming the target (e.g. `spi`). Default is `jtag`.
ATPROGRAM_PORT	Name 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/A	This 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/A	This 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.