script: Add wsl2 devices support SiliconLabsSoftware#73

Relates-to:SiliconLabsSoftware#72

Author: Thomasdjb

README.md

@@ -103,34 +103,31 @@ ZPC> zwave_add_node
 (...)
 ```
 
-Set endnode to learn mode and the controller should see it:
+### WSL2 build
 
-```sh
-(...)
-Please verify the DSK and insert the missing part (first 5 digits)
-Usage: zwave_accept_dsk <insert the first two byte of the DSK in [decimal]>
-ZPC> zwave_accept_dsk (...)
-```
+How to use a z-wave controller with ZPC running in WSL2 ?
+
+You can use this [script](./scripts/wslusb.ps1).
 
-Then you will have to learn how to use couple of shell commands
-"attribute_store_log" and "attribute_store_set_desired",
-as explained in the reference documentation.
+Start by installing the usbipd service as described at: https://learn.microsoft.com/en-us/windows/wsl/connect-usb
 
 ```sh
-ZPC>attribute_store_log
-(...)
-ZPC>attribute_store_log_search OnOff
-(...)
-│   │   │   │───(110) ZCL OnOff OnOff .....................................      0
-(...)
-ZPC>attribute_store_set_desired 110,1
-(...)
-```
+# You can list devices using: 
+
+(Powershell)$ ./wslusb.ps1 -List
+
+# Get the BUSID of the device you want to mount
 
-### More
+(Powershell)$ ./wslusb.ps1 -Attach <busid>
 
-Refer to [./doc](doc) for more (using shell, MQTT, WebApp etc).
+# Check that the device is correctly mounted into WSL2
 
+(WSL2)$ lsusb # you should see your device here
+
+# Detach the device with
+
+(Powershell)$ ./wslusb.ps1 -Detach <busid>
+```
 
 ### Docker build
 

scripts/wslusb.ps1

@@ -0,0 +1,73 @@
+# SPDX-License-Identifier: ZLib
+# This script can be used to attach and detach a device to your WSL2 distribution
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory= $false, HelpMessage = "Busid of the device you want to bind")]
+    [Alias("b")]
+    [string]$Busid,
+
+    [Switch]$Attach,
+    [Switch]$Detach,
+    [Switch]$List
+)
+
+# Unblock the script file
+Unblock-File -Path $MyInvocation.MyCommand.Path
+
+Function List-devices {
+    usbipd list
+}
+
+Function Attach-device {
+    param(
+        [string]$Busid
+    )
+    Write-Host "Attaching device $Busid"
+    usbipd bind --busid $Busid --force
+    usbipd attach --wsl --busid $Busid --auto-attach
+}
+
+Function Detach-device {
+    param(
+        [string]$Busid
+    )
+    Write-Host "Detaching device $Busid"
+    usbipd detach --busid $Busid
+    usbipd unbind --busid $Busid
+}
+
+if ($Attach -or $Detach -or $List)
+{
+    if($List)
+    {
+        List-devices
+    }
+    if ($Detach)
+    {
+        if ($Busid)
+        {
+            Detach-device -Busid $Busid
+        }
+        else
+        {
+            Write-Host "Busid not specified"
+        }
+    }
+    if ($Attach)
+    {
+        if ($Busid)
+        {
+            Attach-device -Busid $Busid
+        }
+        else
+        {
+            Write-Host "Busid not specified"
+        }
+    }
+}
+else
+{
+    Write-Host "No argument specified. Use -Attach, -Detach or -List"
+    Write-Host 'Ex: ./wslusb.ps1 -b "5-3" -Attach'
+}