AWOL Box - Revision history

Alnwlsn at 03:28, 15 December 2019

2019-12-15T03:28:29Z

← Older revision		Revision as of 23:28, 14 December 2019
Line 1:		Line 1:
	[[File:Awol-exterior-v1.jpg\|thumb\|What is more mysterious than a nondescript black box with buttons on it?]]		[[File:Awol-exterior-v1.jpg\|thumb\|What is more mysterious than a nondescript black box with buttons on it?]]
	The '''AWOL boxes''' are a type of reverse-geocache type device. The boxes consist of a motorized latch, GPS receiver, card reader, display, and a single exterior button. The device has several different modes, such as opening when the box reaches a target. '''Current version is 2.5'''.		The '''AWOL boxes''' are a type of reverse-geocache type device. The boxes consist of a motorized latch, GPS receiver, card reader, display, and a single exterior button. The device has several different modes, such as opening when the box reaches a target. '''Current version is 2.7'''.

	==Overview==		==Overview==
Line 70:		Line 70:
	\| 14 \|\| nxtgt \|\| Stores the number of the next target to be loaded. Used only when success is defined to do this by tgtmode.		\| 14 \|\| nxtgt \|\| Stores the number of the next target to be loaded. Used only when success is defined to do this by tgtmode.
	\|-		\|-
	\| 15 \|\| dispmode \|\| Display mode - defines what to display when the success condition is not met. Valid values are<br>0 - Display nothing (too evil to use)<br>1 - Display distance to target<br>2 - Display angle between direction of travel and vector to target, in degrees. An angle of 0 means you are heading right towards the target coordinates; positive angles means the target is counterclockwise of your direction of travel; negative angles mean the target is clockwise of your direction of travel.)<br>3 - Distance and angle to target coordinates<br>4 - Radius minus distance. Used in susmode 3 when inside circle.		\| 15 \|\| dispmode \|\| Display mode - defines what to display when the success condition is not met. Valid values are<br>0 - Display nothing (too evil to use)<br>1 - Display distance to target<br>2 - Display angle between direction of travel and vector to target, in degrees. An angle of 0 means you are heading right towards the target coordinates; positive angles means the target is counterclockwise of your direction of travel; negative angles mean the target is clockwise of your direction of travel.)<br>3 - Distance and angle to target coordinates<br>4 - Radius minus distance. Used in susmode 3 when inside circle.<br>5 - Inverse square. Displays the result of formula 10000/(distance in meters)^2, with 4 decimal places.
	\|-		\|-
	\| 16 \|\| wmsgTime \|\| Time to display the win message. This operates independently of tgtmode or the success definition.		\| 16 \|\| wmsgTime \|\| Time to display the win message. This operates independently of tgtmode or the success definition.

Alnwlsn at 20:04, 14 August 2019

2019-08-14T20:04:04Z

← Older revision		Revision as of 16:04, 14 August 2019
Line 1:		Line 1:
			[[File:Awol-exterior-v1.jpg\|thumb\|What is more mysterious than a nondescript black box with buttons on it?]]
	The '''AWOL boxes''' are a type of reverse-geocache type device. The boxes consist of a motorized latch, GPS receiver, card reader, display, and a single exterior button. The device has several different modes, such as opening when the box reaches a target. '''Current version is 2.5'''.		The '''AWOL boxes''' are a type of reverse-geocache type device. The boxes consist of a motorized latch, GPS receiver, card reader, display, and a single exterior button. The device has several different modes, such as opening when the box reaches a target. '''Current version is 2.5'''.

Alnwlsn: /* Format */

2018-12-09T05:07:00Z

Format

← Older revision		Revision as of 01:07, 9 December 2018
Line 63:		Line 63:
	\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.		\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.
	\|-		\|-
	\| 12 \|\| ~~frametime~~ \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.<br>If ~~frametime~~==0, then the attempt lasts forever.		\| 12 \|\| frameTime \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.<br>If frameTime==0, then the attempt lasts forever.
	\|-		\|-
	\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt		\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt
Line 75:		Line 75:
	\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.		\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.
	\|-		\|-
	\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no achievable criteria, but calculates distance as closest distance to gpoints path<br>255 - Uses the box as a GPS logger, with ~~frametime~~ as the time interval between taking data.		\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no achievable criteria, but calculates distance as closest distance to gpoints path<br>255 - Uses the box as a GPS logger, with frameTime as the time interval between taking data.
	\|-		\|-
	\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.		\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.

Alnwlsn: /* Format */

2018-12-09T05:05:43Z

Format

← Older revision		Revision as of 01:05, 9 December 2018
Line 63:		Line 63:
	\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.		\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.
	\|-		\|-
	\| 12 \|\| frametime \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.<br>If frametime==~~255~~, then the attempt lasts forever.		\| 12 \|\| frametime \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.<br>If frametime==0, then the attempt lasts forever.
	\|-		\|-
	\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt		\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt
Line 75:		Line 75:
	\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.		\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.
	\|-		\|-
	\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no achievable criteria, but calculates distance as closest distance to gpoints path		\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no achievable criteria, but calculates distance as closest distance to gpoints path<br>255 - Uses the box as a GPS logger, with frametime as the time interval between taking data.
	\|-		\|-
	\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.		\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.

Alnwlsn: /* Format */

2018-12-09T05:01:26Z

Format

← Older revision		Revision as of 01:01, 9 December 2018
Line 63:		Line 63:
	\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.		\| 8-11 \|\| Radius \|\| Radius - The intended distance between the box and the target coordinates. For example, the box can be programmed such that if the true distance between the box and the target is less than the radius, success is achieved.
	\|-		\|-
	\| 12 \|\| frametime \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.		\| 12 \|\| frametime \|\| Number of seconds to display information when success ''is not'' met. If success is reached within this time, the box executes the desired success routine. Otherwise, the attempt ends.<br>If frametime==255, then the attempt lasts forever.
	\|-		\|-
	\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt		\| 13 \|\| tgtmode \|\| Target mode - defines what to do when the success condition is met. Valid values are:<br>0 - Do nothing<br>1 - Open the box, then load the target specified by nxtgt<br>2 - Load the target specified by nxtgt

Alnwlsn: /* Format */

2018-12-09T04:49:55Z

Format

← Older revision		Revision as of 00:49, 9 December 2018
Line 75:		Line 75:
	\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.		\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.
	\|-		\|-
	\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no criteria, but calculates distance as closest distance to gpoints path		\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no achievable criteria, but calculates distance as closest distance to gpoints path
	\|-		\|-
	\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.		\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.

Alnwlsn: /* Format */

2018-12-09T04:49:08Z

Format

← Older revision		Revision as of 00:49, 9 December 2018
Line 75:		Line 75:
	\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.		\| 17 \|\| cost \|\| Number of credits it costs to begin an attempt.
	\|-		\|-
	\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)		\| 18 \|\| susmode \|\| Success mode - Defines ''what is'' success. Valid values are<br>0 - Success is never met<br>1 - Success is always met<br>2 - If distance between box and target coordinates is less than radius<br>3 - If distance between box and target is greater than radius<br>4 - if current block is solved inside radius (block states changes to solved when condition is met, and target is solved when all enabled block points are solved.)<br>5 - no criteria, but calculates distance as closest distance to gpoints path
	\|-		\|-
	\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.		\| 19 \|\| miscB \|\| Miscellaneous variable. Not presently used.

Alnwlsn: /* gpoint.csv */

2018-12-08T05:50:23Z

gpoint.csv

← Older revision		Revision as of 01:50, 8 December 2018
Line 111:		Line 111:
	\|}		\|}
	===gpoint.csv===		===gpoint.csv===
	The file contains a list of 128 lat/lng points, for general purpose modes that need a lot of points (like a path). This is a CSV file with 2 fields. The first field is longitude, and the second field is latitude. This matches Google Earth KML order. The end of the line must be terminated with a newline (/n), and there must be at least 128 lines. An example of what the file looks like is shown below.		The file contains a list of 128 lat/lng points, for general purpose modes that need a lot of points (like a path). This is a CSV file with 2 fields. The first field is longitude, and the second field is latitude. This matches Google Earth KML order. The end of the line must be terminated with a newline (/n), and there must be at least 128 lines. If you don't have that many points, just use points that are outside the limits of normal lat/lon ranges, and they will be ignored (but they will be loaded). An example of what the file looks like is shown below.
	<pre>-83.27916731446868,42.89518328167484		<pre>-83.27916731446868,42.89518328167484
	-83.21280764912211,42.92421565018912		-83.21280764912211,42.92421565018912

Alnwlsn: /* gpoint.csv */

2018-12-08T05:47:36Z

gpoint.csv

← Older revision		Revision as of 01:47, 8 December 2018
Line 111:		Line 111:
	\|}		\|}
	===gpoint.csv===		===gpoint.csv===
	The file contains a list of 128 lat/lng points, for general purpose modes that need a lot of points (like a path).		The file contains a list of 128 lat/lng points, for general purpose modes that need a lot of points (like a path). This is a CSV file with 2 fields. The first field is longitude, and the second field is latitude. This matches Google Earth KML order. The end of the line must be terminated with a newline (/n), and there must be at least 128 lines. An example of what the file looks like is shown below.
	<pre>-83.27916731446868,42.89518328167484		<pre>-83.27916731446868,42.89518328167484
	-83.21280764912211,42.92421565018912		-83.21280764912211,42.92421565018912

Alnwlsn: /* Files */

2018-12-08T05:44:43Z

Files

← Older revision		Revision as of 01:44, 8 December 2018
Line 110:		Line 110:
	\| 10 \|\| seconds \|\| Seconds - GPS time		\| 10 \|\| seconds \|\| Seconds - GPS time
	\|}		\|}
			===gpoint.csv===
			The file contains a list of 128 lat/lng points, for general purpose modes that need a lot of points (like a path).
			<pre>-83.27916731446868,42.89518328167484
			-83.21280764912211,42.92421565018912
			-83.175404748997,42.8843681112614
			-83.16637918496383,42.92545538497605
			-83.18245634824469,42.94563851558142</pre>

	==Functions (internal)==		==Functions (internal)==