ONYER 1.0.0 User Manual

Author : Bruno Nicoletti
Date : 14 September 2016

© 2016 Onyer Tech Limited. All rights reserved.

IMPORTANT: ONYER relates to physical activity which may be strenuous. We have no means of assessing your health and you are responsible for ensuring that you are fit to take part in such physical activity and for monitoring your physical condition at all times. You should not undertake any physical activity programme without getting medical advice, and you should always make sure that you warm up and cool down properly. If you feel unwell or suffer any symptoms whilst exercising you should stop the activity and seek help.


Bike and trainer.
ANT+TM speed and cadence sensor.
ANT+TM USB receiver.
Ready to ride.
ONYER in action.

What Is ONYER?

ONYER is a simple OSX bicycle training application for use with 'turbo' trainers. It receives ANT+TM data broadcast from your bike's speed sensor, cadence sensor and heart rate monitors, displays your sensors' values and plots the performance of a training session. If your bike is mounted on a supported trainer, ONYER will also calculate your virtual power output and calories burnt. ONYER also keeps the history of your training rides and lets you track your performance over time.

Apart from your computer, to use ONYER you need to have the following as a bare minumum,

This product is ANT+TM certified. Visit www.thisisant.com/directory for compatible products and apps.

ONYER's Interface

ONYER has a simple interface consisting of a button bar to control the application, two main views and a few dialogues. The main views are...

The Ride and History Views

The Button Bar

At the bottom of all views is a button bar that lets you flip between views and configure ONYER.

The Button Bar

From left to right the bar has...

Go ahead and push some buttons and see what happens. Hit the 'esc' key to get you out of any dialogue you may have opened.

Ride View

The ride view is where we monitor and record your rides. The main areas are...

The Ride View waiting to ride and riding.

You'll notice that an active ride hides the button bar giving more space to the graph.

Ride Duration

The duration of your ride is displayed in minutes and seconds.

Ride Duration.

When you aren't recording a ride a button labelled 'Duration' will be shown. Click on this and a number pad will appear for you set your desired ride time in minutes. You can do this by clicking on the number pad, or by typing a number in with the keyboard. Click the green 'tick' to confirm it (or hit the 'return' key), or the little red 'x' to dismiss the number pad and leaving the duration unchanged (or hit the 'esc' key).

Setting the Ride Duration.

When you are on a ride, you can no longer change the ride duration. The upper number will show the elapsed time in minutes and seconds, while the number underneath shows the time remaining. The little stopwatch at the bottom is a graphical representation of how much ride time is left.

Elapsed and Remaining Time During a Ride.

Dials

The Ride View will display a dial for each of your sensor streams as well as virtual power if you are using a supported trainer. Each dial is a different colour which matches the corresponding plot on the ride graph.

NOTE: Because speed and cadence sensors generate noisy data, ONYER averages sensor samples over a one second window before graphing and displaying them. Heart rate monitors are not so noisy and are not averaged.

Each dial has...

Each time ONYER receives a value from a sensor, the green dot on the corresponding dial will flash on or off to show it is getting data. So if you are pedalling like stink, and your green dots have stopped flashing regularly, that means that something has gone wrong. If so see the trouble shooting guide.

Sensor Dial.

When you are recording a ride the dials also display the average and the maximum values for the ride so far. The solid ring around the dial displays the average value graphically, while the semi-opaque ring shows the maximum value so far.

Sensor Dial During A Ride.

While ONYER is attempting to establish communications with an ANT+TM sensor the sensor's corresponding dial will display a 'radar ping' animation and the connection status dot will be red.

Sensor Dial Attempting to Connect.

Distance and Energy

ONYER computes the distance covered on your ride and the energy you have burnt getting there. This is shown as a pair of numbers to the right of the dials. If you haven't started a ride, then no values will be displayed.

Distance And Energy.

NOTE: The energy reported is an estimate of the calories you have burnt. This is based on how much power is required to spin your trainer combined with your muscular efficiency. When cycling your body is only around 25% efficient at converting calories burnt into the power generated by you leg muscles. If you know your actual muscular efficiency from physiological tests, you can set this up in preferences dialogue.

Graph

The graph shows how you've performed so far on your ride. You get a colour coded plot for each sensor stream that ONYER is paired with or can compute. The exception is that ONYER will not plot speed if it can compute power from a know trainer. The two curves are very similar and it makes the graph cluttered.

Recording A Ride

To start a ride either click on the 'Start Ride' button in the middle of the graph, or hit the 'space' bar on the keyboard. Onyer will then wait for your wheels to start turning before it actually starts recording. If you want to force it to record regardless of whether you are pedalling, hit the space bar again. Once you start pedalling ONYER will start recording your ride.

The Ride View, waiting for your wheels to spin.

Stopping A Ride

A ride will automatically stop recording when the duration timer counts down to zero. You can immediately cancel a ride at any time by hitting the 'esc' key on your keyboard.

If you stop your bike's wheels from spinning, ONYER will detect this and pause your ride's recording until your wheels spin again. When the recording is paused, you have several options, you can...

Trainers With Variable Resistance

Some trainers have multiple levels of resistance, each of which will have a different power profile. For these trainers, ONYER will display a control labelled 'Resistance' next to your bike's name. Choose the resistance setting that matches the one you have set on your trainer, so ONYER can use the correct power profile.

Resistance Setting.

History View

The history view shows you the rides you have completed so far as well the accumulated statistics from all your rides.

History View.

The strip at the top shows the accumulated statistics and just below it are the statistics for the selected ride.

Your rides are listed on the left ordered by the date you rode them, it shows the date, the duration of the ride and the calories you burnt on the ride. Click on a ride to select it and then its statistics will be listed at top and it will be graphed on the right.

If you have recorded a ride by mistake, select it and click on the red 'Delete' button next to that ride's stats. A dialogue will appear asking you confirm the fact you want the ride deleted. That ride will be deleted and its stats subtracted from the accumulated total stats.

Managing Bikes

ONYER needs to pair with the ANT+TM sensors on your bike as well as an optional heart rate monitor. This is a fairly simple exercise you only need to do once.

IMPORTANT: You will need to have purchased and plugged into your computer an ANT+ USB stick to communicate with your bike's sensors. You won't be able to set your bike up until you do.

The Bike List

If you click on the 'Set Bike' button in the button bar, a dialogue opens which lets you choose an existing bike or add a new bike.

List Of Available Bikes

In the image above, you can see we have two bikes configured and the bike name "Bruno's" is selected as the currently active bike.

Once you have chosen a bike and hit 'OK' ONYER will automatically attempt to connect to the ANT+TM sensors you have configured for your bicycle.

Bike Setup

The Bike Setup dialogue is used to set up a new bike or to modify an existing one.

Bike Setup Dialogue

Here you...

TIP: The radius of your wheel is used to calculate your bike's speed. If the radius of your wheel changes, then you will get inconsistent speed and virtual power readings. To prevent this happening, keep your tyres inflated to the recommended pressure and clamp you bike's wheel to your trainer with the same amount of tension each time you ride.


NOTE: If your trainer is not supported, ONYER will still record your rides. It won't be able to compute your virtual power. Please contact us to let us know that we should support your trainer.

Pairing ANT+TM Devices

ONYER currently works only with ANT+TM sensors, and you need to specify at least one of the following...

OR

Additionally ONYER can support an ANT+TM heart rate monitor.

TIP: To save on batteries, most sensors go to sleep unless they have detected recent activity. Be sure to wake up your sensors by spinning your pedals before you attempt to pair, and to have your heart rate monitor in place on your chest.



Initiating a pairing

For each ANT+TM sensor you have click on the 'Pair....' drop down item and choose 'ANT+' to start the pairing process. While ONYER is attempting to pair with you ANT+TM sensor, it will display a small 'radar' animation.

Attempting to pair.

When ONYER successfully pairs with a sensor, it will stop the 'radar' animation and display show the current sensor reading.

Successful pair.

If you've mistakenly attempted to pair a sensor, or have changed a sensor on a bike you have previously configured, click the 'Forget' button and *ONYER will forget about the device and halt any attempt to pair with it.

If ONYER fails to pair with your sensor it will become sad and display an error message. If this happens please see our trouble shooting guide.

Once you've paired all your devices, click 'Save' and Onyer will set that bike as the current bike and remember it in the future.

Preferences

The preference's dialogue is opened by clicking on the 'cog' icon in ONYER's button bar, or by typing 'CMD,'.

Preferences Dialogue.

You get to set...

Please don't enable developer mode unless you are asked to for a support issue.

Virtual Power

Virtual power is the way ONYER computes your power output from the speed of your wheel. To do this it needs to know two things, the speed of your wheel (obviously!), which is provided by your speedometer, and the power profile of your trainer. A power profile is the amount of power needed to maintain a constant speed on a trainer. Power profiles vary markedly between different types of trainer, with some having responses that mimic a road ride better than others. ONYER knows the power profile of a range of trainers and can compute power output only for these trainers.

Power Profile of a Fluid Trainer

Virtual power has some limitations. Individual trainers of the same make will vary slightly from the published power profiles for that model. Also, the power profile turns a given constant speed into a power output. If you accelerate, you will be producing more actual power than will be computed for a given speed. Similarly, while freewheeling and decelerating on your trainer, you will be producing less power than reported by the virtual power calculation. All this means that there will be some inaccuracy in the power and energy figures that ONYER is computing.

There are devices that directly and accurately measure power output, typically via strain gauges built into pedals. ONYER does not yet support devices that directly measure power, but may do in a later release.

Trouble Shooting

Appendicies

Support

If you are having problems with ONYER or want to discuss the application with us please contact us via our support email address support@onyer.tech.

Minimum Requirements

For ONYER to work, you will need...

Keyboard Short Cuts

Short Cut Action Context
CMD-Q Quit ONYER While not riding.
CMD-H Hide ONYER While not riding.
ALT-CMD-H Show Other Applications While not riding.
Space Start Ride While not riding.
ESC Abandon what you are doing. Any time.
CTRL F Toggle Fullscreen Any time
CMD-1 Flip to Ride View While not riding.
CMD-2 Flip to History View While not riding.
H Open ONYER's help page in a web browser. While not riding.

Supported Trainers

If you are using a supported trainer, ONYER can compute your power output from your wheel's speed. The trainers currently supported are...

Credits

ONYER was create by Onyer Tech Limited (UK). It was...

Software Copyrights

Software Owner
AntLib Copyright (C) Dynastream Innovations Inc. 2013. All rights reserved.
BNS Lib Copyright (C) Bruno Nicoletti 2016. All rights reserved.
bzip2 Copyright (C) 1996-2010 Julian R Seward. All rights reserved.
ONYER Copyright (C) Onyer Tech Limited 2016. All rights reserved.
Qt Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies). All rights reserved.
rapidjson Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved.
xxHash Copyright (C) 2012-2014, Yann Collet. All rights reserved.