mirror of
https://github.com/osiweb/unified_retro_keyboard.git
synced 2024-11-26 02:49:16 +00:00
51022040f1
- build on checkin to asdf-release or asdf-built-test - deploy to https://dfnr2.github.io/unified-retro-keyboard
475 lines
15 KiB
CMake
475 lines
15 KiB
CMake
##########################################################################
|
|
# "THE ANY BEVERAGE-WARE LICENSE" (Revision 42 - based on beer-ware
|
|
# license):
|
|
# <dev@layer128.net> wrote this file. As long as you retain this notice
|
|
# you can do whatever you want with this stuff. If we meet some day, and
|
|
# you think this stuff is worth it, you can buy me a be(ve)er(age) in
|
|
# return. (I don't like beer much.)
|
|
#
|
|
# Matthias Kleemann
|
|
##########################################################################
|
|
|
|
##########################################################################
|
|
# The toolchain requires some variables set.
|
|
#
|
|
# AVR_MCU (default: atmega8)
|
|
# the type of AVR the application is built for
|
|
# AVR_L_FUSE (NO DEFAULT)
|
|
# the LOW fuse value for the MCU used
|
|
# AVR_H_FUSE (NO DEFAULT)
|
|
# the HIGH fuse value for the MCU used
|
|
# AVR_UPLOADTOOL (default: avrdude)
|
|
# the application used to upload to the MCU
|
|
# NOTE: The toolchain is currently quite specific about
|
|
# the commands used, so it needs tweaking.
|
|
# AVR_UPLOADTOOL_PORT (default: usb)
|
|
# the port used for the upload tool, e.g. usb
|
|
# AVR_PROGRAMMER (default: avrispmkII)
|
|
# the programmer hardware used, e.g. avrispmkII
|
|
##########################################################################
|
|
|
|
##########################################################################
|
|
# options
|
|
##########################################################################
|
|
#option(WITH_MCU "Add the mCU type to the target file name." OFF)
|
|
|
|
##########################################################################
|
|
# executables in use
|
|
##########################################################################
|
|
find_program(AVR_CC avr-gcc)
|
|
find_program(AVR_CXX avr-g++)
|
|
find_program(AVR_OBJCOPY avr-objcopy)
|
|
find_program(AVR_SIZE_TOOL avr-size)
|
|
find_program(AVR_OBJDUMP avr-objdump)
|
|
|
|
##########################################################################
|
|
# toolchain starts with defining mandatory variables
|
|
##########################################################################
|
|
set(CMAKE_SYSTEM_NAME Generic)
|
|
set(CMAKE_SYSTEM_PROCESSOR avr)
|
|
set(CMAKE_C_COMPILER ${AVR_CC})
|
|
set(CMAKE_CXX_COMPILER ${AVR_CXX})
|
|
|
|
##########################################################################
|
|
# c_toolchain_flags
|
|
# - Adds a list of compiler-specific flags to the CFLAGS variable in the
|
|
# parent scope.
|
|
##########################################################################
|
|
function(c_toolchain_flags)
|
|
# fix array base indexing beginning in AVR-GCC 12:
|
|
|
|
list(APPEND TOOLCHAIN_FLAGS
|
|
-std=c99
|
|
# -Wa,-adhln
|
|
-Wall
|
|
-funsigned-char
|
|
-funsigned-bitfields
|
|
-ffunction-sections
|
|
-fdata-sections
|
|
-fpack-struct
|
|
-fshort-enums
|
|
-O2
|
|
-Wall
|
|
-Wextra
|
|
-Wpointer-arith
|
|
-Wcast-align
|
|
-Wwrite-strings
|
|
-Wswitch-default
|
|
-Wunreachable-code
|
|
-Winit-self
|
|
-Wmissing-field-initializers
|
|
-Wno-unknown-pragmas
|
|
-Wstrict-prototypes
|
|
-Wundef
|
|
-Wold-style-definition
|
|
)
|
|
|
|
if(CMAKE_C_COMPILER_VERSION GREATER_EQUAL "11.3")
|
|
message(STATUS "Appending page size fix for GCC >= 11.3")
|
|
list(APPEND TOOLCHAIN_FLAGS --param=min-pagesize=0)
|
|
endif()
|
|
|
|
set(CFLAGS ${TOOLCHAIN_FLAGS} PARENT_SCOPE)
|
|
endfunction(c_toolchain_flags)
|
|
|
|
|
|
##########################################################################
|
|
# Macros for setting optimization flag:
|
|
# - optimization_off: turn off optimization for RTOS
|
|
# - optimization_full: set optimization to desired level for app.
|
|
##########################################################################
|
|
|
|
macro(optimization_off)
|
|
set(CMAKE_CFLAGS_RELEASE "-O0" "-NDEBUG")
|
|
set(CMAKE_CFLAGS "-O0" "-NDEBUG")
|
|
endmacro(optimization_off)
|
|
|
|
|
|
macro(optimization_full)
|
|
set(CMAKE_CFLAGS_RELEASE "-O3" "-NDEBUG")
|
|
set(CMAKE_CFLAGS "-O3" "-NDEBUG")
|
|
endmacro(optimization_full)
|
|
|
|
##########################################################################
|
|
# Identification
|
|
##########################################################################
|
|
set(AVR 1)
|
|
|
|
##########################################################################
|
|
# some necessary tools and variables for AVR builds, which may not
|
|
# defined yet
|
|
# - AVR_UPLOADTOOL
|
|
# - AVR_UPLOADTOOL_PORT
|
|
# - AVR_PROGRAMMER
|
|
# - AVR_MCU
|
|
# - AVR_SIZE_ARGS
|
|
##########################################################################
|
|
|
|
# default upload tool
|
|
if(NOT AVR_UPLOADTOOL)
|
|
set(
|
|
AVR_UPLOADTOOL avrdude
|
|
CACHE STRING "Set default upload tool: avrdude"
|
|
)
|
|
find_program(AVR_UPLOADTOOL avrdude)
|
|
endif(NOT AVR_UPLOADTOOL)
|
|
|
|
# default upload tool port
|
|
if(NOT AVR_UPLOADTOOL_PORT)
|
|
set(
|
|
AVR_UPLOADTOOL_PORT usb
|
|
CACHE STRING "Set default upload tool port: usb"
|
|
)
|
|
endif(NOT AVR_UPLOADTOOL_PORT)
|
|
|
|
# default programmer (hardware)
|
|
if(NOT AVR_PROGRAMMER)
|
|
set(
|
|
AVR_PROGRAMMER avrispmkII
|
|
CACHE STRING "Set default programmer hardware model: avrispmkII"
|
|
)
|
|
endif(NOT AVR_PROGRAMMER)
|
|
|
|
# default MCU (chip)
|
|
if(NOT AVR_MCU)
|
|
set(
|
|
AVR_MCU atmega8
|
|
CACHE STRING "Set default MCU: atmega8 (see 'avr-gcc --target-help' for valid values)"
|
|
)
|
|
endif(NOT AVR_MCU)
|
|
|
|
#default avr-size args
|
|
if(NOT AVR_SIZE_ARGS)
|
|
set(AVR_SIZE_ARGS -B)
|
|
endif(NOT AVR_SIZE_ARGS)
|
|
|
|
# prepare base flags for upload tool
|
|
set(AVR_UPLOADTOOL_BASE_OPTIONS -p ${AVR_MCU} -c ${AVR_PROGRAMMER})
|
|
|
|
# use AVR_UPLOADTOOL_BAUDRATE as baudrate for upload tool (if defined)
|
|
if(AVR_UPLOADTOOL_BAUDRATE)
|
|
set(AVR_UPLOADTOOL_BASE_OPTIONS ${AVR_UPLOADTOOL_BASE_OPTIONS} -b ${AVR_UPLOADTOOL_BAUDRATE})
|
|
endif()
|
|
|
|
##########################################################################
|
|
# check build types:
|
|
# - Debug
|
|
# - Release
|
|
# - RelWithDebInfo
|
|
#
|
|
# Release is chosen, because of some optimized functions in the
|
|
# AVR toolchain, e.g. _delay_ms().
|
|
##########################################################################
|
|
if(NOT ((CMAKE_BUILD_TYPE MATCHES Release) OR
|
|
(CMAKE_BUILD_TYPE MATCHES RelWithDebInfo) OR
|
|
(CMAKE_BUILD_TYPE MATCHES Debug) OR
|
|
(CMAKE_BUILD_TYPE MATCHES MinSizeRel)))
|
|
set(
|
|
CMAKE_BUILD_TYPE Release
|
|
CACHE STRING "Choose cmake build type: Debug Release RelWithDebInfo MinSizeRel"
|
|
FORCE
|
|
)
|
|
endif(NOT ((CMAKE_BUILD_TYPE MATCHES Release) OR
|
|
(CMAKE_BUILD_TYPE MATCHES RelWithDebInfo) OR
|
|
(CMAKE_BUILD_TYPE MATCHES Debug) OR
|
|
(CMAKE_BUILD_TYPE MATCHES MinSizeRel)))
|
|
|
|
|
|
|
|
##########################################################################
|
|
|
|
##########################################################################
|
|
# target file name add-on
|
|
##########################################################################
|
|
if(WITH_MCU)
|
|
set(MCU_TYPE_FOR_FILENAME "-${AVR_MCU}")
|
|
else(WITH_MCU)
|
|
set(MCU_TYPE_FOR_FILENAME "")
|
|
endif(WITH_MCU)
|
|
|
|
|
|
##########################################################################
|
|
# add_avr_executable
|
|
# - IN_VAR: EXECUTABLE_NAME
|
|
#
|
|
# Creates targets and dependencies for AVR toolchain, building an
|
|
# executable. Calls add_executable with ELF file as target name, so
|
|
# any link dependencies need to be using that target, e.g. for
|
|
# target_link_libraries(<EXECUTABLE_NAME>-${AVR_MCU}.elf ...).
|
|
#
|
|
##########################################################################
|
|
function(add_avr_executable EXECUTABLE_NAME)
|
|
message(STATUS "target name: ${EXECUTABLE_NAME}")
|
|
|
|
if(NOT ARGN)
|
|
message(FATAL_ERROR "No source files given for ${EXECUTABLE_NAME}.")
|
|
endif(NOT ARGN)
|
|
|
|
# set file names
|
|
set(basename ${EXECUTABLE_NAME}${MCU_TYPE_FOR_FILENAME})
|
|
set(elf_file ${basename}.elf)
|
|
set(hex_file ${basename}.hex)
|
|
set(lst_file ${basename}.lst)
|
|
set(map_file ${basename}.map)
|
|
set(eeprom_image ${basename}-eeprom.hex)
|
|
message(STATUS "elf name: ${elf_file}")
|
|
message(STATUS "project target name: ${PROJECT_TARGET_NAME}")
|
|
|
|
set(sphinx_file ${CMAKE_CURRENT_BINARY_DIR}/toc_${PROJECT_TARGET_NAME}.rst)
|
|
configure_file(${DOC_DIR}/source/_templates/hexfile_link.in ${sphinx_file})
|
|
|
|
message(STATUS "sphinx file: ${sphinx_file}")
|
|
|
|
install(FILES ${sphinx_file} DESTINATION docs/source)
|
|
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/${basename}.hex DESTINATION dist)
|
|
|
|
# elf file
|
|
add_executable(${elf_file} EXCLUDE_FROM_ALL ${ARGN})
|
|
|
|
set_target_properties(
|
|
${elf_file}
|
|
PROPERTIES
|
|
COMPILE_FLAGS "-mmcu=${AVR_MCU}"
|
|
LINK_FLAGS "-mmcu=${AVR_MCU} -Wl,--gc-sections -mrelax -Wl,-Map,${map_file}"
|
|
)
|
|
|
|
add_custom_command(
|
|
OUTPUT ${hex_file}
|
|
COMMAND
|
|
${AVR_OBJCOPY} -j .text -j .data -O ihex ${elf_file} ${hex_file}
|
|
COMMAND
|
|
${AVR_SIZE_TOOL} ${AVR_SIZE_ARGS} ${elf_file}
|
|
DEPENDS ${elf_file}
|
|
)
|
|
|
|
add_custom_command(
|
|
OUTPUT ${lst_file}
|
|
COMMAND
|
|
${AVR_OBJDUMP} -d ${elf_file} > ${lst_file}
|
|
DEPENDS ${elf_file}
|
|
)
|
|
|
|
# eeprom
|
|
add_custom_command(
|
|
OUTPUT ${eeprom_image}
|
|
COMMAND
|
|
${AVR_OBJCOPY} -j .eeprom --set-section-flags=.eeprom=alloc,load
|
|
--change-section-lma .eeprom=0 --no-change-warnings
|
|
-O ihex ${elf_file} ${eeprom_image}
|
|
DEPENDS ${elf_file}
|
|
)
|
|
|
|
add_custom_target(
|
|
${EXECUTABLE_NAME}
|
|
ALL
|
|
DEPENDS ${hex_file} ${lst_file} ${eeprom_image}
|
|
)
|
|
|
|
set_target_properties(
|
|
${EXECUTABLE_NAME}
|
|
PROPERTIES
|
|
OUTPUT_NAME "${elf_file}"
|
|
)
|
|
|
|
# clean
|
|
get_directory_property(clean_files ADDITIONAL_MAKE_CLEAN_FILES)
|
|
set_directory_properties(
|
|
PROPERTIES
|
|
ADDITIONAL_MAKE_CLEAN_FILES "${map_file}"
|
|
)
|
|
|
|
# upload - with avrdude
|
|
add_custom_target(
|
|
upload_${EXECUTABLE_NAME}
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} ${AVR_UPLOADTOOL_OPTIONS}
|
|
-U flash:w:${hex_file}
|
|
-P ${AVR_UPLOADTOOL_PORT}
|
|
DEPENDS ${hex_file}
|
|
COMMENT "Uploading ${hex_file} to ${AVR_MCU} using ${AVR_PROGRAMMER}"
|
|
)
|
|
|
|
# upload eeprom only - with avrdude
|
|
# see also bug http://savannah.nongnu.org/bugs/?40142
|
|
add_custom_target(
|
|
upload_${EXECUTABLE_NAME}_eeprom
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} ${AVR_UPLOADTOOL_OPTIONS}
|
|
-U eeprom:w:${eeprom_image}
|
|
-P ${AVR_UPLOADTOOL_PORT}
|
|
DEPENDS ${eeprom_image}
|
|
COMMENT "Uploading ${eeprom_image} to ${AVR_MCU} using ${AVR_PROGRAMMER}"
|
|
)
|
|
|
|
# disassemble
|
|
add_custom_target(
|
|
disassemble_${EXECUTABLE_NAME}
|
|
${AVR_OBJDUMP} -h -S ${elf_file} > ${EXECUTABLE_NAME}.lst
|
|
DEPENDS ${elf_file}
|
|
)
|
|
endfunction(add_avr_executable)
|
|
|
|
|
|
##########################################################################
|
|
# add_avr_library
|
|
# - IN_VAR: LIBRARY_NAME
|
|
#
|
|
# Calls add_library with an optionally concatenated name
|
|
# <LIBRARY_NAME>${MCU_TYPE_FOR_FILENAME}.
|
|
# This needs to be used for linking against the library, e.g. calling
|
|
# target_link_libraries(...).
|
|
##########################################################################
|
|
function(add_avr_library LIBRARY_NAME)
|
|
if(NOT ARGN)
|
|
message(FATAL_ERROR "No source files given for ${LIBRARY_NAME}.")
|
|
endif(NOT ARGN)
|
|
|
|
set(lib_file ${LIBRARY_NAME}${MCU_TYPE_FOR_FILENAME})
|
|
|
|
add_library(${lib_file} STATIC ${ARGN})
|
|
|
|
set_target_properties(
|
|
${lib_file}
|
|
PROPERTIES
|
|
COMPILE_FLAGS "-mmcu=${AVR_MCU}"
|
|
OUTPUT_NAME "${lib_file}"
|
|
)
|
|
|
|
if(NOT TARGET ${LIBRARY_NAME})
|
|
add_custom_target(
|
|
${LIBRARY_NAME}
|
|
ALL
|
|
DEPENDS ${lib_file}
|
|
)
|
|
|
|
set_target_properties(
|
|
${LIBRARY_NAME}
|
|
PROPERTIES
|
|
OUTPUT_NAME "${lib_file}"
|
|
)
|
|
endif(NOT TARGET ${LIBRARY_NAME})
|
|
|
|
endfunction(add_avr_library)
|
|
|
|
##########################################################################
|
|
# avr_target_link_libraries
|
|
# - IN_VAR: EXECUTABLE_TARGET
|
|
# - ARGN : targets and files to link to
|
|
#
|
|
# Calls target_link_libraries with AVR target names (concatenation,
|
|
# extensions and so on.
|
|
##########################################################################
|
|
function(avr_target_link_libraries EXECUTABLE_TARGET)
|
|
if(NOT ARGN)
|
|
message(FATAL_ERROR "Nothing to link to ${EXECUTABLE_TARGET}.")
|
|
endif(NOT ARGN)
|
|
|
|
get_target_property(TARGET_LIST ${EXECUTABLE_TARGET} OUTPUT_NAME)
|
|
|
|
foreach(TGT ${ARGN})
|
|
if(TARGET ${TGT})
|
|
get_target_property(ARG_NAME ${TGT} OUTPUT_NAME)
|
|
list(APPEND NON_TARGET_LIST ${ARG_NAME})
|
|
else(TARGET ${TGT})
|
|
list(APPEND NON_TARGET_LIST ${TGT})
|
|
endif(TARGET ${TGT})
|
|
endforeach(TGT ${ARGN})
|
|
|
|
target_link_libraries(${TARGET_LIST} ${NON_TARGET_LIST})
|
|
endfunction(avr_target_link_libraries EXECUTABLE_TARGET)
|
|
|
|
##########################################################################
|
|
# avr_target_include_directories
|
|
#
|
|
# Calls target_include_directories with AVR target names
|
|
##########################################################################
|
|
|
|
function(avr_target_include_directories EXECUTABLE_TARGET)
|
|
if(NOT ARGN)
|
|
message(FATAL_ERROR "No include directories to add to ${EXECUTABLE_TARGET}.")
|
|
endif()
|
|
|
|
get_target_property(TARGET_LIST ${EXECUTABLE_TARGET} OUTPUT_NAME)
|
|
set(extra_args ${ARGN})
|
|
|
|
target_include_directories(${TARGET_LIST} ${extra_args})
|
|
endfunction()
|
|
|
|
##########################################################################
|
|
# avr_target_compile_definitions
|
|
#
|
|
# Calls target_compile_definitions with AVR target names
|
|
##########################################################################
|
|
|
|
function(avr_target_compile_definitions EXECUTABLE_TARGET)
|
|
if(NOT ARGN)
|
|
message(FATAL_ERROR "No compile definitions to add to ${EXECUTABLE_TARGET}.")
|
|
endif()
|
|
|
|
get_target_property(TARGET_LIST ${EXECUTABLE_TARGET} OUTPUT_NAME)
|
|
set(extra_args ${ARGN})
|
|
|
|
target_compile_definitions(${TARGET_LIST} ${extra_args})
|
|
endfunction()
|
|
|
|
function(avr_generate_fixed_targets)
|
|
# get status
|
|
add_custom_target(
|
|
get_status
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} -P ${AVR_UPLOADTOOL_PORT} -n -v
|
|
COMMENT "Get status from ${AVR_MCU}"
|
|
)
|
|
|
|
# get fuses
|
|
add_custom_target(
|
|
get_fuses
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} -P ${AVR_UPLOADTOOL_PORT} -n
|
|
-U lfuse:r:-:b
|
|
-U hfuse:r:-:b
|
|
COMMENT "Get fuses from ${AVR_MCU}"
|
|
)
|
|
|
|
# set fuses
|
|
add_custom_target(
|
|
set_fuses
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} -P ${AVR_UPLOADTOOL_PORT}
|
|
-U lfuse:w:${AVR_L_FUSE}:m
|
|
-U hfuse:w:${AVR_H_FUSE}:m
|
|
COMMENT "Setup: High Fuse: ${AVR_H_FUSE} Low Fuse: ${AVR_L_FUSE}"
|
|
)
|
|
|
|
# get oscillator calibration
|
|
add_custom_target(
|
|
get_calibration
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} -P ${AVR_UPLOADTOOL_PORT}
|
|
-U calibration:r:${AVR_MCU}_calib.tmp:r
|
|
COMMENT "Write calibration status of internal oscillator to ${AVR_MCU}_calib.tmp."
|
|
)
|
|
|
|
# set oscillator calibration
|
|
add_custom_target(
|
|
set_calibration
|
|
${AVR_UPLOADTOOL} ${AVR_UPLOADTOOL_BASE_OPTIONS} -P ${AVR_UPLOADTOOL_PORT}
|
|
-U calibration:w:${AVR_MCU}_calib.hex
|
|
COMMENT "Program calibration status of internal oscillator from ${AVR_MCU}_calib.hex."
|
|
)
|
|
endfunction()
|