README_ru.md

.NET FastIoT VS Code Extension

Расширение .NET FastIoT в Visual Studio Code Marketplace.

README in English | README на русском языке | DevDotNet.ORG (Russian) - последние новости | Habr.com (Russian) - Простая разработка IoT приложений на C# для Raspberry Pi и других одноплатников, на Linux.

Расширение настраивает встраиваемое устройство на архитектуре ARMv7, ARMv8 или RISC-V, работающее под Linux, для запуска .NET приложений, и конфигурирует проекты *.csproj для удаленной отладки по ssh-туннелю. Работает только на Windows (64 бит).

Поддерживаются устройства: Raspberry Pi, Banana Pi, Orange Pi, Radxa, Tinkerboard, Odroid, Khadas VIM, NanoPi, Pine.

Интерфейс расширения .NET FastIoT

Возможности

1. Простая установка .NET SDK, .NET Runtimes, .NET Debugger (vsdbg), библиотеки Libgpiod, Docker для Linux;
2. Создание проекта из готового шаблона с возможностью удаленной отладки;
3. Настройка уже существующих проектов на .NET для удаленной отладки;
4. Создание пользовательских шаблонов проектов и конфигурации удаленной отладки;
5. Управление файлами наложения устройств (Device Tree overlays). Требуется для включения/выключения таких устройства как I2C, SPI, PWM, и т. д. Более подробно в публикации Работа с GPIO. Часть 2. Device Tree overlays.

Системные требования

• Версия ОС. Windows 10 (x64). Версия для Linux появится позже;
• Visual Studio Code. Версия 1.78.0 или выше;
• .NET. Для компиляции проекта на C# требуется .NET SDK в зависимости от используемой версии вашего проекта (для работы самого расширения не требуется);

Дополнительные расширения необходимые для разработки .NET приложений:

• C# for Visual Studio Code (powered by OmniSharp) — поддержка разработки на C#.

Рекомендуемые дополнительные расширения, улучшающие процесс разработки и взаимодействия с удаленным устройством:

• NuGet Package Manager GUI — добавление Nuget-пакетов (позже менеджер Nuget-пакетов будет встроен в расширение);
• DeviceTree — поддержка синтаксиса для файлов дерева устройств (Device Tree, DT). Используется для редактирования файлов *.dts. Например, потребуется если возникнет необходимость адаптации дисплея SPI LCD ILI9341 для вашего одноплатного компьютера;
• Output Colorizer — добавляет цвет к тестовым сообщениям в окне OUTPUT, облегчает восприятие информации выдаваемой расширением.

Системные требования для устройства

• Процессор. ARMv7, ARMv8 или RISC-V;
• Версия ОС. Linux дистрибутив построенный на основе Ubuntu версии не ниже 20.04 LTS (Focal Fossa), или на основе Debian версии не ниже 10.11 (Buster). Рекомендуется использовать дистрибутив Armbian;
• ПО. SSH-сервер OpenSSH.

Быстрый старт

Смотрите Getting started.

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

Смотрите Extension settings.

Устранение неполадок

Для устранения неполадок ознакомьтесь с инструкцией Troubleshooting.

Шаблоны проектов

Как создавать шаблоны посетите страницу Project Templates.

Дополнительные материалы

Для ознакомления с дополнительной документацией к проекту посетите страницу Additional materials.

Список изменений

Смотрите CHANGELOG.

Лицензия

Это программное обеспечение находится под лицензией LGPL-3.0.

Смотрите LICENSE для получения более подробной информации.

Шаблоны проектов к проектам распространяются под лицензией MIT.

Обратная связь

Свои замечания отправляйте по email [email protected]. И отмечайте в Issues.

Дальнейший план

Смотрите SCHEDULE.

Известные проблемы

Смотрите ISSUES и Issues on GitHub.

Тестирование

Тестирование выполняется на следующих одноплатных компьютерах:

• Cubieboard. Дистрибутив Armbian.
• Cubietruck. Дистрибутив Armbian.
• Banana Pi BPI-M64. Дистрибутив Armbian.