Skip to content

v0.9.0 Customization

Latest
Compare
Choose a tag to compare
@fasteddy516 fasteddy516 released this 08 Mar 03:54

It's been a long time coming, but this release has a ton of new features and significant under-the-hood changes. Most of these changes are the direct result of excellent suggestions and helpful issue reports from awesome users, so thank you to everyone who took the time to report, request and - in many cases - contribute code!

Enjoy the new release, and don't hesitate to report any issues you run into!

Notable Changes/Additions:

  • Auto-connect behaviour when running multiple instances of SimplySerial with multiple available COM ports has been corrected. Previously, a second instance would try to auto-connect to the same COM port as the first instance and just sit there waiting until the first instance closed and released the port. Now the second instance will detect ports that are in-use and move on to other unused ports.

  • boards.json now lives in its own repository and is re-generated automatically when new boards are added to CircuitPython. A new -updateboards option has been added to SimplySerial to check for - and optionally apply - updates.

  • User-provided board data can now be provided by creating a custom_boards.json file in the application folder (where ss.exe is located). The JSON structure is the same as in boards.json, allowing you to add your own - or override existing - vendor and board data.

  • The default settings used by SimplySerial can now be modified by creating a settings.cfg file in the application folder (where ss.exe is located). Command-line options can be entered in this file - one per line - and will be automatically applied when SimplySerial is launched.

  • The list of available COM ports that SimplySerial will use can now be filtered by creating a filters.json file in the application folder (where ss.exe is located), so you can get rid of those pesky unwanted entries that you don't want SimplySerial ever trying to connect to automatically. See the README for information on the file format and available options. Thanks to @gufpewga for the suggestion.

  • All of the new settings files (settings.cfg, custom_boards.json and filters.json can also be placed in a .simplyserial project folder. When SimplySerial is launched from a folder that contains a .simplyserial subfolder, these project-level settings will be applied in addition to the settings applied in the global files.

  • All command-line arguments that previously had no parameters (i.e. -forcenewline) have been updated to accept ON and OFF as parameters (i.e. -forcenewline:OFF). You can still omit the parameter and the argument will behave as it did previously.

  • noclear and nostatus have been renamed to clearscreen and status. The old forms still work for now, but should be considered deprecated and will likely be removed in a future release.

  • The -list option now accepts an optional parameter indicating what to list. -list:all will list all COM ports, including ones that have been filtered out. -list:settings will show all of the command-line arguments loaded from the available settings files. -list:boards will list all of the vendors and boards defined in the available board data files. -list:filters will show all of the filters applied to the COM ports available on the system.

  • New -config option to include a custom command-line settings file in addition to the new global and project-level settings files. Thanks to @kunchuf for the suggestion and contributing to the implementation.

  • New -exitkey option to change from the default CTRL-X to another key of your choosing. Thanks to @TinFoilFox and @BlueBarks for suggesting this feature.

  • New -echo option to enable/disable local echo. Thanks to @sk-jame for the suggestion, and to @salvathor79 for contributing to the implementation.

  • New -bulksend option to improve performance when pasting large amounts of data into a SimplySerial session. Thanks to @svofski for the suggestion and @FH0 for contributing to the implementation.

  • New -title option to allow manually setting the window title. Thanks to @markeby for the suggestion.

  • New -txonenter option to allow custom character sequences to be sent when the ENTER key is pressed. Thanks to @lefebvresam for the suggestion and @salvathor79 for contributing to the implementation.

  • .msi installers should now run on Windows Server operating systems. Thanks to @psitem for the suggestion.