Eclipse IDE

Установка и использование Eclipse IDE

Установка и настройка Eclipse IDE

Программа для отладки разработана в виде набора плагинов для Eclipse. На текущий момент получить плагины можно только в составе сборки DCS-Eclipse.

В качестве компилятора для 5400TP105-003 предлагается использовать SDCC (SDCC manual).

Среда разработана и протестирована на операционной системе «Ubuntu 22.04». Поддержка других операционных систем будет добавлена позднее.

Настройка окружения

Предварительно требуется установить SDCC:

Ubuntu 22.04

• Загрузить архив eclipse_ubuntu с сайта в разделе «Программное обеспечение» и извлечь данные на персональный компьютер

• Установить java-21 командой

sudo apt install openjdk-21-jdk

• Установить компилятор для 8051 командой

sudo apt install sdcc

• Перейти в папку eclipse и из терминала запустить IDE командой

sudo ./eclipse

Windows

• Установить eclipse из архива eclipse_win32.

• Установить java-21 с сайта разработчика.
  https://download.oracle.com/java/21/latest/jdk-21_windows-x64_bin.msi или
  https://download.oracle.com/java/21/latest/jdk-21_windows-x64_bin.exe

• Установить SDCC. Скачать файл sdcc-winX, где X – разрядность операционной системы. https://sourceforge.net/projects/sdcc/files/

• Перейти в папку Eclipse и запустить eclipse.exe.

Примечание

В случае, если на компьютере были установлены другие версии Java и у вас не запускается программа ниже представлены возможные пути решения проблемы.

1. Папка, в которую установлена Java-21 находится в системных переменных среды операционной системы. Путь к файлу java.exe должен находится в переменной Path. Для того, чтобы в этом убедиться нажмите ПКМ на «Пуск», выберите «Система» – «Дополнительные параметры системы»–«Переменные среды», выбрать переменную Path и нажать «Изменить». Если в переменной Path находится одновременно несколько путей до java.exe, то рекомендуется удалить т.к может быть использована некорректная версия java для запуска программы.
2. Системная переменная JAVA_HOME должна ссылаться на папку с установленной java (например C:\Program Files\Java\jdk-21\bin\ или C:\Program Files\Common Files\Oracle\Java\javapath). Если переменная отсутствует, то ее необходимо создать.

Если программа после всех действий не запускается и ваш путь к java содержит C:\Program Files\Common Files\Oracle\Java\javapath, то замените на явный путь к java C:\Program Files\Java\jdk-21\bin\

Также в качестве последнего шага можно принудительно прописать java в eclipse.ini, добавив строчку -vm C:\Program FIles\jdk-21\bin\javaw.exe

Создание проекта

Одновременно допускается использовать только один проект. Если требуется использовать другой проект, остальные необходимо закрыть.

Для создания первого проекта необходимо нажать на строку Create a new C or C++ project или Create new Project... → C Project

Создание проектов в eclipse

В качестве категории проекта выбрать C Project. Нажать Next.

Выбор категории проекта в eclipse

Выбрать тип проекта Executable/5400TP105-003 C Project.

В окне Toolchains выбрать SDCC Tool Chain, если вариантов более одного, и он не выбран по умолчанию.

Указать название проекта.

Убедиться, что проект создается в ожидаемой директории. При необходимости убрать галочку Use default location и изменить путь.

Нажать «Next».

Выбор типа проекта в eclipse

При необходимости изменить свойства проекта.

Желательно не трогать поля Source и Linker other options.

Нажать Next.

Свойства проекта в eclipse

В следующем окне ничего не изменять. Нажать кнопку Finish.

Выбор конфигурации проекта в eclipse

Возможно, IDE предложит сменить перспективу. Необходимо согласиться нажатием кнопки Open Perspective.

Перспективу также можно сменить в правом верхнем углу рабочего окна (кнопка «Open Perspective»).

Открытие перспективы в eclipse

Настройка проекта

После создания проекта выберите файл main.c и выполните сборку Build all. В случае возникновения ошибки убедитесь, что настройка проекта выполнена правильно. Корректная настройка проекта описана ниже.

• Нажать ПКМ на проект и выбрать Properties в появившемся контекстном меню.

• В категории С/C++ Build нажать кнопку Manage Configurations, выбрать Release и нажать Set Active.

Меню управления конфигурацией

• В Configuration выбрать Release [ Active ]

• В категории С/C++ Build выбрать Builder type: Internal builder

Окно настроек проекта

• Добавить генерацию hex-файла.Перейти в подкатегорию Settings, в окне Build Artifact выбрать Artifact extension: hex.

Установка генерации hex-файла

• Подтвердить изменения нажав Apply and Close.

• Выполнить сборку проекта нажав на молоток на панели инструментов или кнопку Build all.

Примечание

Если в консоли возникает ошибка «Error: Program "sdcc" not found in PATH», то необходимо убедиться, что в системной переменной Path среды операционной системы указан путь к sdcc. Для этого, нажмите ПКМ на «Пуск», выберите «Система» – «Дополнительные параметры системы»–«Системные переменные», выбрать переменную Path и нажать «Изменить». Если путь отсутствует, то необходимо нажать кнопку «Создать» и добавить путь (пример C:\Program Files\SDCC\bin).

Сборка проекта

Удаление/закрытие проекта

Для удаления/закрытия проекта необходимо нажать ПКМ по проекту и в выпадающем меню выбрать пункт Delete.

Удаление/закрытие проекта

Для удаления нужно нажать на checkbox Delete project contents on disk (cannot be undone). Для закрытия проекта галочку ставить не нужно. Подтвердить нажатием кнопки OK.

Подтверждение удаления/закрытия

Описание проекта

На рисунке ниже показано дерево проекта.

• 8051.h — библиотека внутренних регистров ядра;
• regs_map_C.h — библиотека внешних регистров ядра;
• lint.h и std.h — файлы для более корректной работы системы проверки синтаксиса;
• main.c — функция main.

Дерево проекта

Отладка Eclipse

Для отладки нужно выполнить подключение платы к usb порту устройства. Далее необходимо включить питание и подать частоту.

Примечание (Ubuntu 22.04)

В некоторых случаях отладка может не работать из-за системы выделения прав на устройстве. В этом случае следует запустить Eclipse через терминал с дополнительными правами с помощью команды sudo ./eclipse

После сборки проекта можно записать программу в микроконтроллер и начать отладку. Для этого следует нажать ПКМ на проекте и в контекстном меню выбрать: Debug As → Debug Configurations…

Создать новую конфигурацию путём двойного нажатия на 5400TP105-003 Debug и нажать Debug.

Окно запуска отладки

После нажатия кнопки «Debug» будет произведено программирование микросхемы в «SOFT» режим, и она будет переведена в режим отладки.

Примечание

При возникновении ошибок следует проверить и переподключить плату.

Внешний вид при отладке проекта

Справа можно увидеть 4 окна:

• Variables: информация об основных переменных и регистрах;
• Breakpoints: информация об установленных точках останова;
• Expressions: окно с возможностью слежения за выбранными переменными;
• Disassembler: окно дизассемблирования.

На панели инструментов есть 4 основных кнопки:

• Resume — запуск работы программы;
• Suspend — приостановка работы программы;
• Terminate — завершение работы программы.
• Reset — сброс программы и установку PC в нулевую инструкцию.

Примечание

При первой загрузке в память выполняется команда Reset для обнуления записанной программы и установки PC в начало.

Точки останова можно добавить с помощью двойного нажатия левой кнопкой мыши в файле с программой.

Примечание

Для микроконтроллера 5400ТР105-003 доступны только 4 одновременно установленных точки останова.