@rhizomatics/signalk-einklabel-plugin 0.9.0-beta2 → 0.9.0

package/CHANGELOG.md

@@ -1,14 +1,20 @@
 # 0.9.0
 
+## Tide Clock Example
 - Rename `third_quarter` to `last_quarter` for moon phase icons in `templates/.assets/lunar_phases` to match Derived Data plugin
 - `tide.svg` renamed to `tides\416x240-BWRY.svg`. Original maintained but labelled as deprecated
-- Added a simpler 250x128 version of tide clock for 2.13" labels
+- Added a simpler *250x128* version of tide clock for 2.13" labels
+## Fixes
 - Fix configuration JSON holding older versions of itself as subentries
-- Repaint state used to track which labels to repaint separately tracks the template and data changes
+and data changes
 - Fix most cases of scanned devices not appearing in device dropdown choice
+## Improvements
+- Repaint state used to track which labels to repaint separately tracks the template 
 - `nearestColour` algorithm in Zhsunyco driver supports ESLs that only have BWR or BW
-- New 'ALL' as device option, and by default disable initial scan, to optimize support for single devices
-  - Scan and explicit device selection only required then for boats with multiple devices
+## Device Selection
+- New 'ALL' as device option, and by default disable initial scan, to optimize support for single devices, so can configure and go without waiting for scan
+  - Scan and explicit device selection only required for boats with multiple ESL devices
+## Templating
 - Now support a directory of templates, where each is named like `416-240-BWRY.svg` to support same functions on different devices.
 - Picks the template within the directory that most closely matches the tide clock height/width/colour-set, if not matched then height/width, and then best h/w ratio for nearest width
 - `template/assets` is now `template/.assets`

package/README.md

@@ -72,12 +72,17 @@ npm install @rhizomatics/signalk-einklabel-plugin
 
 ![Tide Clock](docs/assets/screenshots/example_tidal_clock.png)
 
-The tide clock needs the [signalk-tides](https://github.com/openwatersio/signalk-tides) plugin to be installed and publishing tides to the Resources API. The [tide.svg](https://github.com/rhizomatics/signalk-einklabel-plugin/blob/main/templates/tide.svg) can be customized to run with other APIs or take data only from SignalK data paths. For example, `source=resources,resource=tides,provider=tides,path=extremes[0].time,format=local_time` gets the first tide time, ensures its the preferred `signalk-tides` provider and makes it a simple local time rather than a UTC date time.
+Template available as 416x240-BWRY for 3.7" ESLs and a simpler template, sized 250x128, also BWRY, for the cheapest 2.13" labels.
 
-To show the lunar phase, the `environment.moon.phaseName` path is required, which can
+#### Pre-requisites
+
+* [signalk-tides](https://github.com/openwatersio/signalk-tides) plugin to be installed and publishing tides to the Resources API. 
+  - The [tides](https://github.com/rhizomatics/signalk-einklabel-plugin/blob/main/templates/tides/) templates can be customized to run with other APIs or take data only from SignalK data paths. 
+  - In the template it uses paths like `source=resources,resource=tides,provider=tides,path=extremes[0].time,format=local_time` to get the first tide time, ensures its the preferred `signalk-tides` provider and makes it a simple local time rather than a UTC date time.
+* To show the lunar phase, the `environment.moon.phaseName` path is required, which can
 be easily achieved by installing and configuring the `derived-data` plugin.
 
-## Configuration
+## Configuration
 
 Use the standard configuration option in the SignalK menu for the plugin.
 
@@ -95,7 +100,7 @@ The plugin can optionally re-scan whenever it starts up (off by default), althou
 
 A device's "Device" field can either be a specific device picked from the scan dropdown, or **"All discovered devices"**, which paints that same template/trigger to every device the plugin currently knows about. This is the simplest option for a boat with just one label - there's no need to scan first and pick it out, and if nothing's been discovered yet, selecting it triggers a scan itself the first time it's needed. It also covers several identical labels with one config entry, without listing each one out.
 
-### Scheduling
+### Scheduling
 
 There are two ways of scheduling scans:
 
@@ -323,6 +328,8 @@ For example, `npx esl-cli fields -t templates/tide.svg -e examples` will show al
 
 SignalK plugins lack ability to self-update after something like a scan, so first time round you may have to close the config and reload it to see this. Subsequently the plugin will remember all scanned devices, and only drop previously seen ones if it goes 24 hours without a positive scan or with failed paint attempts.
 
+Easiest way to solve this is to choose 'All Discovered Devices' in the device configuration, and it will paint any compatible devices it finds on future scans.
+
 ### Sometimes values are missing on the display
 
 If the plugin repaints a display at server startup, then the plugin that provides the data may not have started ( or in the case of `derived-data` the plugin that the plugin depends on! ) and unlike Home Assistant, there's no good way of sequencing the start of plugins.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhizomatics/signalk-einklabel-plugin",
-  "version": "0.9.0-beta2",
+  "version": "0.9.0",
   "description": "Display SignalK data on eInk Electronic Shelf Labels",
   "keywords": [
     "ble",