Gocator API
GoAccelerator.h
Go to the documentation of this file.
1 /**
2  * @file GoAccelerator.h
3  * @brief Declares the GoAccelerator class.
4  *
5  * @internal
6  * Copyright (C) 2016-2026 by LMI Technologies Inc.
7  * Licensed under the MIT License.
8  * Redistributed files must retain the above copyright notice.
9  */
10 #ifndef GO_ACCELERATOR_H
11 #define GO_ACCELERATOR_H
12 
13 #include <GoSdk/GoSdkDef.h>
14 #include <GoSdk/GoSensor.h>
15 
16 /**
17  * @class GoAccelerator
18  * @extends kObject
19  * @ingroup GoSdk
20  * @brief Represents an GoAccelerator instance.
21  */
22 typedef kObject GoAccelerator;
23 
24 /**
25 * Constructs the accelerator object
26 *
27 * @public @memberof GoAccelerator
28 * @version Introduced in firmware 4.5.3.57
29 * @param accelerator Address of uninitialized accelerator object
30 * @param allocator Allocator object (kNULL for fallback allocator)
31 * @return Operation status.
32 */
33 GoFx(kStatus) GoAccelerator_Construct(GoAccelerator* accelerator, kAlloc allocator);
34 
35 /**
36  * Starts the accelerator service.
37  *
38  * @public @memberof GoAccelerator
39  * @version Introduced in firmware 4.5.3.57
40  * @param accelerator GoAccelerator object.
41  * @return Operation status.
42  */
43 GoFx(kStatus) GoAccelerator_Start(GoAccelerator accelerator);
44 
45 /**
46  * Attaches the accelerator to a sensor.
47  *
48  * The accelerator must have been started via GoAccelerator_Start first.
49  * Note that subsequent operations on the GoSensor instance will be routed through the accelerator.
50  *
51  * @public @memberof GoAccelerator
52  * @version Introduced in firmware 4.5.3.57
53  * @param accelerator GoAccelerator object.
54  * @param sensor GoSensor object.
55  * @return Operation status.
56  */
57 GoFx(kStatus) GoAccelerator_Attach(GoAccelerator accelerator, GoSensor sensor);
58 
59 /**
60  * Detaches a sensor from the accelerator.
61  *
62  * Note that subsequent operations on the GoSensor instance will no longer be routed through the accelerator.
63  *
64  * @public @memberof GoAccelerator
65  * @version Introduced in firmware 4.5.3.57
66  * @param accelerator GoAccelerator object.
67  * @param sensor GoSensor object.
68  * @return Operation status.
69  */
70 GoFx(kStatus) GoAccelerator_Detach(GoAccelerator accelerator, GoSensor sensor);
71 
72 /**
73  * Stops the accelerator service.
74  *
75  * Note that all attached GoSensor instances should be detached before stopping the accelerator.
76  *
77  * @public @memberof GoAccelerator
78  * @version Introduced in firmware 4.5.3.57
79  * @param accelerator GoAccelerator object.
80  * @return Operation status.
81  */
82 GoFx(kStatus) GoAccelerator_Stop(GoAccelerator accelerator);
83 
84 /**
85  * Reports whether or not the accelerator has been started.
86  *
87  * @public @memberof GoAccelerator
88  * @version Introduced in firmware 4.5.3.57
89  * @param accelerator GoAccelerator object.
90  * @return kTRUE if running, kFALSE otherwise.
91  */
93 
94 /**
95  * Reports whether or not the specified sensor is attached to this accelerator.
96  *
97  * @public @memberof GoAccelerator
98  * @version Introduced in firmware 4.5.3.57
99  * @param accelerator GoAccelerator object.
100  * @param sensor GoSensor object.
101  * @return kTRUE if attached, kFALSE otherwise.
102  */
103 GoFx(kBool) GoAccelerator_IsAttached(GoAccelerator accelerator, GoSensor sensor);
104 
105 /**
106  * Gets the accelerated GoSensor handle.
107  *
108  * @public @memberof GoAccelerator
109  * @version Introduced in firmware 4.5.3.57
110  * @param accelerator GoAccelerator object.
111  * @return GoSensor object.
112  */
113 GoFx(GoSensor) GoAccelerator_Sensor(GoAccelerator accelerator);
114 
115 /**
116  * Sets a handler for Accelerated sensor connect/disconnect updates for this object.
117  *
118  * This handler will be called if the accelerator loses or regains connection to an
119  * attached sensor.
120  *
121  * @public @memberof GoAccelerator
122  * @version Introduced in firmware 4.6.4.66
123  * @param accelerator GoAccelerator object.
124  * @param function Connection update callback function (or kNULL to unregister).
125  * @param receiver Receiver argument for callback.
126  * @return Operation status.
127  */
128 GoFx(kStatus) GoAccelerator_SetAcceleratorUpdateHandler(GoAccelerator accelerator, kCallbackFx function, kPointer receiver);
129 
130 /**
131  * Sets the IP address to use for the accelerator.
132  *
133  * @public @memberof GoAccelerator
134  * @version Introduced in firmware 4.5.3.57
135  * @param accelerator GoAccelerator object.
136  * @param address IP address to use for the accelerator web server.
137  * @return Operation status.
138  */
139 GoFx(kStatus) GoAccelerator_SetIpAddress(GoAccelerator accelerator, kIpAddress address);
140 
141 /**
142  * Gets the IP address used for the accelerator.
143  *
144  * @public @memberof GoAccelerator
145  * @version Introduced in firmware 4.5.3.57
146  * @param accelerator GoAccelerator object.
147  * @return IP address used for the accelerator web server.
148  */
150 
151 /**
152  * Sets the control port to use for the accelerator.
153  *
154  * @public @memberof GoAccelerator
155  * @version Introduced in firmware 4.5.3.57
156  * @param accelerator GoAccelerator object.
157  * @param port Port to use for accelerator control.
158  * @return Operation status.
159  */
160 GoFx(kStatus) GoAccelerator_SetControlPort(GoAccelerator accelerator, k32u port);
161 
162 /**
163  * Gets the control port used for the accelerator.
164  *
165  * @public @memberof GoAccelerator
166  * @version Introduced in firmware 4.5.3.57
167  * @param accelerator GoAccelerator object.
168  * @return Port used for accelerator control.
169  */
170 GoFx(k32u) GoAccelerator_ControlPort(GoAccelerator accelerator);
171 
172 /**
173  * Sets the health port to use for the accelerator.
174  *
175  * @public @memberof GoAccelerator
176  * @version Introduced in firmware 4.5.3.57
177  * @param accelerator GoAccelerator object.
178  * @param port Port to use for accelerator health.
179  * @return Operation status.
180  */
181 GoFx(kStatus) GoAccelerator_SetHealthPort(GoAccelerator accelerator, k32u port);
182 
183 /**
184  * Gets the health port used for the accelerator.
185  *
186  * @public @memberof GoAccelerator
187  * @version Introduced in firmware 4.5.3.57
188  * @param accelerator GoAccelerator object.
189  * @return Port used for accelerator health.
190  */
191 GoFx(k32u) GoAccelerator_HealthPort(GoAccelerator accelerator);
192 
193 /**
194  * Sets the upgrade port to use for the accelerator.
195  *
196  * @public @memberof GoAccelerator
197  * @version Introduced in firmware 4.5.3.57
198  * @param accelerator GoAccelerator object.
199  * @param port Port to use for accelerator upgrades.
200  * @return Operation status.
201  */
202 GoFx(kStatus) GoAccelerator_SetUpgradePort(GoAccelerator accelerator, k32u port);
203 
204 /**
205  * Gets the upgrade port used for the accelerator.
206  *
207  * @public @memberof GoAccelerator
208  * @version Introduced in firmware 4.5.3.57
209  * @param accelerator GoAccelerator object.
210  * @return Port used for accelerator upgrades.
211  */
212 GoFx(k32u) GoAccelerator_UpgradePort(GoAccelerator accelerator);
213 
214 /**
215  * Sets the web server port to use for the accelerator.
216  *
217  * @public @memberof GoAccelerator
218  * @version Introduced in firmware 4.5.3.57
219  * @param accelerator GoAccelerator object.
220  * @param port Port to use for the accelerator web server.
221  * @return Operation status.
222  */
223 GoFx(kStatus) GoAccelerator_SetWebPort(GoAccelerator accelerator, k32u port);
224 
225 /**
226  * Gets the web server port used for the accelerator.
227  *
228  * @public @memberof GoAccelerator
229  * @version Introduced in firmware 4.5.3.57
230  * @param accelerator GoAccelerator object.
231  * @return Port used for the accelerator web server.
232  */
233 GoFx(k32u) GoAccelerator_WebPort(GoAccelerator accelerator);
234 
235 /**
236  * Sets the private data port to use for the accelerator.
237  *
238  * @public @memberof GoAccelerator
239  * @version Introduced in firmware 4.5.3.57
240  * @param accelerator GoAccelerator object.
241  * @param port Port to use for accelerator private data.
242  * @return Operation status.
243  */
245 
246 /**
247  * Gets the private data port used for the accelerator.
248  *
249  * @public @memberof GoAccelerator
250  * @version Introduced in firmware 4.5.3.57
251  * @param accelerator GoAccelerator object.
252  * @return Port used for accelerator private data.
253  */
255 
256 /**
257  * Sets the public data port to use for the accelerator.
258  *
259  * @public @memberof GoAccelerator
260  * @version Introduced in firmware 4.5.3.57
261  * @param accelerator GoAccelerator object.
262  * @param port Port to use for accelerator public data.
263  * @return Operation status.
264  */
266 
267 /**
268  * Gets the public data port used for the accelerator.
269  *
270  * @public @memberof GoAccelerator
271  * @version Introduced in firmware 4.5.3.57
272  * @param accelerator GoAccelerator object.
273  * @return Port used for accelerator public data.
274  */
276 
277 /**
278  * Sets the heartbeat port to use for the accelerator.
279  *
280  * The accelerator uses this port to send UDP heartbeat packets to SDK clients
281  * for fast disconnection detection (~100ms vs ~6 seconds with health-based).
282  *
283  * @public @memberof GoAccelerator
284  * @version Introduced in firmware 6.6.4.3
285  * @param accelerator GoAccelerator object.
286  * @param port Port to use for accelerator heartbeat.
287  * @return Operation status.
288  */
290 
291 /**
292  * Gets the heartbeat port used for the accelerator.
293  *
294  * @public @memberof GoAccelerator
295  * @version Introduced in firmware 6.6.4.3
296  * @param accelerator GoAccelerator object.
297  * @return Port used for accelerator heartbeat (default: 3195).
298  */
300 
301 /**
302  * Sets the target (address, port) for heartbeat packets.
303  *
304  * This is the (address, port) of the SDK client where the heartbeat receiver
305  * is listening. The accelerator will send UDP heartbeat packets to this
306  * endpoint. The port is wire-data carried alongside the address so that the
307  * SDK can bind to an OS-assigned ephemeral port and report it here, allowing
308  * a single process to monitor multiple sensors without port collisions.
309  *
310  * @public @memberof GoAccelerator
311  * @version Introduced in firmware 6.6.4.3
312  * @param accelerator GoAccelerator object.
313  * @param address Target IP address for heartbeat packets.
314  * @param port Target UDP port for heartbeat packets.
315  * @return Operation status.
316  */
317 GoFx(kStatus) GoAccelerator_SetHeartbeatTarget(GoAccelerator accelerator, kIpAddress address, k32u port);
318 
319 /**
320  * Enables or disables heartbeat sending from the accelerator.
321  *
322  * When enabled, the accelerator will send UDP heartbeat packets to the
323  * configured target address and port at regular intervals (~25ms).
324  * SDK clients can use GoSensor_EnableHeartbeat() to receive these packets
325  * and detect disconnection within ~100ms.
326  *
327  * @public @memberof GoAccelerator
328  * @version Introduced in firmware 6.6.4.3
329  * @param accelerator GoAccelerator object.
330  * @param enable kTRUE to enable heartbeat, kFALSE to disable.
331  * @return Operation status.
332  */
333 GoFx(kStatus) GoAccelerator_EnableHeartbeat(GoAccelerator accelerator, kBool enable);
334 
335 #include <GoSdk/GoAccelerator.x.h>
336 
337 #endif
k32u GoAccelerator_PublicDataPort(GoAccelerator accelerator)
Gets the public data port used for the accelerator.
kStatus GoAccelerator_Start(GoAccelerator accelerator)
Starts the accelerator service.
kBool GoAccelerator_IsRunning(GoAccelerator accelerator)
Reports whether or not the accelerator has been started.
k32u GoAccelerator_ControlPort(GoAccelerator accelerator)
Gets the control port used for the accelerator.
Declares the GoSensor class.
kStatus GoAccelerator_EnableHeartbeat(GoAccelerator accelerator, kBool enable)
Enables or disables heartbeat sending from the accelerator.
k32u GoAccelerator_PrivateDataPort(GoAccelerator accelerator)
Gets the private data port used for the accelerator.
kStatus GoAccelerator_SetPrivateDataPort(GoAccelerator accelerator, k32u port)
Sets the private data port to use for the accelerator.
kBool GoAccelerator_IsAttached(GoAccelerator accelerator, GoSensor sensor)
Reports whether or not the specified sensor is attached to this accelerator.
kStatus GoAccelerator_SetIpAddress(GoAccelerator accelerator, kIpAddress address)
Sets the IP address to use for the accelerator.
kStatus GoAccelerator_SetAcceleratorUpdateHandler(GoAccelerator accelerator, kCallbackFx function, kPointer receiver)
Sets a handler for Accelerated sensor connect/disconnect updates for this object. ...
kIpAddress GoAccelerator_IpAddress(GoAccelerator accelerator)
Gets the IP address used for the accelerator.
Essential SDK declarations.
kStatus GoAccelerator_Construct(GoAccelerator *accelerator, kAlloc allocator)
Constructs the accelerator object.
kObject GoAccelerator
Forward declaration for GoAccelerator.
Definition: GoSdkDef.h:233
k32u GoAccelerator_HealthPort(GoAccelerator accelerator)
Gets the health port used for the accelerator.
kStatus GoAccelerator_SetHeartbeatPort(GoAccelerator accelerator, k32u port)
Sets the heartbeat port to use for the accelerator.
k32u GoAccelerator_HeartbeatPort(GoAccelerator accelerator)
Gets the heartbeat port used for the accelerator.
kStatus GoAccelerator_Attach(GoAccelerator accelerator, GoSensor sensor)
Attaches the accelerator to a sensor.
k32u GoAccelerator_UpgradePort(GoAccelerator accelerator)
Gets the upgrade port used for the accelerator.
Represents an GoAccelerator instance.
kStatus GoAccelerator_SetPublicDataPort(GoAccelerator accelerator, k32u port)
Sets the public data port to use for the accelerator.
k32u GoAccelerator_WebPort(GoAccelerator accelerator)
Gets the web server port used for the accelerator.
kStatus GoAccelerator_SetHeartbeatTarget(GoAccelerator accelerator, kIpAddress address, k32u port)
Sets the target (address, port) for heartbeat packets.
kStatus GoAccelerator_SetUpgradePort(GoAccelerator accelerator, k32u port)
Sets the upgrade port to use for the accelerator.
kStatus GoAccelerator_SetWebPort(GoAccelerator accelerator, k32u port)
Sets the web server port to use for the accelerator.
kStatus GoAccelerator_Detach(GoAccelerator accelerator, GoSensor sensor)
Detaches a sensor from the accelerator.
GoSensor GoAccelerator_Sensor(GoAccelerator accelerator)
Gets the accelerated GoSensor handle.
kStatus GoAccelerator_SetHealthPort(GoAccelerator accelerator, k32u port)
Sets the health port to use for the accelerator.
kStatus GoAccelerator_SetControlPort(GoAccelerator accelerator, k32u port)
Sets the control port to use for the accelerator.
Represents a Gocator sensor.
kStatus GoAccelerator_Stop(GoAccelerator accelerator)
Stops the accelerator service.