Skip to content

Commit 8b7cdb1

Browse files
devdotnetorgdevdotnetorg
committed
Update to 0.1.5
1 parent 8b80816 commit 8b7cdb1

File tree

7 files changed

+133
-7
lines changed

7 files changed

+133
-7
lines changed

‎CHANGELOG.md‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,18 @@
11
# Changelog
22

3+
## v0.1.5 (12-04-2022)
4+
5+
- [Issue #1](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues/1 "Issue #1"). Added a template for creating a launch name. See [Launch-title-template](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/docs/Launch-title-template.md "Launch-title-template").
6+
- Added option to install Libgpiod from repository or from source.
7+
- Added board model detection for Raspberry Pi.
8+
- Added support for .NET Runtime & SDK 7.0.
9+
- Implemented the function of testing/verifying the installed package.
10+
- Test project added [dotnet-iot-fastiot-test](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/dotnet-iot-fastiot-test "dotnet-iot-fastiot-test").
11+
- Added device shutdown command.
12+
- Added ignoring comments ('//') to launch.json and tasks.json.
13+
- Some visual changes.
14+
- Updated documentation.
15+
316
## v0.1.4 (29-12-2021)
417

5-
First public build.
18+
- First public build.

‎CHANGELOG_ru.md‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,18 @@
11
# Changelog
22

3+
## v0.1.5 (12-04-2022)
4+
5+
- [Issue #1](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues/1 "Issue #1"). Добавлен шаблон для названия профиля запуска проекта. См. [Launch-title-template](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/docs/Launch-title-template.md "Launch-title-template").
6+
- Добавлена возможность установки Libgpiod из репозитория или из исходников.
7+
- Добавлено определение модели платы для Raspberry Pi.
8+
— Добавлена поддержка .NET Runtime и SDK 7.0.
9+
- Реализована функция тестирования/проверки установленного пакета.
10+
- Добавлен тестовый проект [dotnet-iot-fastiot-test](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/dotnet-iot-fastiot-test "dotnet-iot -фастио-тест").
11+
- Добавлена команда выключения устройства.
12+
- Добавлено игнорирование комментариев ('//') для launch.json и tasks.json.
13+
- Некоторые визуальные изменения.
14+
- Обновлена документация.
15+
316
## v0.1.4 (29-12-2021)
417

5-
Первый публичный билд.
18+
- Первый публичный билд.

‎README.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,26 @@ Run the project on debugging menu `Run > Start Debugging`.
142142

143143
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-7.png)
144144

145+
## Test projects
146+
147+
The `*.csproj` test projects are located in the folder [samples](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/ "samples"). The first base project for testing remote debugging is `dotnet-iot-fastiot-test`.
148+
149+
## Extension settings
150+
151+
To change the extension settings, open the menu item `File > Preferences > Settings`. Then go to the `User` tab and select `Extensions`.
152+
153+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-settings-1.png)
154+
155+
Settings:
156+
157+
- **Conf › Resource: Insert Empty Last Line** - device data is stored in the `fastiot.device.all.JSON` node in JSON format, it is not recommended to change it manually. Due to incorrect changes, the device list may not load.
158+
- **Fastiot › Device › Account: Groups** - Linux user group on a remote device (eg Raspberry Pi) to which the account (`debugvscode`) will be added to control the device. This group must have Administrator rights.
159+
- **Fastiot › Device › Account: Username** - account name created on the remote device. Used to control the device and perform remote debugging. Default value: `debugvscode`.
160+
- **Fastiot › Device › All: JSON** - device settings in JSON format, it is not recommended to change them manually. Due to incorrect changes, the device list may not load.
161+
- **Fastiot › Device: Pathfoldercwrsync** - folder with [cwRsync](https://itefix.net/cwrsync "cwRsync") program. Default value: `C:\RemoteCode\cwrsync`.
162+
- **Fastiot › Device: Pathfolderkeys** - folder for storing access keys to devices (eg Raspberry Pi).
163+
- **Fastiot › Launch: Templatetitle** - template for forming the name of the debugging profile. The values of the variables can be viewed at the [link](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/docs/Launch-title-template.md "link"). Default value: `Launch on %DEVICE_LABEL% (%NAME_PROJECT%, %BOARD_NAME%, %USER_DEBUG%)`.
164+
145165
## Videos (YouTube):
146166

147167
1. [Step 1. Configuring SSH access](https://www.youtube.com/watch?v=-xgAP1qsVsw "Step 1. Configuring SSH access")

‎README_ru.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,26 @@ sudo systemctl status ssh
142142

143143
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-7.png)
144144

145+
## Тестовые проекты
146+
147+
Тестовые проекты `*.csproj` располагаются в папке [samples](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/ "samples"). Первый базовый проект для проверки удаленной отладки `dotnet-iot-fastiot-test`.
148+
149+
## Настройки расширения
150+
151+
Для изменения настроек расширения необходимо открыть пункт меню `File > Preferences > Settings`. Затем перейти на закладку `User` и выбрать `Extensions`.
152+
153+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-settings-1.png)
154+
155+
Настройки:
156+
157+
- **Conf › Resource: Insert Empty Last Line** - данные об устройствах хранятся в узле `fastiot.device.all.JSON` в JSON формате, не рекомендуется изменять вручную. Из-за неверных изменений, список устройств может не загрузиться.
158+
- **Fastiot › Device › Account: Groups** - группа пользователей в Linux на удаленном устройстве (например, Raspberry Pi), в которую будет добавлена учетная запись (`debugvscode`) для управления устройством. Данная группа должна обладать правами Администратора.
159+
- **Fastiot › Device › Account: Username** - название учетной записи, создается на удаленном устройстве. Используется для управления устройством и выполнения удаленной отладки. Значение по умолчанию: `debugvscode`.
160+
- **Fastiot › Device › All: JSON** - настройки устройств в JSON формате, не рекомендуется изменять вручную. Из-за неверных изменений, список устройств может не загрузиться.
161+
- **Fastiot › Device: Pathfoldercwrsync** - папка с программой [cwRsync](https://itefix.net/cwrsync "cwRsync"). Значение по умолчанию: `C:\RemoteCode\cwrsync`.
162+
- **Fastiot › Device: Pathfolderkeys** - папка для хранения ключей доступа к устройствам (например, Raspberry Pi).
163+
- **Fastiot › Launch: Templatetitle** - шаблон для формирования названия профиля отладки. Значения переменных можно посмотреть по [ссылке](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/docs/Launch-title-template.md "ссылке"). Значение по умолчанию: `Launch on %DEVICE_LABEL% (%NAME_PROJECT%, %BOARD_NAME%, %USER_DEBUG%)`.
164+
145165
## Ролики (YouTube):
146166

147167
1. [Step 1. Configuring SSH access](https://www.youtube.com/watch?v=-xgAP1qsVsw "Step 1. Configuring SSH access")

‎assets/marketplace/vscode-marketplace-overview.md‎

Lines changed: 64 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
# .NET FastIoT VS Code Extension
44

5+
[.NET FastIoT Extension](https://marketplace.visualstudio.com/items?itemName=devdotnetorg.vscode-extension-dotnet-fastiot ".NET FastIoT Extension") in Visual Studio Code Marketplace.
6+
57
[README](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/README.md "README") in English | [README](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/README_ru.md "README") на русском языке | Habr.com (Russian) - [Easy development of IoT applications in C # for Raspberry Pi and other SBCs, on Linux](https://habr.com/ru/company/timeweb/blog/597601/ "Easy development of IoT applications in C # for Raspberry Pi and other SBCs, on Linux").
68

79
This extension allows you configures an ARMv7 or ARMv8 Linux embedded device to run .NET applications, and configures `*.csproj` projects for remote debugging via an ssh-tunnel. This has been tested on Windows (64 bits).
@@ -17,7 +19,7 @@ This extension allows you configures an ARMv7 or ARMv8 Linux embedded device to
1719
1. Easy installation .NET SDK, .NET Runtimes, .NET Debugger (vsdbg), Libgpiod, Docker for Linux;
1820
2. Setting up .NET projects for remote debugging, adding environment variables (Method [Environment.GetEnvironmentVariable](https://docs.microsoft.com/en-us/dotnet/api/system.environment.getenvironmentvariable "Environment.GetEnvironmentVariable"));
1921
3. Device Tree overlays management. Required to turn on/off devices such as I2C, SPI, PWM, etc. Available remote download of files `* .DTS` and enable/disable "layers". See [Working with GPIO. Part 2. Device Tree overlays (RU)](https://devdotnet.org/post/rabota-s-gpio-na-primere-banana-pi-bpi-m64-chast-2-device-tree-overlays/ "Working with GPIO. Part 2. Device Tree overlays"). Only the [Armbian](https://www.armbian.com/ "Armbian") distribution is supported. To support other distributions, the adapter must be implemented using the [IDtoAdapter.ts](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/src/DTO/IDtoAdapter.ts "IDtoAdapter.ts") interface. Armbian implementation example - [IoTDTOArmbianAdapter.ts](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/src/DTO/IoTDTOArmbianAdapter.ts "IoTDTOArmbianAdapter.ts");
20-
4. GPIO pin control (not fully implemented yet). Detecting available Gpiochip ~~and lines. Applying `0/1` to the contact, reading the state of the contact. Generation of C# code for the selected contact for transferring to the project one-to-one.~~
22+
4. GPIO pin control (not fully implemented yet). Detecting available Gpiochip.
2123

2224
## System requirements
2325

@@ -100,11 +102,69 @@ Selecting the **debugvscode** option creates a permissions configuration file [2
100102

101103
### Step 3 — Installing packages
102104

103-
**Coming soon**
105+
To run a .NET IoT application and perform remote debugging, you need to install:
106+
107+
- Runtime - .NET Runtime.
108+
- Remote debugger - .NET Debugger (vsdbg).
109+
- GPIO line control library - Libgpiod (optional).
110+
111+
Installing the Libgpiod library is possible from the repository and source code. If the repository contains an old version of the library, then install the library from source.
112+
113+
### Шаг 4 — Launch configuration
114+
115+
Now you need to open the project or create it. Project example [dotnet-iot-fastiot-test](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/dotnet-iot-fastiot-test "dotnet-iot-fastiot-test").
116+
117+
To create a remote debugging configuration on the device, you must click on the *Add Configuration* button:
118+
119+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-1.png)
120+
121+
Select project:
122+
123+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-2.png)
124+
125+
Select a device for remote debugging:
126+
127+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-3.png)
128+
129+
The application launch configuration has been created.
130+
131+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-4.png)
132+
133+
Now you need to go to `Run and Debug`:
134+
135+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-5.png)
136+
137+
Select configuration to run:
138+
139+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-6.png)
140+
141+
Run the project on debugging menu `Run > Start Debugging`.
142+
143+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-create-launch-7.png)
144+
145+
## Test projects
146+
147+
The `*.csproj` test projects are located in the folder [samples](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/tree/master/Samples/ "samples"). The first base project for testing remote debugging is `dotnet-iot-fastiot-test`.
148+
149+
## Extension settings
150+
151+
To change the extension settings, open the menu item `File > Preferences > Settings`. Then go to the `User` tab and select `Extensions`.
152+
153+
![VSCode dotnet FastIoT](https://raw.githubusercontent.com/devdotnetorg/vscode-extension-dotnet-fastiot/master/docs/vscode-dotnet-fastiot-settings-1.png)
154+
155+
Settings:
156+
157+
- **Conf › Resource: Insert Empty Last Line** - device data is stored in the `fastiot.device.all.JSON` node in JSON format, it is not recommended to change it manually. Due to incorrect changes, the device list may not load.
158+
- **Fastiot › Device › Account: Groups** - Linux user group on a remote device (eg Raspberry Pi) to which the account (`debugvscode`) will be added to control the device. This group must have Administrator rights.
159+
- **Fastiot › Device › Account: Username** - account name created on the remote device. Used to control the device and perform remote debugging. Default value: `debugvscode`.
160+
- **Fastiot › Device › All: JSON** - device settings in JSON format, it is not recommended to change them manually. Due to incorrect changes, the device list may not load.
161+
- **Fastiot › Device: Pathfoldercwrsync** - folder with [cwRsync](https://itefix.net/cwrsync "cwRsync") program. Default value: `C:\RemoteCode\cwrsync`.
162+
- **Fastiot › Device: Pathfolderkeys** - folder for storing access keys to devices (eg Raspberry Pi).
163+
- **Fastiot › Launch: Templatetitle** - template for forming the name of the debugging profile. The values of the variables can be viewed at the [link](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/blob/master/docs/Launch-title-template.md "link"). Default value: `Launch on %DEVICE_LABEL% (%NAME_PROJECT%, %BOARD_NAME%, %USER_DEBUG%)`.
104164

105-
See (YouTube):
165+
## Videos (YouTube):
106166

107-
1. [Step 1. Configuring SSH access](https://www.youtube.com/watch?v=pusO7PV4NL4 "Step 1. Configuring SSH access")
167+
1. [Step 1. Configuring SSH access](https://www.youtube.com/watch?v=-xgAP1qsVsw "Step 1. Configuring SSH access")
108168
2. [Step 2. Adding a device](https://www.youtube.com/watch?v=pusO7PV4NL4 "Step 2. Adding a device")
109169
3. [Step 3. Installing packages](https://www.youtube.com/watch?v=Y8U2V0THQh4 "Step 3. Installing packages")
110170
4. [Step 4. Creating a .NET console application and remote debugging](https://www.youtube.com/watch?v=oghH3oHIZgE "Step 4. Creating a .NET console application and remote debugging")

‎docs/vscode-dotnet-fastiot-settings-1.png‎

32.6 KB
Loading

‎src/extension.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ export async function activate(context: vscode.ExtensionContext) {
6565
const outputChannel = vscode.window.createOutputChannel(".NET FastIoT");
6666
outputChannel.appendLine("Welcome to .NET FastIoT!");
6767
outputChannel.appendLine("----------------------------------");
68-
outputChannel.appendLine("Version: 0.1.4");
68+
outputChannel.appendLine("Version: 0.1.5");
6969
outputChannel.appendLine("Feedback: fastiot@devdotnet.org");
7070
outputChannel.appendLine("----------------------------------");
7171
//TreeView Devices

0 commit comments

Comments
 (0)