This article discusses the System Parameters of the Falcon.
The defaults have been selected to provide strong performance across a wide variety of applications. However the Falcon is a feature-packed product that can suit many niche applications, and parameters may need to be adjusted to suit.
Some parameters are self explanatory or their description in OEM covers their meaning and use. Some are elaborated on below. All screenshots are of default settings.
Heartbeat: Time period in minutes of inactivity before a heartbeat upload - how often the device will report when sitting stationary or not in trip. This is the maximum time between uploads.
In Trip Upload and Logging - Defaults shown
E.g. defaults of 2 min/30 min for these parameters mean while moving, a GPS position is recorded every 2 min, and all of these records are uploaded every 30 min (you only see movement on the platform every 30 min)
Other parameters as described.
This tab has the options to change the type of tracking the unit uses.
Standard GPS Tracking: This mode of operation is the 'standard' mode for other battery powered devices - the Oyster2 and Remora2.
Periodic Tracking: Heartbeats only, no movement/trip tracking enabled
Jostle Based Tracking: Uses the Accelerometer to measure movement, trip starts and ends
Turn by Turn GPS Tracking: Functions similar to a powered device. i.e Dart2, G62, Bolt
Primary Tracking Method: Whether to use WiFi or GPS as it's first location fix scan.
Failover Tracking Method: Method to determine location if primary method fails.
Cell Tower Fallback: When Primary and Failover methods fail at getting location, use Cell Tower location method
Non-Trip WiFi Lookups: Use WiFi lookups for Heartbeats or other fixes out of trip.
Upload on Trip Start: Yes/No
Upload during Trip: If Yes, Time period for Upload is in 'Basic Tracking' tab
Upload on Trip End: Yes/No
Upload on Jostle: Yes/No - see article on Jostle Mode for a description.
Suppress GPS Wander: This option filters out small scale GPS movements
Optimise for Low Signal: Yes/No.
Location Fix on Heartbeat: Yes/No
Digital Input: Digital Input to set when a movement trip starts. Default is DI0 for (device's ignition input) - see here for why you may need to adjust this Transported Trips
Movement Threshold (m): This is the minimum amount of distance the device must travel to begin a trip.
Movement Count: This is the number of positions over the threshold before a trip starts. The GPS samples second by second until movement count is reached. Increasing this helps to help prevent erroneous fixes starting trips.
These parameters only apply if Tracking Mode = Jostle Mode under Advanced Tracking
Digital Input: Input to set as active when Jostle trip commences
Assumed Start Point Range (m): Set this distance to determine whether to retroactively move the start point of trips if it is within x metres of previous end point.
Trip End Time(s):Amount of time with no movement detected until end trip is set
Disable Wakeup Filter: Set to 'Yes' if you wish to disable wakeup via Accelerometer
Disable Wakeup Filter After Hours: Set to 'Yes' if you wish to selectively disable wake filter as per After Hours Settings
Turn-by-Turn GPS Tracking
Heartbeat Upload Period (min): Period of time before a heartbeat upload.
Time(s): Log an record after this period of time has elapsed.
Distance(m): Log a record after this distance has been travelled.
Heading Change Short(deg): Log a record when the device has changed heading by this degree while under the distance threshold.
Heading Change Long(deg): Log a record when the device has changed heading by this degree while over the distance threshold.
Heading Change Distance (m): Distance threshold for heading degree changes.
Speed Change (km/h): Log a record when the speed changes by this amount.
Stationary: Yes/No, Log a record when device becomes stationary.
DOP, Position & Speed Accuracy: These settings allow you to configure the minimum accuracy accepted for a fix. The PDOP is a measure of how imprecise a GPS fix is. This is due to the satellites that are used being too close together to triangulate effectively. Please note that values lower than 2.0 for PDOP will be difficult to achieve in practice. Default Position Accuracy is 50 metres.
Static Hold: If a device is measured to be going less than this speed, it will set it to stationary and it's position fixed.
GPS Model: This selects a statistical module used by the GPS hardware when filtering out noise during GPS fixes. Generally choose Automotive
Discard First N Fixes: This option discards a configurable number of points from the GPS if the PDOP is above 2.3. This gives the GPS some time to improve its accuracy, and lowers the chance of outlying GPS fixes slipping through the filters.
Advanced GPS Settings
This tab lets the user change the minimum strength & timeout periods for GPS Satellites. It is recommended you do not modify these unless you know what you're doing.
For a greater detailed explanation of Upload Timeouts, please view this page on our knowledge base
Recovery Mode Setup
- Recovery mode has a severe impact on battery life. Remember to bring the device out of recovery mode as soon as possible. These settings will override normal parameters when Recovery mode is activated.
Digital Input to set for 'Good' battery voltage level.
Battery Capacity Settings
The Falcon has a coulomb counter, which tracks energy (in mAh), used by the battery. This can be used to estimate the battery percentage, and remaining battery life. However these estimates rely on an assumption of the total capacity of the batteries. This can vary per battery type, and even on a single type quite significantly due to temperature variations.
The assumed battery capacity can be edited in this section.
Task 1 & 2
Scheduling Tasks on the Falcon are for taking readings from sensors and probes attached to the unit. For a more indepth look at tasks, read the Knowledge base article in the How To section.
Digital Inputs 1& 2
The device has 2 digital inputs along with it's sensor inputs.
All Digital inputs have configurable biasing (pull up/down). The default configuration for all inputs is pulled up, active low. This can easily be used with a pull to ground switch.
There is one tab for Digital Input 1 and another tab for Digital Input 2. The parameters have the same functions for their respective inputs.
Function: Sets the function of the digital input. To use the inputs as standard digital inputs, select Digital Input.
Digital Input: The logical digital input to map the function to. By default input 1 maps to Input 1 and input 2 maps to Input 2.
Bias Resistor: This gives the option to internally pull the input high, low or disable the bias. Digital inputs switch between high (1) and low (0). If one of the states is open-circuit (disconnected) then you will need to enable a bias resistor setting, opposite to the level the input is being switched to. For example, if a panic button connects the line to ground when pushed, it needs a pull-up resistor enabled to ensure that the line is held high when the button is not pushed and is open-circuit.
Active Level: Determines the polarity of the input. High means the input is on when the physical wire is pulled to a high voltage. Low means the input is on when the physical wire is pulled to a low voltage.
Log On Active: Whether a Digital Input Change record should be logged on a change from inactive (off) to active (on).
Log On Inactive: Whether a Digital Input Change record should be logged on a change from active (on) to inactive (off).
Upload On Active: Whether an upload should be requested on a change from inactive (off) to active (on).
Upload On Inactive: Whether an upload should be requested on a change from active (on) to inactive (off).
Emergency Uploads: This determines whether the upload should treated as an emergency (essential upload) or not. Emergency uploads will not time out. This is useful for a panic button for example.
Config1: holds the debounce period in milliseconds.
3.3 Volt Output
This tab controls the activation, logging and uploading options for the 3.3V output.
Function: None, Digital Output or Buzzer.
Switched Ground Output
This tab controls the activation, logging and uploading options for the 3.3V output.
Function: None, Digital Output, Buzzer or Immobiliser.
DM Temperature Sensors 1-4
Choose the Analogue inputs for the Temperature sensors. Defaults are Sensor 1 - Input 8, Sensor 2, input 9 and so on.
DM Ambient Sensor
Choose the Analogue inputs for the Temperature sensors. Defaults are Input 12 for Temperature analogue and Input 13 for Humidity analogue
Analog Thresholds 1 & 2
In use cases where sensor data needs to be monitored and alerts to be sent when thresholds are exceed or dropped below, you can set up tasks to measure the sensor data, and Analog thresholds to Alert on the data.
Analog Input: Input to monitor and checked against thresholds
Enable Low Threshold: Yes/No
Enable High Threshold: Yes/No
High Threshold Value: -999 to 999
Low Threshold Value: -999 to 999
Upload on Event: Yes/No to upload when thresholds crossed
Log Record on Event End: Yes/No
Upload on Event End: Yes/No
Log Record Every Event: Yes/No
Upload Every Event: Yes/No
Hysteresis: Amount the temperature has to drop below the threshold in order to trigger event again
Digital Alarm Input: Map to digital input to activate when event occurs
1. After each wakeup, the Oyster sleeps for a short, fixed, time. This limits the maximum rate of wakeups, and gives the asset an opportunity to get underway if it really is beginning a trip.
In this case, the first GPS fix will be more likely to detect movement.
2. If too many jostle event are detected without any real movement being detected, the Oyster will temporarily ignore the accelerometer, and sleep for a longer time before checking the GPS for movement. This provides a stricter limit on the maximum rate of wakeups.
Wakeup Delay: Amount of time sleeping after initial jostle until device will try to obtain a GPS fix. generally recommended to be set between 10-60 seconds.
No Movement Limit: Amount of times accelerometer has detected movement but no trip has been started before unit ignores Accelerometer.
Jostle Upload Delay and Maximum Jostle Upload Delay: These are the timing parameters relevant to the Advanced Tracking -> Upload On Jostle option.
Jostle Upload Delay : This is the number of seconds to wait after a jostle before scheduling an upload.
Maximum Jostle Upload Delay: This prevents the upload being rescheduled (delayed) indefinitely during continuous jostling, by forcing it to take place within a specified number of seconds after the jostling begins.
Jostle Upload Threshold: This feature optionally limits these uploads to those that show appreciable movement
Wakeup Threshold: This option sets the G force required on any of the accelerometer axes to trigger a wakeup.
Wakeup Count: This sets the required duration of the force, with 0 being a single sample
Accelerometer wakeups are used in several circumstances:
1. To trigger a GPS movement check, in regular GPS tracking mode
2. To detect a trip, in Jostle Based Tracking mode
3. To schedule an upload, if Upload On Jostle is configured, the default setting is for maximum sensitivity, and is appropriate for light vehicles.
If you have a problem with constant wakeups in GPS tracking mode, false trips in Jostle Based Tracking Mode, or excessive heartbeat uploads with Upload On Jostle, it may be necessary to increase the thresholds. Increasing the thresholds may improve battery life by lowering the number of unnecessary wakeups, but it increases the chances of a trip start being missed
The SMS tab has the option to enable or disable SMS commands. for more information please view the attached support article.
You may want to disable SMS to prevent others from adjusting device settings via SMS
Select the max amount of Access Points to be scanned for when doing a Wi-Fi scan. Leave as default for most use cases
The Inactivity Timer is a new function on Firmware 1.13v or newer and functions as a timer where the 'Inactive' Digital input is set when an asset has not registered a trip for the set time.
Please note this is different to a device not connecting report, where a device has not been able to connect & Commit to the server in x amount of time.