nanoclr 1.0.184

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global nanoclr --version 1.0.184                
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local nanoclr --version 1.0.184                
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=nanoclr&version=1.0.184                
nuke :add-package nanoclr --version 1.0.184                

.NET nanoFramework nanoCLR

This .NET Core Tool allows running nanoCLR in Windows machines. This can be useful to have virtual devices for development purposes, performing automated tests on pipelines or other environments and other uses that benefit from having a virtual device opposed to real physical hardware. The virtual device can be accessed just like a real one through a virtual serial port, a named pipe or a TCP/IP port.

Is part of .NET nanoFramework toolbox, along with other various tools that are required in .NET nanoFramework development, usage or repository management.

Install .NET nanoFramework nanoCLR

Perform a one-time install of the .NET nanoFramework nanoCLR tool using the following .NET Core CLI command:

dotnet tool install -g nanoclr

After a successful installation a message is displayed showing the command that's to be used to call the tool along with the version installed. Similar to the following example:

You can invoke the tool using the following command: nanoff
Tool 'nanoclr' (version '9.9.9') was successfully installed.

Update .NET nanoFramework nanoCLR

To update .NET nanoFramework nanoCLR tool use the following .NET Core CLI command:

dotnet tool update -g nanoclr

Usage

Once the tool is installed, you can call it by using its command nanoclr, which is a short version of the name to ease typing.

nanoclr [command] [args]

The tool includes help for all available commands. You can see a list of all available ones by entering:

nanoclr --help

Virtual Serial Ports

This verb allows managing the virtual serial port exposing the virtual device. The virtual serial port it's only available in Windows machines. It's made available with the sponsorship of HHD Software which has kindly sponsored a free license for running their tool.

List Virtual Serial ports

This command lists the installed virtual serial port bridges in the system.

nanoclr virtualserial --list

Create Virtual Serial port

This command creates a virtual serial port that will be used to expose the nanoCLR instance. A random COM port will be created. A COM port can be optionally specified as an option. In this case, if that COM port it's not being used, it will be created.

nanoclr virtualserial --create [COM99]

Remove Virtual Serial port

This command removes an existing virtual serial port.

nanoclr virtualserial --remove [COM99]

Install Virtual Serial Port tools

This command installs HHD Software Virtual Serial Port Tools software. The installer is downloaded from their website and executed. Executing the installer requires "Install Driver" privilege and must be elevated. If the process running it doesn't have the required permissions an UAC prompt will be show.

nanoclr virtualserial --install

Running the virtual nanoCLR

These options run the nanoCRL instance loading the specified assemblies and exposing the device on a specified interface. Please note that for successfully running a nanoCLR instance it's require to load a set of assemblies and specify an interface to expose it, otherwise it has no use.

Load a set of assemblies

This loads a set of .NET nanoFramework assemblies and runs the nanoCLR. These have to be in .NET nanoFramework PE (Portable Executable) format. They are found in the output folder of a Visual Studio project (typically bin\Debug or bin\Release). Full path of the PE files is required.

nanoclr run --assemblies "C:\nano\my_nice_project\bin\Debug\mscorlib.pe" "C:\nano\my_nice_project\bin\Debug\my_nice_project.pe"

Specify Serial Port

This option specifies the COM port that will be used to expose the virtual nanoCLR that will be running. It requires a previous setup of a Virtual Serial Port (see Create Virtual Serial port).

nanoclr run --serialport COM99  (--assemblies ...)

Specify Named Pipe

This option specifies a Named Pipe that will be used to expose the virtual nanoCLR that will be running.

nanoclr run --namedpipe MyNanoDevice  (--assemblies ...)

Resolve references

This option tries to resolve cross-assembly references between the loaded assemblies.

nanoclr run --resolve (--assemblies ...)

Options to control debugger connection

There are two options that control how the nanoCLR execution interacts with a debugger. If it's intended that after a program terminates and exits the execution a debugger will be connecting, the option --loopafterexit should be included. In case it's expected that imediatly after nanoCLR is started,a debugger is to connect to it, the option --waitfordebugger should be included.

Maintenance operations with the nanoCLR

The nanoCLR it's, in fact, a wrapper to the nanoCLR instance that is distributed as DLL so it can be easily updated. The following operations are available to manage this.

Version of nanoCLR

Gets the version of the current nanoCLR instance.

nanoclr instance --getversion

Update nanoCLR instance

Checks for stable versions of nanoCLR and updates it, if there is one. A version can be specified. To check preview versions add the --preview option.

nanoclr instance --update [--preview] [--clrversion 1.22.333.4444]

Uninstall .NET nanoFramework nanoCLR

To uninstall the .NET nanoFramework nanoCLR tool use the following .NET Core CLI command:

dotnet tool uninstall -g nanoclr
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.0.758 390 2/28/2025
1.0.751 314 2/25/2025
1.0.729 463 2/7/2025
1.0.726 102 2/6/2025
1.0.723 410 1/31/2025
1.0.721 98 1/31/2025
1.0.718 221 1/30/2025
1.0.717 106 1/30/2025
1.0.707 144 1/27/2025
1.0.692 508 1/3/2025
1.0.685 405 12/17/2024
1.0.676 222 12/6/2024
1.0.671 313 11/21/2024
1.0.664 357 11/8/2024
1.0.662 96 11/8/2024
1.0.659 277 10/23/2024
1.0.657 330 10/10/2024
1.0.656 173 10/3/2024
1.0.655 230 9/26/2024
1.0.654 147 9/26/2024
1.0.653 129 9/25/2024
1.0.650 212 9/20/2024
1.0.643 478 8/28/2024
1.0.637 430 8/7/2024
1.0.632 130 8/3/2024
1.0.630 111 8/2/2024
1.0.623 107 8/1/2024
1.0.618 95 7/30/2024
1.0.616 78 7/30/2024
1.0.615 84 7/30/2024
1.0.613 84 7/30/2024
1.0.612 89 7/29/2024
1.0.608 150 7/24/2024
1.0.606 83 7/24/2024
1.0.603 127 7/23/2024
1.0.601 148 7/19/2024
1.0.597 247 7/10/2024
1.0.591 242 6/26/2024
1.0.580 201 6/18/2024
1.0.573 240 6/12/2024
1.0.572 173 6/10/2024
1.0.569 202 6/7/2024
1.0.555 528 5/22/2024
1.0.554 132 5/22/2024
1.0.543 298 5/13/2024
1.0.530 227 5/7/2024
1.0.520 391 4/10/2024
1.0.515 497 3/22/2024
1.0.510 265 3/21/2024
1.0.509 271 3/14/2024
1.0.501 288 3/4/2024
1.0.494 329 2/22/2024
1.0.492 279 2/15/2024
1.0.488 240 2/9/2024
1.0.479 221 2/6/2024
1.0.473 322 1/26/2024
1.0.467 338 1/16/2024
1.0.455 510 12/22/2023
1.0.443 378 12/8/2023
1.0.430 525 11/16/2023
1.0.426 324 11/11/2023
1.0.425 244 11/10/2023
1.0.422 172 11/10/2023
1.0.421 214 11/9/2023
1.0.417 214 11/8/2023
1.0.412 218 11/7/2023
1.0.396 392 10/30/2023
1.0.392 355 10/24/2023
1.0.385 313 10/18/2023
1.0.381 335 10/12/2023
1.0.363 541 9/27/2023
1.0.334 481 8/31/2023
1.0.318 401 8/16/2023
1.0.317 333 8/7/2023
1.0.303 264 7/26/2023
1.0.302 175 7/26/2023
1.0.301 204 7/26/2023
1.0.292 208 7/26/2023
1.0.281 225 7/14/2023
1.0.267 361 6/16/2023
1.0.259 285 6/5/2023
1.0.256 197 5/31/2023
1.0.252 239 5/30/2023
1.0.250 197 5/29/2023
1.0.238 397 5/19/2023
1.0.237 197 5/19/2023
1.0.234 189 5/18/2023
1.0.233 196 5/17/2023
1.0.230 291 5/11/2023
1.0.225 321 5/5/2023
1.0.217 416 4/18/2023
1.0.216 210 4/17/2023
1.0.212 302 4/14/2023
1.0.211 337 4/11/2023
1.0.208 372 4/3/2023
1.0.205 289 3/30/2023
1.0.201 328 3/25/2023
1.0.200 278 3/22/2023
1.0.197 357 3/15/2023
1.0.196 279 3/15/2023
1.0.193 260 3/15/2023
1.0.190 259 3/14/2023
1.0.184 309 3/10/2023
1.0.182 267 3/10/2023
1.0.180 252 3/9/2023
1.0.179 286 3/9/2023
1.0.159 496 2/20/2023
1.0.151 319 2/17/2023
1.0.148 341 2/16/2023
1.0.145 302 2/15/2023
1.0.117 409 2/3/2023
1.0.116 302 2/3/2023
1.0.114 366 1/31/2023
1.0.111 357 1/30/2023
1.0.105 464 1/17/2023
1.0.104 510 1/5/2023
1.0.103 356 1/4/2023
1.0.100 354 1/3/2023
1.0.98 379 1/2/2023
1.0.95 403 1/2/2023
1.0.93 380 1/2/2023
1.0.92 440 12/22/2022
1.0.84 437 12/14/2022
1.0.63 479 12/5/2022
1.0.62 362 12/5/2022
1.0.55 394 12/2/2022
1.0.53 389 12/2/2022
1.0.50 374 12/2/2022
1.0.47 408 12/2/2022
1.0.45 395 12/2/2022
1.0.41 408 12/2/2022
1.0.39 381 12/2/2022
1.0.38 405 12/1/2022
1.0.37 403 12/1/2022
1.0.36 418 12/1/2022
1.0.34 403 11/30/2022
1.0.28 371 11/30/2022
1.0.25 460 11/29/2022
1.0.23 381 12/13/2022
1.0.22 377 12/13/2022
1.0.19 383 11/29/2022
1.0.15 406 11/29/2022
1.0.14 391 11/29/2022
1.0.13 379 11/29/2022
1.0.12 344 12/8/2022
1.0.11 383 12/7/2022
1.0.9 379 12/7/2022
1.0.3 353 12/5/2022
1.0.1 346 12/5/2022