Settings

Settings - as of DSRC V2.6

As there are getting quite a lot of possible settings, they are now grouped into (hopefully) logical sections, namely:

    • Race/Start

    • Results

    • Interfaces

    • Admin and Debug

Lets go through them one section at a time...

RACE/START - These define what the race is...

Race Type - Single / Multi-Fleet Rolling / Pursuit

    • Single fleet, with a single start (Combined Results)

    • Multiple fleet involved, with multiple rolling starts (Results by Fleet)

    • Pursuit - Race, Auto Start signals based on race time and selected classes.

      • Pursuit duration - hh:mm:ss (can also be set from within the Race Screen)

      • Pursuit Start Interval 30, 60, or Exact seconds

Pause between starts - None/All Starts/Gen Recall

    • None - Rolling start continue with out break.

    • Pause Between All Starts - The countdown for next start will pause until resume is pressed.

    • Pause only on General Recall, - The countdown for next start will pause if the was a Gen Recall resume after Clear Signal and Resume pressed .

GR Restarts

    • Next Start - Recalled Star, starts next

    • After Other starts - Recalled starts after all other starts.

Pre-Start delay - 0, 10s, 30s, 1m, 2m, 5m (or custom)

This is a delay before the main start sequence, which can range from seconds to give competitors time to reach their race watch, to minutes to allow boats to set off to the start area.

Note - If the Starting Sequence (see below) is set to custom, then the pre-start value defined there overrides any Pre-Start delay that might have been set previously.

Starting Sequence - 5m, 4m, 1m, Go / 3m, 2m, 1m, Go / custom / RC Countdown

If 5, 4, 1, Go, app will sound:

    • Class Up at 5 minutes to go

    • Prep Up at 4 minutes to go

    • Prep Down at 1 minute to go

    • Class Down and Start at zero

If 3, 2, 1, Go, app will sound:

    • Class Up at 3 minutes to go

    • Prep Up at 2 minutes to go

    • Prep Down at 1 minute to go

    • Class Down and Start at zero

If custom, app will present a popup dialogue to capture, and use:

    • Pre-Start - hh:mm:ss (and can be zero). Used in place of Pre-Start delay.

    • 1st Start Class Up - Special case, used for first rolling start only (or can be same as Standard)

    • Standard Class Up - Normal Class up

    • Prep Up

    • Prep Down

If RC Countdown, app will use 'announcements' contained in a user definable text file, of the format:

  • time text (example: 1:05 countdown starts in 5 seconds)

It also forces the following settings:

  • Multi-Fleet is disabled (as this will only be a single start race)

  • Pre-Start delay is disabled (as pre-start if any is controlled by text file)


Sound - On/Off

    • If On, app will sound 'horns' at event points, and voice/beep countdowns (if set)

    • If Off, app will mute 'horns' and countdowns

Countdown sound - Beeps/Voice/None

    • If Beeps, app will make a 'beep' sound at 10s, 5s, 4,s, 3s, 2s, and 1s prior to event

    • If Voice, app will 'announce' at 10, 5, 4, 3, 2 , and 1 prior to event

    • None - app will mute countdown sounds

Addition Voice Prompts

    • If On, app will additionally prompts every 30 seconds, plus one more at 20 seconds to go to next event.

Second Ticks

    • If On, app will beep every second (like a heart beat') until 5 seconds to Start, and change 'sound' after Prep down

Self sign on - On/Off

    • If On, app will request confirmation of competitor selection or deselection on competitors screen

    • If Off, app will not request confirmation

Note - Admin mode overrides this setting i.e. If Admin On, then no confirmation is required

Instant Undo - On/Off

    • This option enables a second press during racing on the same entry to undo the previous timings capture (i.e. same as 'lap-1' within Edit entry)

RESULTS - These define what results look like, and what optional output is created

Final timing format

    • If Seconds, app displays (and outputs) final times as whole seconds

    • If mm:ss, app display (and outputs) final times in mm:ss

Note - Some output formats require 'special' time formats that aren't effected by this setting e.g. Sailwave requires all times as hh:mm:ss

Result exports - Postscript/Sailwave/Hal/HTML

These are optional additional outputs, from which you can select none to all:

    • Postscript .pdf - Tip - Have this on if you want instant viewing of results from Race Screen

    • Sailwave .csv - Sailwave compatible comma separated value file

    • Sailwave Multi Race .csv - Whilst active, all result are stored in one Multi Race .csv file

    • Spreadsheet .xls - HAL compatible excel spreadsheet

    • HTML Format - HTML file.

Logo in HTML

    • If On, app will embed the custom Logo in the HTML Header

Notes on logo embedding:

There is quite an overhead on the resulting files size.

Embedding only occurs if you have a custom logo defined

Series Results File - (Early Days)

Currently requires Sailwave Multi Race to be selected in Results Exports.

  • If None - Series Results are written to a new file and file name updated. eg RC-2021-01-23-11:53:22 Multi Race.csv

  • Pick - Allows you to select a series file.

Note - Series file selected must be of correct format could a renamed one previously created by app.

If Active user is prompted to retain series file of have a new one at each session start.

PDF orientation - Portrait/Landscape

    • If Portrait, app will format postscript results output in portrait

    • If Landscape, app will format postscript results output in Landscape

Sailing Club name - Free text

You can enter the name of your Sailing Club here, which is used in the title of Postscript results output, and is also used by self Sign on (if On)

Sailing Club Logo

Although like me, you love the 'Sailor Penguin', you can download your own club logo image file, and select it for use on Main Screen, and also Postscript results output

Automatic Results save - On/Off

    • If On, app will automatically save race results when end race is confirmed, and display the Results button for instant review

    • If Off, app will display Save button

Hint - Safest option if to have AutoSave On, just in case you forget to press Save...

INTERFACES - Things the app can 'talk to'

Wifi external horn - On/Off

    • If On, app will attempt to send 'horn' commands to the external Wifi relay module specified below

    • If Off, app ignore external Wifi devices

WARNING - This is very much Experimental, so please don't rely on them (yet)

Note - You need the DSRC relay module code installed in the device...

Wifi signal lights - On/Off

Lights uses a quad relay to activate Lights to represent various Flags for Class, Prep, Recalls, Shorten, Finish, Postpone, Abandon,

    • If On - app will add in the additional functionality to Triger this relays and present Clear option to the user to indicate flag is removed.

Wifi timer display - On/Off - THIS SHOULD BE ON for V2.5 onwards

This allows for the app to drive a NeoPixel style 4+ digit (mm:ss) timer display (be aware this is a totally DIY build)

    • If On - app send the appropriate time signal to the external clock.

    • You can adjust the brightness of the display

    • A long press on option will also allow you to select the R G B colour mix for the display in it various modes, i.e. Count down, up finish, RTC.

Wifi device info - IP/Port

Here you define the details of the Wifi module the app should set horn commends to:

    • IP Address - default is 192.168.4.1

    • Port number - default is 23

Note - You need the DSRC relay module code installed in the device...

BT external horn - On/Off

    • If On, app will attempt to send 'horn' commands to the external Bluetooth relay module specified below

    • If Off, app ignore external Bluetooth devices

WARNING - This is very much Experimental, so please don't rely on them (yet)

Note - No extra software is required for the BT system

BT device info - Device name

Here you define the Bluetooth device name you want app to send horn commands to:

    • Select paired device - default name is 'BT04-A'

Note - If Bluetooth is not enabled on your device, app will request permission to enable it.

BT short horn duration

Here you define the duration the BT relay will close when sounding a short Horn.

  • Set the duration of the horn in milliseconds.

Note - Long horn is twice the duration of the short horn


ADMIN - Stuff you normally set up once...

Admin mode - On/Off

    • If On, app enable 'extra' functions which may be considered 'dangerous', mainly within the Competitors Screen e.g. Delete ALL competitors

    • If Off, app disables 'extra' functions

Edit Fleet info

    • View and Edit Fleet info as a text file. (No Validation, You've been warned)

Edit Countdown info

    • View and Edit the text used as Voice prompts in the RC countdown.

Time in mm:ss followed by the text Spoken. eg 1:00 60 seconds to the start

Edit Sailwave Headers

    • Change the column heading s in the CSV and XLS files. Allow for flexible integration with multiple results programs.

    • For more info click here

Edit Class Ratings (PYNs)

    • View and Edit Rating info as a text file. (No Validation, You've been warned)

    • Load replacement or updated file of Ratings

    • For more info click here

Custom settings - None/Load/Save

To allow the retention and use of differing configurations of settings, you can create a custom sets and swap between them as required.

Additionally, you can create a custom set of competitors, 'link' them into a custom settings set, and then at load point decide if you want to use that competitors (or not).

Notes:

  • At custom settings save point, you can decided to no longer retain 'link' (if there is one)

  • Custom competitor sets are created via the Competitors Screen via the 'Save Custom Competitors' option

  • The custom settings and custom competitors are held completely separate to the 'standard' setting and competitors, which are used when no custom files are active.

Custom flags - On/Off

If active, app will try to locate an appropriate flag for Single Class, Fleet, or Mixed class fleet.

App looks first in /flags, then internally, and if no match is found, then the default class flag is used

Flag files can be import and managed via the Files button within Custom flags section

Battery Monitor - None/Low only/Green Yellow Red

As the Race Screen will be full screen and 'held on', it is not possible to see the devices battery state without interactions.

The Battery Monitor setting allow you to enable a background monitor:

  • None - Effectively monitor Off

  • Low warning only - Changes bottom 'band' to Red when battery is below 20%

  • Green, Yellow, Red - Changes bottom 'band' to: 100-50% Green, 50-20% Yellow, below 20% Red

Race search mode - Enhanced/Standard

Choose between:

  • Enhanced search - In Competitor or Race view - Searches all competitors, plus creation of new entry, and lap capture if race is in progress

  • Standard search - In Competitors view - Searches all competitors. In Race view - Searches only those competitors already selected to race

Lap colour mode - Monochrome/Multiple

  • Monochrome - Alternates between White on Black, and Black on White

  • Multiple - Different colour combination for each lap (10 lap max)

Editable results - On/Off

If enabled, race data files are created upon save, which can be edited post race reset (via Edit previous race option on Race Screen)

Demo mode - On/Off

When app is first install (new user), then it starts in Demo mode to show new user what it's about. When they have either completed the Demo, or exited the app, Demo mode is disabled. This switch allow Demo mode to be reenabled if required...

Debug mode - On/Off

As this app is very much still under development (by just little old me), there are certain time I need to say shorten the start sequence, and this is what happens if debug is on:

    • Debug On, Sound On - Short start (circa 1 minute)

    • Debug On, Sound Off - Very short start (circa 15 seconds)

Debug additional info - On/Off

Again, as the app is under development, there a lot of times I need to see what's happening 'under the bonnet'. So setting the On, will make the app display lots of additional information that would be confusing to users but critical to me for future work (or bug fixing :o)


Debug

Debug info - Variables

To help development, certain app internals are displayed to allow me to 'see' what's happening to the data...