24242

Установка/замена (install/reinstall) PACK

Дата последнего изменения: 20.09.2021 12:40:09

1. Установка/замена (install/reinstall) PACK для IDE Keil uVision

Перед началом работы в среде программирования IDE Keil необходимо установить установочный Pack. Скачивать Pack рекомендуется только с официального сайта компании "Миландр". В данной статье подробно будет разобран пак "Software pack для KEIL MDK 5 для МК 1986ВЕ9х, 1Т, 3Т, 4У" - для других действия будут аналогичны.

Библиотека SPL предназначена для оказания технической помощи в освоении и демонстрации возможностей микроконтроллера и призвана ускорить процесс освоения микросхемы пользователем. Компания «Миландр» не возражает против частичного или полного использования библиотеки в проектах пользователя, но без каких-либо дополнительных гарантий и обязательств со стороны компании "Миландр" по корректности библиотеки. Поэтому всю полноту ответственности за конечное качество программного обеспечения несет разработчик, применяющий библиотеку.

Если установочный Pack ранее не был или был установлен (например, версия 1.4), но вышла более новая версия, то необходимо:

  • Cкачать архив с Pack с официального сайта.
  • Распаковать скаченный архив, сохранить файл с расширением .pack в папку с IDE Keil uVision для удобства.
  • Запустить установку, кликнув на Pack 2 раза, после чего появится окно с установкой согласно рисунку 1. После завершения стандартных шагов установки Pack будет установлен, при этом будет видно аналогичное окно, как на рисунке 2 (версия 1.51 в качестве примера).

 Рисунок 1 - Начало установки Pack

 Рисунок 2 - Завершение установки Pack
 
  • Запустить IDE Keil.
  • Зайти во вкладку PACK INSTALLER (показано на рисунке 3)

 Рисунок 3 - Tool Bar. Выбор Pack Installer

  • Убедиться, что возле актуальной версии установочного Pack, исходя из рисунка 4, доступна кнопка "Remove". Если были старые версии, то, соответственно, возле них должны быть кнопки "Unpack" для отсутствия коллизий (можно также удалить для удобства).

 Рисунок 4 - Pack Installer. Выбор Pack

  • Закрыть Pack Installer.
  • В основном окне IDE Keil появится сообщение «Software Packs has been modified. Reload Packs?». Выбрать «Да»
  • Открыть любой ранее созданный проект.
  • Убедиться, что после установки новой версии пака выбранный микроконтроллер доступен в настройках проекта (о недоступности выбранного микроконтроллера также информирует лог среды).
  • Скомпилировать проект.

При переходе с версии Pack 1.5 на актуальную, никаких дополнительных действий производить не требуется. Файлы, в которых были проведены изменения, помечены восклицательным знаком.

При обновлении пака в проекте может потребоваться ручное обновление файлов в группе Device в дереве проекта - они помечаются красным крестиком или синим вопросительным знаком. По ним необходимо нажать правой кнопкой мыши и выбрать опцию Update Config File (рисунок 5). Для сохранения изменений в конфигурационных файлах можно настроить инструмент слияния.

 Рисунок 5 - Обновление устаревших файлов до актуальной версии

Если версия установочного Pack была ниже 1.5, то при компиляции проекта могут возникать ошибки, связанные с тем, что какие-то файлы не находятся. Тогда нужно зайти во вкладку Manage Run-Time Environment. Для тех компонентов, которые выделены красным, развернуть выпадающее меню и выбрать файлы (драйверы), соответствующие новой версии Pack, переместив выделяющий маркер.

После скомпилировать проект еще раз.


2. Поддержка старых версий SPL/PACK

В процессе жизненного цикла SPL/PACK могут возникать ошибки/неточности, исправление которых невозможно без нарушения обратной совместимости между прошлой и новой версией. Введение изменений, нарушающих обратную совместимость, нежелательно, так как "ломает" проекты, созданные при использовании прошлых версий, но необходимо, так как за долгое время накапливается большое количество legacy кода.

При обновлении пользователь должен прочесть список введенных изменений. Списки введенных изменений входят в состав архивов.

В связи с этим вводится определение MDR_LEGACY_SUPPORT, объявленное в файле xxx_config.h, которое призвано обеспечить сохранение обратной совместимости и возможность адаптации готовых проектов для новых версий SPL/PACK с помощью проверки наличия определения MDR_LEGACY_SUPPORT и его значения, соответствующего номеру старой поддерживаемой версии. Дополнительно, внутри блоков кода, обеспечивающих обратную совместимость, добавлены предупреждения, описывающие, что рекомендуется использовать для адаптации готовых проектов под новые версии SPL/PACK. 

Так как определение MDR_LEGACY_SUPPORT объявлено в файле xxx_config.h, его также необходимо обновлять в проекте.

При первичной установке SPL/PACK и отсутствии готовых проектов для прошлых версий, в определении MDR_LEGACY_SUPPORT нет необходимости и его нужно закомментировать или изменить установленное по умолчанию значение на любое другое.

Следует отметить, что определение MDR_LEGACY_SUPPORT не обязано присутствовать в каждой версии SPL/PACK, оно вводится только при нарушении обратной совместимости в новой версии, и выводится из SPL/PACK за несколько обновлений следующим образом:

    1) Введены нарушающие обратную совместимость изменения, определение MDR_LEGACY_SUPPORT объявлено с заданным значением. Поддержка старых версий по умолчанию включена.

    2) Если следующая версия не является "быстрым обновлением" с исправлением критических ошибок, определение MDR_LEGACY_SUPPORT закомментировано, поддержка старых версий по умолчанию выключена. Если же следующая версия является "быстрым обновлением", то определение остаётся неизменным до выхода обновления, не являющегося "быстрым".

Обычно, при "быстрых" обновлениях изменяется последняя (третья) цифра (X.Y.Z - здесь третья цифра это Z), однако, это может быть не всегда так, поэтому необходимо предварительно ознакомиться с наличием изменений в файле xxx_config.h.

    3) Новая версия удаляет всю обратную совместимость, обеспечиваемую определением MDR_LEGACY_SUPPORT, из файлов поддержки. 

Также следует отметить, что стоит ориентироваться на Semantic Versioning 2.0.0 - названия новых выпускаемых версий стараются соответствовать данной системе.

Сохранить статью в PDF

Программное обеспечение

Standard Peripherals Library + software pack для Keil MDK 5
Standard Peripherals Library + software pack для Keil MDK 5
ОФИЦИАЛЬНАЯ СБОРКА
Standard Peripherals Library – библиотека для микроконтроллеров.

Теги

Была ли статья полезной?