Рекомендации по работе с примерами
Примеры расположены по папкам в соответствии с областью их применения:
Dongle Programming API – пример программирования ключей с использованием Guardant API;
Dongle Trusted Remote Update – пример доверенного удаленного обновления ключей с использованием Guardant API;
General Guardant API – пример использования основных функций Guardant API;
Guardant SP Activation API – пример использования библиотеки активации Guardant SP с использованием Guardant API;
Loadable Code API – примеры использования Guardant API для ключей с загружаемым кодом Guardant Code;
Microsoft Visual C.Stealth – пример использования Guardant API для устаревших моделей ключей Stealth;
Verify Digital Sign (ECC160) – пример использования цифровой подписи;
На нашем форуме существует раздел, где можно найти некоторые полезные инструменты (преимущественно с исходником) и просто интересные примеры кода – Уголок OpenSource.
В примерах используются демо-коды доступа. Для некоторых из них понадобится определенная маска (Mask2.nsd), которую так же можно найти в папках с примерами. Для других используется стандартная маска с демонстрационными алгоритмами.
В левой верхней части она GrdUtil.exe выбираем создать образ.
Далее выбираем образ для соответствующей модели ключа, содержащий демонстрационные алгоритмы. Записываем образ в ключ.
Рассмотрим работу Guardant API на примере с загружаемым кодом. В примере демонстрируется управление светодиодом ключа с помощью исполнения загружаемого кода.
Перед началом необходимо прошить ключ Guardant Code маской Mask2.nsd (ее можно найти в папке C:\Program Files (x86)\Guardant\SDK7\Samples\Loadable Code API), и установить набор инструментов Yagarto.
Yagarto необходимо установить в корень диска С.
Для x64 версий Windows после установки необходимо обновить библиотеку msys-1.0.dll (присутствует в папках с установочными файлами Yagarto).
Для примера понадобится приложение, которое будет запускать загружаемый код, а также сам загружаемый код.
Для удобства в папке с примером находятся исполняемый файлы, которые быстро создают и код, и приложение.
Для их работы необходимо добавить некоторые переменные среды.
Есть и исходный код. Разработчик может выбрать любой удобный способ для сборки. В примере будет рассмотрен способ с использованием исполняемый файлов для сборки приложения и кода.
- Прошиваем ключ маской Mask2.nsd
- Устанавливаем Yagarto и обновляем библиотеку
- Устанавливаем MS Visual Studio версии не ниже 10 (для MS VS 2015 в исполняемый файл для сборки приложения необходимо добавить строчку @if exist "%VS140COMNTOOLS%\vsvars32.bat" @call "%VS140COMNTOOLS%\vsvars32.bat")
- Заходим в папку с примером и собираем загружаемый код, используя исполняемый файл build.bat из папки C:\Program Files (x86)\Guardant\SDK7\Samples\Loadable Code API\05 - LED Control\Loadable Code. Данная процедура подготавливает и загружает демонстрационный код в ключ, используя функции Guardant API
- Заходим в папку C:\Program Files (x86)\Guardant\SDK7\Samples\Loadable Code API\05 - LED Control\Sample и запускаем исполняемый файл msvc64.bat (если у вас 32-битная ОС, необходимо использовать msvc32.bat). Данная процедура собирает приложение, которое будет обращаться к загружаемому коду
- Запускаем приложение demo64m.exe из папки C:\Program Files (x86)\Guardant\SDK7\Samples\Loadable Code API\05 - LED Control\Sample\bin для проверки работы примера.
Чтобы изменить число вспышек на ключе, отредактируйте файл demo.c (в той его части, где идет вызов загружаемого кода) из папки C:\Program Files (x86)\Guardant\SDK7\Samples\Loadable Code API\05 - LED Control\Sample\src, и повторите сборку и загрузку приложения.