strijar / hftrx

Embedded firmware for ham radio transceivers

Проект HF Dream Receiver (КВ приёмник мечты)

автор Гена Завидовский [e-mail] UA1ARN

Инструкция по подготовке среды и компиляции:

Микроконтроллер:

1. Настраиваем окружение (компилятор и утилиты для сборки проекта)
   1.1 ARM: GNU ARM Toolchain https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads (последняя проверенная сборка 10.3.1 20210824 (release))
   1.2 ATMEGA/ATXMEGA: AVR 8-bit Toolchain https://www.microchip.com/mplab/avr-support/avr-and-arm-toolchains-c-compilers или https://blog.zakkemble.net/wp-content/uploads/downloads/2021/04/avr-gcc-11.1.0-x64-windows.zip (распаковываем, прописываем путь к папке BIN в переменную окружения PATH)
   1.3 Утилиты для сборки отсюда: tools/gnu-mcu-eclipse-build-tools-2.11-20180428-1604-win64.zip (разархивировать, обновляем переменную PATH в системе, указав путь к подпапке bin, например C:\user\hftrx\tools\gnu-mcu-eclipse-build-tools-2.11-20180428-1604-win64\GNU MCU Eclipse\Build Tools\2.11-20180428-1604\bin)
   1.4 Утилиты для работы с GIT репозиториями https://git-scm.com/downloads
   

2. Скачиваем дополнительные библиотеки, распаковываем их на уровень выше, чем папка проекта.
   2.1 ATMEL ARM: В случае использования Atmel ARM (SAM) процессоров, скачать и распаковать в папку "xdk-asf" пакет Advanced Software Framework (ASF) <https://www.microchip.com/mplab/avr-support/advanced-software-framework
   

3. Устанавливаем IDE для разработки
   3.1 Скачиваем и устанавливаем Eclipse https://www.eclipse.org/downloads/
   3.2 В верхнем меню Help -> Check for updates, устанавливаем обновления
   3.3 В верхнем меню Help -> Eclipse Marketplace, устанавливаем обновления
   3.4 В верхнем меню Help -> Eclipse Marketplace, используя поиск, устанавливаем расширение GNU MCU Eclipse

4. Собираем проект
   4.1 Скачаваем последнюю версию проекта командой "git clone https://github.com/ua1arn/hftrx hftrx"
   4.2 Перходим в каталог hftrx "cd hftrx"
   4.3 Скачиваем субмодули "git submodule update --init --recursive"
   4.4 Открываем проект через File -> Open projects from File System 4.5 Копируем файл product.h.prototype в product.h
   

4.4 Раскомментируем нужные нам константы с выбранной конфигурацией
4.5 В меню Eclipse, Project -> Build configurations -> Set active выбираем необходимый процессор (или через выпадающее меню с молотком в ToolBox). Build target выбираем default.

5. Прошиваем
   5.1 Скопилированные прошивки находятся в папке /build/<процессор>/
   5.2 Для обновления прошивки процессора RENESAS через bootloader в командных файлах используется уилилита из проекта https://sourceforge.net/projects/dfu-util/files/latest/download

FPGA:

Используется Quartis II 13.1 (с апдейтом) Paid version http://download.altera.com/akdlm/software/acdsinst/13.1/162/ib_tar/Quartus-13.1.0.162-windows-complete.tar
и апдейт после http://download.altera.com/akdlm/software/acdsinst/13.1.4/182/update/QuartusSetup-13.1.4.182.exe

Общее:

Выбор целевой конфигурации проекта производится в файле product.h
На основании выбраной конфигурации и целевого процессора (arm/atmega) выбирается пара конфигурационных файлов
.\board*ctlstyle*.h и .\board*cpustyle*.h.
ctlstyle описывают внешние (по отношению к процессору) особенности аппаратуры - адреса устройств на шине spi, типы применённых микросхем и тип индикатора (и так далее).
cpustyle описывают назначение выводов процессора (распределение по портам ввода/вывода).