Перейти до основного вмісту

Встановіть або оновіть Neat Library.

Використовуйте цю сторінку для встановлення або оновлення Neat Library.

Neat Library у складі Palette SDK.

Під час підключення DevKit під час налаштування sima-cli sdk setup, SDK автоматично встановлює Neat Library, що входить до комплекту, та пов’язане з нею середовище PyNeat у ~/pyneat на DevKit.

Коли потрібне автономне встановлення

Якщо цільова система не може завантажити пакети зі служб SiMa.ai, використовуйте автономне встановлення. Завантажте пакет на комп’ютері з доступом до інтернету.

Оберіть місце встановлення.​

Запустіть програму встановлення в тому середовищі, де ви створюєте або запускаєте програми Neat:

СередовищеВикористовуйте це, коли
Palette SDKВи хочете оновити Neat Library у Palette SDK без встановлення нової версії SDK.
ROS2 SDKВи хочете скомпілювати програми ROS 2 безпосередньо на платформі ARM64, використовуючи заголовки та бібліотеки Neat, встановлені в системних шляхах контейнера.
DevKitВи хочете встановити або оновити середовище виконання безпосередньо на пристрої.

Пакети розробки C++​

Мінімальне встановлення містить середовище виконання та sima-neat-dev. Типове встановлення пропонує навчальні матеріали й тести як необов’язкові доповнення; all включає їх. Застосункам із динамічним компонуванням потрібні публічні заголовки Core, відповідний клієнтський інтерфейс Scheduler і файли розробки GStreamer, OpenCV та JSON. Їм не потрібні вилучений спільний пакет Internals або API розробки Runner, Kernels, Codecs, бібліотеки пам’яті, heap чи LLiMa. Вибрані пакети постачають потрібні залежності середовища виконання.

Використовуйте встановлену динамічну ціль:

find_package(SimaNeat CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE SimaNeat::sima_neat)

Статичний архів залишається в sima-neat-dev. Використовуйте COMPONENTS Static та зберігайте встановленим відповідний пакет simaai-scheduler. Встановіть zlib1g-dev, libcpp-httplib-dev, а для збирань із LLiMa — sima-lmm-dev, з їхніми залежностями. Core використовує встановлений клієнтський інтерфейс Scheduler; не додавайте до застосунку цілі розробки Internals чи нижчих бібліотек:

find_package(SimaNeat CONFIG REQUIRED COMPONENTS Static)
target_link_libraries(my_app PRIVATE SimaNeat::sima_neat_static)

Статичний Core і далі використовує динамічні бібліотеки реалізації. Збирання Core з джерел використовує ту саму межу клієнтського інтерфейсу Scheduler і потребує файлів розробки інших залежностей, зокрема LLiMa, якщо його ввімкнено.

Передумови встановлення через інтернет​

Встановіть sima-cli в середовищі, де ви плануєте встановити Neat Library. Використовуйте інструкція зі встановлення sima-cli.

Створіть обліковий запис на community.sima.ai, щоб отримати доступ до ресурсів SiMa.ai, таких як попередньо скомпільовані моделі для тестування.

Авторизуйте середовище, щоб програма встановлення могла завантажити артефакти SiMa.ai. Детальніше див. у sima-cli вхід.

sdk or devkit$sima-cli login

Підтвердьте, чи може середовище отримати доступ до хоста, де розміщено SiMa.ai, та до артефактів:

sdk or devkit$curl -fsS https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh -o /dev/null && echo "artifacts reachable"

Виведення повідомлення про те, що artifacts reachable, означає, що до хоста можна отримати доступ. Помилка curl, наприклад, через перевищення часу очікування, відмову в підключенні або повідомлення «не вдалося визначити хост», означає, що вихідний доступ заблоковано — перевірте мережу хоста, проксі-сервер або брандмауер (див. Palette SDK Мережеві можливості. та нотатки щодо налаштування хоста) або використовуйте Встановлення в автономному режимі, якщо машина не може безпосередньо отримати доступ до служб SiMa.ai.

Встановіть Neat Library.​

Сумісність пакетів

Програма встановлення використовує всі пакети Debian, перелічені у вибраному основному артефакті, і не вибирає інші версії Scheduler або LLiMa. Встановлена платформа повинна задовольняти залежностям, які не містяться в цьому артефакті. Якщо APT видалятиме пакети платформи для завершення встановлення, програма встановлення зупиняється; замість цього оновіть платформу, а не замінюйте пакети в основному артефакті або LLiMa.

Оберіть робочу директорію перед запуском інсталятора. На DevKit встановіть програмне забезпечення в /media/nvme, щоб уникнути заповнення кореневої файлової системи. У контейнері SDK використовуйте локальний для контейнера шлях, наприклад $HOME/neat.

Оберіть потрібне середовище, а потім виконайте кроки в зазначеному порядку. Встановіть у контейнері Palette SDK, щоб здійснити перехресну компіляцію програм C++. Встановіть у ROS2 SDK, щоб здійснити компіляцію безпосередньо на ARM64; його пакети Debian встановлюються в /usr, а не в системну директорію перехресної компіляції Neat. Встановіть на DevKit, щоб налаштувати середовище виконання, яке також забезпечує наявність PyNeat у ~/pyneat. Команда інсталятора однакова в кожному середовищі.

Підготуйте локальну директорію для встановлення контейнера, наприклад, $HOME/neat:

sdk$cd $HOME && mkdir -p neat && cd neat

Встановіть стандартний пакет Neat Library, обраний за допомогою sima-cli. За бажанням, ви можете встановити додаткові компоненти, зокрема попередньо підготовлені навчальні матеріали, навчальні матеріали з кодом і тести:

sdk$sima-cli neat install core@v0.6.1

Стандартне середовище PyNeat для встановлення через інтернет​

Встановлення Neat Library на DevKit також передбачає створення стандартного віртуального середовища PyNeat у ~/pyneat на DevKit. Це підтримуване середовище PyNeat — активуйте його безпосередньо:

devkit$source ~/pyneat/bin/activate

Якщо ви запускаєте програму встановлення всередині контейнера SDK, пов’язаного з DevKit Sync, програма встановлення розгортає PyNeat на пов’язаному DevKit, а не лише всередині контейнера SDK. PyNeat встановлюється у віртуальне середовище під ~/pyneat на DevKit.

Інформацію про налаштування власних віртуальних середовищ Python див. у розділі Встановіть PyNeat..

Збірки з вихідного коду​

Збирайте проєкт із вихідного коду, коли вам потрібна непублікована зміна, спеціальна конфігурація збірки або коли ви робите внесок у Neat Library. Більшості користувачів слід використовувати попередньо зібраний пакет, наведений вище.

Якщо ви віддаєте перевагу збірці з вихідного коду, дотримуйтесь інструкцій у Створити.

Інформацію про налаштування SDK і початок роботи з DevKit Sync можна знайти в Palette SDK.

Автономне встановлення​

Перевірте залежності Python перед установленням

Офлайн-встановлення зберігає наявні середовища Python, додаткові пакети та файли в них. Перед установленням пакетів виконується pip check. Якщо середовище вже пошкоджене, встановлення зупиняється та повідомляє шлях до середовища й помилки залежностей. Виправте зазначені залежності та повторіть спробу. Для офлайн-виправлення потрібні додаткові файли wheel. Перевірка після встановлення повідомляє про наявні або нові конфлікти. Зміни пакетів автоматично не відкочуються.

Лише якщо ви хочете видалити середовище та встановити все заново, явно виконайте ./install.sh --recreate-venv (окремий Core) або sudo python3 -B install.py --recreate-venv (PCIe). Це видаляє пакети та файли у вибраному середовищі без резервної копії. У SDK цей параметр застосовується до спареного DevKit, а не до Python хоста SDK. Спочатку збережіть потрібні файли. Команди попередньої перевірки та перевірки без установлення ніколи не створюють середовище заново.

Автономні пакети Neat Library доступні у версії 0.6.0 або новішій. Використовуйте цей пакет для Modalix DevKit із Platform 3.0 або новішої версії.

1. Завантажте пакет​

Встановіть sima-cli на комп’ютері з доступом до інтернету. Див. посібник зі встановлення sima-cli.

Виконайте цю команду на комп’ютері з доступом до інтернету:

host$sima-cli neat install core/offline@v0.6.1 --download-only

Стандартний пакет містить середовище виконання, навчальні приклади та тести. Щоб завантажити лише середовище виконання, використовуйте:

host$sima-cli neat install core/offline@v0.6.1 -t minimal --download-only

2. Встановіть пакет​

  1. Скопіюйте завантажені файли на Modalix DevKit або в робочий простір Palette SDK.
  2. Відкрийте термінал у цій теці. Для встановлення в SDK використовуйте оболонку SDK.
  3. Розпакуйте архів програми встановлення:

Назва завантаженого архіву може мати суфікс із перших 8 символів SHA-256 перед .tar.gz. Перед розпакуванням залиште в цій теці лише вибраний архів інсталятора.

sdk or devkit$tar -xzf neat-core-offline-installer*.tar.gz
  1. Перейдіть до розпакованої теки:
sdk or devkit$cd neat-core-offline
  1. Запустіть програму встановлення від імені звичайного користувача. За потреби вона запитає дозволи sudo.
sdk or devkit$./install.sh

Якщо потрібні навчальні приклади або тести, розпакуйте окремий додатковий архів у вибрану теку.

Після автономного встановлення активуйте середовище Python такою командою:

devkit$source ~/pyneat/bin/activate

Офлайн-встановлення повторно використовує наявне ~/pyneatpcie на хості або ~/pyneat на карті чи DevKit, зокрема ціль символічного посилання. Якщо середовища в домашній теці немає, карта або DevKit використовує /media/nvme/pyneat, коли користувач, який виконує встановлення, може записувати на NVMe; інакше використовується ~/pyneat. Нове встановлення на NVMe створює посилання ~/pyneat, не замінюючи наявне середовище в домашній теці.

Параметри пакета та поведінка програми встановлення​

  • Перед встановленням програма перевіряє сумісність системи та доступне місце на диску.
  • Програма використовує залежності з пакета. Якщо необхідна залежність відсутня, вона зупиняється.
  • У SDK програма копіює Neat Library до /opt/toolchain/aarch64/modalix.
  • Якщо задано DEVKIT_SYNC_DEVKIT_IP, програма також встановлює пакет на сполучений DevKit через SSH. Обидва середовища мають пройти перевірки.

Якщо встановлення завершилося помилкою, прочитайте журнал за вказаним шляхом: /tmp/neat-core-offline-*.log. Для докладного виводу використовуйте ./install.sh --verbose.

Якщо під час встановлення SSH від’єднається, віддалена програма встановлення може продовжити роботу. Переконайтеся, що вона зупинилася, перш ніж повторювати спробу або видаляти тимчасову теку, зазначену у звіті.

Наступний крок​

Продовжуйте встановлення Встановіть PyNeat., щоб налаштувати власне середовище Python, або використовуйте Neat CLI для перевірки встановленого середовища.