UG_Preferences_Training - GoldenCheetah/GoldenCheetah GitHub Wiki

Preferences: Training (Version 3.6)


Train Devices

Training Devices

List defined Train Devices, available operations are:

  • - button to remove the selected device.
  • + button to open the Add Device Wizard.

Add Device Wizard

When you use the Add Device Wizard, the first step will show a list of available options:

Add Device Wizard - Select Device

Most are self-explicative but there are a couple with more options described below, Robot may not be included in release builds.

If you have problems connecting to ANT+ or Bluetooth devices, please see ANT and BTLE Troubleshooting

ANT+ and FE-C devices

ANT+ and FE-C includes support for a large number of ANT+ sensors (Power, Heart Rate, Speed, Cadence, SmO2 and Running Footpods) and generic support for FE-C enabled smart trainers plus specific support for Tacx Vortex Smart trainers. Both Garmin and Suunto ANT+ USB sticks are known to work with GoldenCheetah and USB extender cables are recommended to minimize interferences.

When devices are recognized/paired Status will change to Paired and ANT+ Id will not be None anymore. It will pair Heart rate monitors as well. And if you are wearing HR monitor and/or start pedaling, you should see some numbers (HR, Speed, Cadence, etc.).

ANT+ Sensors

Currently only one data stream of each kind is supported, please don’t pair sensors generating the same information to avoid data problems. For example if your trainer already provide Speed via the FE-C channel you shouldn’t pair separate Speed channels for the same device or an external Speed sensor. Exceptions are:

  • Up to 2 power meters on ANT+ are supported, the second is displayed as alternate power.
  • An external Cadence sensor on ANT+ is used with priority respect to Power Meter Cadence data.

Bluetooth devices

Bluetooth 4.0 includes support for BTLE enabled sensors (Power, Heart Rate and Speed/Cadence) and it is available on macOS and Linux in v3.5, and Windows in v3.6. There is no support to control smart trainers via BTLE in v3.5, for v3.6 we currently have full capabilities control for the Wahoo Kickr (Core), load and gradient control using ANT+ over BTLE for TACX trainers including the Flow Smart, and Kurt Kinetic Smart Control.

In v3.6 the Add Device Wizard just informs the user which kind of sensors are supported (Power, Heart Rate, Speed/Cadence, Wahoo Kickr, Tacx Trainers using ANT+ over BLE, Kurt Kinetic Inride and SmartControl in v3.6) and will be discovered automatically when the created device is connected to begin a training session. The sensors need to be active when you start the connection process (typically using the red/green button in Train Bottom Bar, unless you have enabled auto-connect in preferences), detection will be informed in Train bottom bar notifications panel, and the data will start to be displayed automatically.

Since the Power Channel includes Speed and Cadence data, Speed&Cadence sensors are automatically disabled when a Power sensor is present to avoid data problems.

Bluetooth 4.0 Sensors

Any errors happening at device start time will be logged in the file goldencheetah.log, parallel to the athlete's folder, while starting GC with —debug command line parameter will display additional information to the launching console.

New for v3.7, currently available in DEV builds, is explicit pairing of BTLE sensors. After clicking on Bluetooth 4.0 in the Add Device Wizard Golden Cheetah will start scanning for BT devices and when finished list those found as below.

btDevice3

Click on the sensors you wish to pair, ignore other devices which may be found such as your phone, and click "Next".

btDevice4

Virtual Power Curve (only for dumb trainers used without power meters)

You will then be presented with the dialogue to set up Virtual Power, as explained below. Enter the data or if use of Virtual Power is not required, just click "Next".

GoldenCheetah v3.5 includes the ability to estimate power from speed data using dumb trainers power-speed curves, if your trainer is included in the list of pre-configured ones, you can just select it in the last step of Add Device Wizard to enable virtual power.

New in v3.6 is the ability to enter a group of speed/power points to automatically fit a curve and enable virtual power for any dumb trainer, this video explains the setup: https://www.youtube.com/watch?v=wMuf8Zavjvw

Note: Do not forget to add a Custom Virtual Power Curve Name and click "Create" and select the newly created curve, otherwise the custom power curve won't be applied to the device.

Rotational Inertia Field: Trainer inertia will be modelled if you provide a value in the Rotational Inertia box. For wheel on trainer this should be the combined inertial moment of bicycle wheel and trainer, which can be computed as: (trainerI * (trainerFlywheelRevolutionsPerWheelRevolution)^2) + bicycleWheelI). A good way to test the power curve and inertial value is to coast down from 30kph and see that predicted power hovers just above 0. If value is consistently below zero your value for I is too large, if it is consistently above 0 it is too small.

btDevice5

Finally you will be presented with the confirmation dialogue, enter a name for the Train Device you have just configured and click "Finish". Note that it may take some time to save the configuration for a slower computer.

btDevice6

Preferences

Training Preferences

Train View preferences include:

Workout and VideoSync Library the folder where imported Workouts and VideoSyncs are stored.

Simulate Speed from Power enables fully parameterized, energy based, virtual bicycle simulation used to compute speed, instead of relying on data from a speed sensor, to have a more realistic speed and distance virtual ride experience. Parameters for the simulation model are found in Virtual Bicycle Specifications, see below.

Simulate Relative Hipoxia enables realtime altitude power adjustment.

Allow multiple devices in Train View is intended to combine sensors using different protocols (e.g. ANT+ FE/C Smart Trainer plus BTLE HRM), in this case one device needs to be created for each protocol with its corresponding sensors, and both devices selected before start.

Auto-connect devices in Train View allows to automatically connect a selected device, beware to use this option only if you are sure the required hardware will be connected each time you switch to Train View, otherwise let it disabled and connect the device using the bottom bar when the hardware is ready to avoid errors.

Play sound before new lap a sound is played 3 seconds before the end of the current lap/before start of the next one.

Start Countdown if greater than 0 seconds, the countdown will be displayed in notifications panel after start, and workout will begin when it reaches 0.

Auto-hide bottom bar in Train View automatically hides the training control bar when the session starts to maximize vertical screen space for video and/or charts, and restores it when the session is stopped (Escape key, stop media key or remote control can be used for that purpose).

Remote Controls

Training Remote Controls

This tab allows to define mappings for the remote control supported commands.

There are a couple of hardware devices in this category s.t. the "O-Synce ANT+ remote" and Garmin Edge Ant+ Remote (for this one you just need to hold any 2 buttons for a few seconds to start the pairing process every time you start the ant+ in train view).

There is an Android App useful for phones with ANT+ support: https://github.com/dresco/ANTRemote

Virtual Bicycle Specifications

Virtual Bike Specifications

Allows to configure the parameters used in Train View simulation rides, for an explanation of the theoretical basis see Exploiting the trainer capabilities to simulate the physics of a bicycle ride

BACK: Preferences: Overview