feat: ⚡ add ability to manually poll from simpl bridge or devjson examples.

Out of the box polling is 15 seconds. If faster polling is required an option to manually poll via simpl bridge or devjson has been added.

Author: jonnyarndt

README.md

@@ -4,6 +4,8 @@
 
 # Megapixel Helios (c) 2024
 
+Minimum Helios firmware version = `24.11.0.23030`
+
 ## License
 
 Provided under MIT license
@@ -83,6 +85,7 @@ The `port` object is only needed when overriding the default HTTP `80` or HTTPS
 | ----------- | --------- | --------------------     | ------- | ------------ |
 | 1           | 1         | Power Off (blackout)     | Digital | ToFromSIMPL  |
 | 2           | 1         | Power On (blackout)      | Digital | ToFromSIMPL  |
+| 3           | 1         | Poll (public API)        | Digital | FromSIMPL    |
 | 4           | 1         | Redundancy Role Main     | Digital | ToFromSIMPL  |
 | 5           | 1         | Redundancy Role Backup   | Digital | ToFromSIMPL  |
 | 6           | 1         | Redundancy Role Offline  | Digital | ToFromSIMPL  |
@@ -136,6 +139,7 @@ Public Methods that can be used with `devjson` to test controls.
 ```json
 devjson:1 {"deviceKey":"display-1","methodName":"PowerOn"                    ,"params":[       ]}
 devjson:1 {"deviceKey":"display-1","methodName":"PowerOff"                   ,"params":[       ]}
+devjson:1 {"deviceKey":"display-1","methodName":"Poll"                       ,"params":[       ]}
 devjson:1 {"deviceKey":"display-1","methodName":"GetRedundancyState"         ,"params":[       ]}
 devjson:1 {"deviceKey":"display-1","methodName":"SetRedundancyRoleToMain"    ,"params":[       ]}
 devjson:1 {"deviceKey":"display-1","methodName":"SetRedundancyRoleToBackup"  ,"params":[       ]}

src/MegapixelHelioBridgeJoinMap.cs

@@ -37,6 +37,20 @@ public class MegapixelHeliosBridgeJoinMap : JoinMapBaseAdvanced
 				JoinType = eJoinType.Digital
 			});
 
+        [JoinName("Poll")]
+        public JoinDataComplete Poll = new JoinDataComplete(
+            new JoinData
+            {
+                JoinNumber = 3,
+                JoinSpan = 1
+            },
+            new JoinMetadata
+            {
+                Description = "Poll device public API",
+                JoinCapabilities = eJoinCapabilities.FromSIMPL,
+                JoinType = eJoinType.Digital
+            });
+
         [JoinName("SetRedundancyRoleToMain")]
         public JoinDataComplete SetRedundancyRoleToMain = new JoinDataComplete(
             new JoinData

src/MegapixelHeliosController.cs

@@ -505,6 +505,8 @@ public override void LinkToApi(BasicTriList trilist, uint joinStart, string join
 			trilist.SetSigTrueAction(joinMap.PowerOn.JoinNumber, PowerOn);
 			trilist.SetSigTrueAction(joinMap.PowerOff.JoinNumber, PowerOff);
 
+            trilist.SetSigTrueAction(joinMap.Poll.JoinNumber, () => Poll());
+
             trilist.SetSigTrueAction(joinMap.TestPatternOn.JoinNumber, TestPatternOn);
             trilist.SetSigTrueAction(joinMap.TestPatternOff.JoinNumber, TestPatternOff);
 
@@ -1051,7 +1053,13 @@ public void PowerOn()
 			}
 
             Debug.Console(MegapixelHeliosDebug.Notice, this, "PowerOn: content-'{0}'", content);
-			_client.SendRequest("PATCH", "/api/v1/public", content);
+
+            CrestronInvoke.BeginInvoke((o) =>
+            {
+                _client.SendRequest("PATCH", "/api/v1/public", content);
+                Thread.Sleep(2000);
+                Poll();
+            });
 		}
 
 		/// <summary>
@@ -1083,7 +1091,13 @@ public void PowerOff()
 			}
 
 			Debug.Console(MegapixelHeliosDebug.Notice, this, "PowerOff: content-'{0}'", content);
-			_client.SendRequest("PATCH", "/api/v1/public", content);
+
+            CrestronInvoke.BeginInvoke((o) =>
+            {
+                _client.SendRequest("PATCH", "/api/v1/public", content);
+                Thread.Sleep(2000);
+                Poll();
+            });
 		}
 
         /// <summary>
@@ -1156,7 +1170,13 @@ public void TestPatternOn()
             }
 
             Debug.Console(MegapixelHeliosDebug.Notice, this, "TestPatternEnable: content-'{0}'", content);
-            _client.SendRequest("PATCH", "/api/v1/public", content);
+
+            CrestronInvoke.BeginInvoke((o) =>
+            {
+                _client.SendRequest("PATCH", "/api/v1/public", content);
+                Thread.Sleep(2000);
+                Poll();
+            });
         }
 
         /// <summary>
@@ -1191,7 +1211,13 @@ public void TestPatternOff()
             }
 
             Debug.Console(MegapixelHeliosDebug.Notice, this, "TestPatternEnable: content-'{0}'", content);
-            _client.SendRequest("PATCH", "/api/v1/public", content);
+
+            CrestronInvoke.BeginInvoke((o) =>
+            {
+                _client.SendRequest("PATCH", "/api/v1/public", content);
+                Thread.Sleep(2000);
+                Poll();
+            });
         }
 
 		/// <summary>
@@ -1279,7 +1305,13 @@ public void RecallInputByName(string name)
             }
 
             Debug.Console(MegapixelHeliosDebug.Notice, this, "RecallInputByName: content-'{0}'", content);
-            _client.SendRequest("PATCH", "/api/v1/public", content);
+            
+            CrestronInvoke.BeginInvoke((o) =>
+            {
+                _client.SendRequest("PATCH", "/api/v1/public", content);
+                Thread.Sleep(3000);
+                Poll();
+            });
         }
 	}
 }