3.10 Release documentation

docs/currentchanges.txt

@@ -106,4 +106,4 @@ V3.9.3
 Minor release to allow install to work with the new Python version Adafruit install script.
 
 V3.10
-Significant release to add capability of using long presses and gestures on the touchscreen.  HA light domain nodes (dimmers) and ISY nodes of type 1 (dimmers) now have the added feature that holding a long press on their screen buttons will bring up a brightness slider.  Moving your finger along the axis of the slider will adjust brightness for the light.  Note that due to differences in how Insteon/ISY and HA/Zwave handle dimming the physical responsiveness of HA nodes may look quicker at the light itself.  This is due to rate limiting of the Insteon network traffic.  Tapping OK will return to the parent screen with the new brightness while tapping Cancel will return but return the brightness to what it was.  This feature also works for ISY Scenes via the console's scene proxy support so that the common idiom for implementing 3-way lights via a set of switches in a scene is supported as one would expect.  Note that on capacitive touch screens this works very well and very responsively.  Resistive touch screens generate a huge amount of "noise" in the form of non-existant touch/release events while holding down and other similar random things.  The code has a lot of "dejittering" for all of this with the result that the resistive screens may seem a bit more sluggish in their response to finger movement, but in my experience still quite acceptable.  In addition to these changes, there is now an alternate way to bring up the maintenance screen via a single diagonal gesture from the upper left to the lower right of the screen.  (Note: if the screen is dim you do first need to awaken it with any touch.)  Note that this has required a significant revamp to the touchscreen handling code so if you do see any apparent weirdness please report it.  Also, given that the console can now see length of touch and movement, any suggestions for other uses of that capability are welcome.  Finally, in the event that you do see strange problems with touch, you can for now revert to the previous touch driver system by creating an empty file in /home/pi names .forceoldtouch.
+Significant release to add capability of using long presses and gestures on the touchscreen.  HA light domain nodes (dimmers) and ISY nodes of type 1 (dimmers) now have the added feature that holding a long press on their screen buttons will bring up a brightness slider.  Moving your finger along the axis of the slider will adjust brightness for the light.  Note that due to differences in how Insteon/ISY and HA/Zwave handle dimming the physical responsiveness of HA nodes may look quicker at the light itself.  This is due to rate limiting of the Insteon network traffic.  Tapping OK will return to the parent screen with the new brightness while tapping Cancel will return but return the brightness to what it was.  This feature also works for ISY Scenes via the console's scene proxy support so that the common idiom for implementing 3-way lights via a set of switches in a scene is supported as one would expect.  Note that on capacitive touch screens this works very well and very responsively.  Resistive touch screens generate a huge amount of "noise" in the form of non-existant touch/release events while holding down and other similar random things.  The code has a lot of "dejittering" for all of this with the result that the resistive screens may seem a bit more sluggish in their response to finger movement, but in my experience still quite acceptable.  The slider displays by default in the "long" direction of the screen but can be overriden, see the useage notes.  In addition to these changes, there is now an alternate way to bring up the maintenance screen via a single diagonal gesture from the upper left to the lower right of the screen.  (Note: if the screen is dim you do first need to awaken it with any touch.)  Note that this has required a significant revamp to the touchscreen handling code so if you do see any apparent weirdness please report it.  Also, given that the console can now see length of touch and movement, any suggestions for other uses of that capability are welcome.  Finally, in the event that you do see strange problems with touch, you can for now revert to the previous touch driver system by creating an empty file in /home/pi names .forceoldtouch.

docs/useagenotes.md

@@ -400,7 +400,10 @@ If you set a non empty title for a screen that doesn't otherwise have one, the r
       for a prolonged period of time and the underlying device is a dimmer, then a slider screen is displayed that
       allows the brightness to be set. For Insteon/ISY hubs, dimming also applies to scenes via the scene proxy
       mechanism. This allows convient dimming for common 3-way switch setups where multiple dimmers are combined in a
-      scene to control a single load (or set of loads).
+      scene to control a single load (or set of loads). By default the slider bar will display in the longer direction
+      of the screen (e.g., horizontally for the 7 inch screen in landscape mode and vertically for the smaller screen in
+      portrait mode). This can be overriden by explicitly specifying a SlideOrientation parameter where 0 is default
+      direction, 1 is force horizontal, and 2 is force vertical).
     * RUNPROG: linked to a program to run. It issues a RunThen on the designated program for ISY hubs. It issues a
       automation.trigger for the automation for HA hubs.
     * (Deprecated-use RUNPROG with modifiers) ONBLINKRUNTHEN: linked to a program.  Will blink to provide user feedback and will issue RunThen on program

example configs/cfglib/pgalr.cfg

@@ -1,4 +1,5 @@
 [PGALR]
+DefaultHub = HASSpga
 Clocked = 1
 ScreenTitle = Living Room {:.1f}° {:.0f}% at {}
 ScreenTitleColor = red