From ff762003d3648062ae9b71705416a45f649e830d Mon Sep 17 00:00:00 2001 From: Ben Combee Date: Tue, 4 May 2021 18:16:15 -0500 Subject: [PATCH 1/2] Add note about integrating with Windows Terminal --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index 52cb3d9..f3d7ab9 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,13 @@ If you wanted to connect to a device on COM17 at 115200 baud, you would use the If you want to make things even simpler, or if you need to use a bunch of command-line arguments and don't want to enter them every time (**and you don't use the terminal window in Visual Studio Code for anything else**) you can have VSCode launch SimplySerial directly whenever you open a terminal window by changing the `terminal.integrated.shell.windows` setting to point to `ss.exe` + any arguments you need to add. This works well, but will prevent you from having multiple VSCode terminal windows open, as only one application can connect to any given serial port at a given time. +# Using SimplySerial with Windows Terminal + +You can add a new profile to Windows Terminal to directly launch SimplySerial into its own tab. Unfortunately, launching ss.exe directly gives a cryptic error. The workaround is the launch using PowerShell. For example, to open COM4 at 115200 baud, you can specify the command as + + cmd.exe /c "ss -com:4 -baud:115200" + +which will use the quick-loading cmd to setup the console, then execute SimplySerial inside it. # Contributing From 4a0e4573c46ee99f5ac3e4008c1d0dc8eb6d4309 Mon Sep 17 00:00:00 2001 From: Ben Combee Date: Thu, 6 May 2021 21:28:26 -0500 Subject: [PATCH 2/2] Refresh documentation on Windows Terminal --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f3d7ab9..5a154bc 100644 --- a/README.md +++ b/README.md @@ -90,11 +90,14 @@ If you wanted to connect to a device on COM17 at 115200 baud, you would use the # Using SimplySerial with Windows Terminal -You can add a new profile to Windows Terminal to directly launch SimplySerial into its own tab. Unfortunately, launching ss.exe directly gives a cryptic error. The workaround is the launch using PowerShell. For example, to open COM4 at 115200 baud, you can specify the command as +[Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/) is a tabbed alternative to the command shell that Microsoft has developed as an open source project. It is easy to setup SimplySerial as a new terminal profile; you just need to create a new profile in the settings GUI and specify the ss command line. If you have problems, make sure that the SimplySerial executable is in your system path. - cmd.exe /c "ss -com:4 -baud:115200" +If you're directly editing the settings.json, the profile section will look like the code below, but with your specific command-line parameters. -which will use the quick-loading cmd to setup the console, then execute SimplySerial inside it. + { + "commandline": "ss -com:4 -baud:115200", + "name": "COM4" + } # Contributing