Add support for J-Link and Silabs GG11 (#140)

***NO_CI***

Author: josesimoes

README.md

@@ -19,6 +19,8 @@ It makes use of several 3rd party tools:
    You can find the source, licensing information and documentation [here](https://www.st.com/en/development-tools/stm32cubeprog.html).
 - Texas Instruments Uniflash
    You can find the Uniflash tool and licensing information [here](http://www.ti.com/tool/download/UNIFLASH).
+- SEGGER J-Link
+   You can find the J-Link, licensing information and documentation [here](https://www.segger.com/downloads/jlink/).
 
 ## Install .NET **nanoFramework** Firmware Flasher
 
@@ -85,6 +87,14 @@ The tool includes help for all available commands. You can see a list of all ava
 nanoff --help
 ```
 
+List of usage examples per platform:
+
+- [ESP32](#esp32-usage-examples)
+- [STM32](#stm32-usage-examples)
+- [TI CC13x2](#ti-cc13x2-usage-examples)
+- [Silabs Giant Gecko](#silabs-giant-gecko-usage-examples)
+- [Common options](#common-options)
+
 ## ESP32 usage examples
 
 There are multiple ESP32 images available, some are build specifically for a target. Please check out the [list](https://github.com/nanoframework/nf-interpreter#firmware-for-reference-boards). You will need as well to know the COM port used by your device. Find [how to do this here](#finding-the-device-com-port-on-windows). Alternatively, you can as well list the available COM ports. If you list them first without the device to flash and then plugging the device, the additional port which will show up is the one for the device to flash. This method works for all OS:
@@ -242,6 +252,55 @@ To install the XDS110 USB drivers.
 nanoff --installxdsdrivers
 ```
 
+## Silabs Giant Gecko usage examples
+
+### Update the firmware of a specific Silabs target
+
+To update the firmware of the SL_STK3701A target to the latest version.
+
+```console
+nanoff --update --target SL_STK3701A
+```
+
+### Update the firmware of a Silabs target from a local file
+
+To update the firmware of a Silabs target with a local firmware file (for example from a build).
+This file has to be a binary file with a valid Booter and CLR from a build. No checks or validations are performed on the file(s) content.
+
+```console
+nanoff --update --platform gg11 --binaryfile "C:\nf-interpreter\build\nanobooter-nanoclr.bin" 
+```
+
+### Deploy a managed application to a SL_STK3701A target
+
+To deploy a managed application to a SL_STK3701A target, which has the deployment region at 0x000EE000 flash address and reset the MCU after flashing it.
+
+>Note: The binary file with the deployment image can be found on the Release or Debug folder of a Visual Studio project after a successful build. This file contains everything that's required to deploy a managed application to a target (meaning application executable and all referenced libraries and assemblies).
+
+```console
+nanoff --target ST_STM32F769I_DISCOVERY --deploy --image "E:\GitHub\nf-Samples\samples\Blinky\Blinky\bin\Debug\Blinky.bin" --address 0x000EE000 --reset
+```
+
+### Update the firmware of a SL_STK3701A along with a managed application
+
+To update the firmware of the SL_STK3701A target to the latest available version, using a J-Link connection, along with a managed application.
+You have to specify the path to the managed application.
+This example uses the binary format file that is generated by Visual Studio when building any nanoFramework C# application. Because it's a binary file you have to specify too the flash address of the deployment region (here 0x000EE000, mind the hexadecimal format).
+
+```console
+nanoff --update --target SL_STK3701A --jtag --binfile "c:\dev\my awesome app\bin\debug\my_awesome_app.bin" --address 0x000EE000
+```
+
+### List all Silabs devices available with J-Link connection
+
+This useful to list all Silabs devices that are connected through J-Link.
+
+```console
+nanoff --listjlink
+```
+
+## Common options
+
 ### Pre-check if target fits connected device
 
 The tool tries to make a best effort sanity check on whether the requested target fits the connected target.

lib/jlink/JLink.exe

@@ -0,0 +1,4 @@
+speed auto
+USB
+erase 0x0000000 0x001FF000
+Exit

lib/jlinkCmds/erase_gg11.jlink

@@ -0,0 +1,3 @@
+speed auto
+ShowEmuList USB
+Exit

lib/jlinkCmds/list_probes.jlink

@@ -0,0 +1,4 @@
+speed auto
+USB
+Connect
+Exit

lib/jlinkCmds/test_connection.jlink

@@ -0,0 +1,33 @@
+//
+// Copyright (c) .NET Foundation and Contributors
+// See LICENSE file in the project root for full license information.
+//
+
+using System;
+using System.Runtime.Serialization;
+
+namespace nanoFramework.Tools.FirmwareFlasher
+{
+    /// <summary>
+    /// Couldn't open the specified J-Link device.
+    /// </summary>
+    [Serializable]
+    internal class CantConnectToJLinkDeviceException : Exception
+    {
+        public CantConnectToJLinkDeviceException()
+        {
+        }
+
+        public CantConnectToJLinkDeviceException(string message) : base(message)
+        {
+        }
+
+        public CantConnectToJLinkDeviceException(string message, Exception innerException) : base(message, innerException)
+        {
+        }
+
+        protected CantConnectToJLinkDeviceException(SerializationInfo info, StreamingContext context) : base(info, context)
+        {
+        }
+    }
+}

lib/jlinkLinux/JLinkExe

@@ -149,9 +149,9 @@ public enum ExitCodes
         E5007 = 5007,
 
         /// <summary>
-        /// Can't program BIN file without specifying an address
+        /// Invalid address specified. Hexadecimal (0x0000F000) format required.
         /// </summary>
-        [Display(Name = "Can't program BIN file without specifying an address.")]
+        [Display(Name = "Invalid address specified. Hexadecimal (0x0000F000) format required.")]
         E5008 = 5008,
 
         /// <summary>
@@ -192,6 +192,22 @@ public enum ExitCodes
         [Display(Name = "Unsupported device.")]
         E7000 = 7000,
 
+        ///////////////////
+        // J-Link Errors //
+        ///////////////////
+
+        /// <summary>
+        /// Error executing J-Link CLI command.
+        /// </summary>
+        [Display(Name = "Error executing J-Link CLI command.")]
+        E8000 = 8000,
+
+        /// <summary>
+        /// No JTAG device found
+        /// </summary>
+        [Display(Name = "No J-Link device found. Make sure it's connected.")]
+        E8001 = 8001,
+
         ////////////////////////////////
         // Application general Errors //
         ////////////////////////////////