RaceCapture real time telemetry: Difference between revisions

 
(60 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Telemetry Quickstart=
=Setting up real-time telemetry=
 
With RaceCapture you can live-stream your race car's telemetry data to [http://podium.live Podium] to compare and share your laps with friends, do real-time coaching, monitor the health of your endurance race car, and much more.
==[[RaceCapture_real_time_telemetry#Integrated_cellular_telemetry|Jump to integrated cellular telemetry guide]]==
==[[RaceCapture_real_time_telemetry#RaceCapture_App_Telemetry|Jump to telemetry via RaceCapture app guide]]==
 
<img src="http://i.imgur.com/WzHsdU1.gif" width="640"/>


==Prerequisites==
==Prerequisites==
===Get a Telemetry Streaming Key===
Head over to [http://podium.live Podium.live], create an account and a telemetry streaming key (AKA Device ID). Make a note of this id for later.


===Get a device Id===
==Integrated cellular telemetry==
Head over to [http://podium.live Podium.live], create an account and a device id. Make a note of this id for later.
This section steps you through setting up the integrated cellular telemetry option.


==Integrated Telemetry==
[[image:RaceCapture-PodiumConnect_cellular telemetry.jpg]]
[[Image:RaceCapturePro_MK2_SIM_card.jpg|500px]]


===Purchasing a SIM Card===
Don't have integrated telemetry? [[RaceCapture_real_time_telemetry#RaceCapture_App_Telemetry|Jump to telemetry via the RaceCapture app]]
The RaceCapture telemetry unit requires a full-sized SIM card with a compatible data plan from a supported carrier.


====How much data will I need?====
===Supported devices===
There are a number of factors that affect data usage:
* PodiumConnect
* Duration of telemetry session
* RaceCapture/Apex
* Number of channels enabled
* RaceCapture/Pro MK3, MK2
* Sample Rate of channels


For about 30 channels transmitting at 5-10Hz we have seen about 150MB of usage across a 2 day endurance racing weekend (15-20 hours of transmit time).
===Get a SIM card===
The RaceCapture telemetry unit requires a full-sized SIM card with a compatible data plan from a supported GSM carrier.


====Which SIM card to get?====
====Which SIM card to get?====
This is largely determined by the coverage map of the race track you'll be at. Use the coverage map checker for the respective carriers.
This is largely determined by the coverage map of the race track you'll be at. Use the coverage map checker for the respective carriers.


=====AT&T (Recommended)=====
====USA====
AT&T is now our recommended service as they have annouced affordable plans targeting tablets and other data-only devices.
==='''Verizon (4G RaceCapture / PodiumConnect systems only)'''===
If you have the newer 4G enabled system, you can also use a Verizon SIM card (USA). If your unit was bundled with a SIM card, you can call Wireless Zone at 508-834-3311 for activation and access to special data plan options.
 
If you did not receive a bundled SIM card, visit a Verizon store and ask for a pre-paid data only SIM for a hotspot or tablet (data only).  If you already have a Verizon account, you can also add a SIM to your plan that shares your plan's data.
 
* '''Note''' - If you have a 3G system, Verizon is not available for telemetry. Your best options are AT&T, T-Mobile or FreedomPop.  Check your order details if you are not certain which unit you have.
 
====='''Freedom Pop'''=====
We currently recommend the $0/month plan from FreedomPop. Based on the AT&T network, it offers good performance in rural areas across the USA.
 
FreedomPop's $0 SIM card plan includes 200MB of data/month - this should cover more than enough for a 24H endurance race.
 
To set up RaceCapture, just select FreedomPop from the list of cellular providers in the RaceCapture App. If you don't see it, set a custom APN and specify '''fp.com.attz''' as the APN host, with no user name or password.
 
[http://freedompop.com Sign up for a FreedomPop plan today]
 
* '''Note:''' When signing up, FreedomPop will place you in a default monthly plan. If you want their basic $0/month plan, you will need to downgrade using your account - click through the warning messages until you're at the Basic/Free plan. When you are done, your billing page should show $0/month.
 
[[Free_FreedomPop_Sim_Cards|See the step by step guide for setting up FreedomPop]]


We recommend the $15/month Gophone plan which includes 250MB of data- plenty for a long endurance race weekend.
====='''AT&T'''=====
 
AT&T is a good option as they have announced affordable plans targeting tablets and other data-only devices.


[http://www.att.com/att/gophone-tablet/en/index.html AT&T Gophone plans]
[http://www.att.com/att/gophone-tablet/en/index.html AT&T Gophone plans]


When you arrive at the store:
When you arrive at the store:
* Ask for a full-sized SIM for a $15/month Gophone plan.
* '''Critically important:''' Ask for a '''pre-paid SIM card for a tablet data plan'''.  It must be a tablet data plan; problems have been reported with phone SIMs.
* If they ask for an IMEI number it's easiest to request they set a default number.
** Request a full-sized SIM (RaceCapture/Pro) or a micro SIM (RaceCapture/Apex)
* IMEI: usually they will use a default IMEI. If they require one, you can  [[RaceCapture_real_time_telemetry#What_if_the_store_is_asking_for_the_IMEI.3F| from the system status page]]


[http://www.att.com/maps/wireless-coverage.html AT&T Coverage Map tool]
[http://www.att.com/maps/wireless-coverage.html AT&T Coverage Map tool]


=====T-Mobile=====
* '''Important note about AT&T and legacy 2.5G modules in RaceCapture/Pro MK2'''
Purchase a "Pay By the Day" SIM card from your '''local T-Mobile dealer'''. We recommend picking a plan with the 2G/3G unlimited data, which is currently $3 USD/day. The plan is only charged when data is actually used during a 24 hour period.  
As of the end of 2016, AT&T ended their support for 2G devices. You have two options to enable live-streaming cellular data:
* Use a carrier that still supports 2G Data, such as T-Mobile
* Upgrade your RaceCapture/Pro MK2 with the [[RaceCapturePro2_3.5G_module_upgrade|3.5G module]]


[http://prepaid-phones.t-mobile.com/prepaid-plans T-Mobile Prepaid Plans]
====='''T-Mobile'''=====
Purchase a "Pay By the Day" SIM card from your '''local T-Mobile dealer'''. We recommend picking a plan with the 2G/3G unlimited data, '''that will work with a tablet''', which is currently $3 USD/day. The plan is only charged when data is actually used during a 24 hour period.
 
'''This is the only US carrier that supports 2G - it should work with the 2G cellular module'''.
 
* [http://prepaid-phones.t-mobile.com/prepaid-plans T-Mobile Prepaid Plans]
* [http://autosportlabs.net/RaceCapturePro_TelemetryQuickstart T-Mobile Coverage map tool]


When you arrive at the store:
When you arrive at the store:
* Ask for a full-sized SIM for a pre-paid $3/day plan
* Ask for a pre-paid $3/day plan
* If they ask for an IMEI number it's easiest to request they set a default number.
** Request a full-sized SIM (RaceCapture/Pro) or a micro SIM (RaceCapture/Apex)
* IMEI: usually they will use a default IMEI. If they require one, you can  [[RaceCapture_real_time_telemetry#Getting the IME|get the IMEI from the system status page]]


[http://autosportlabs.net/RaceCapturePro_TelemetryQuickstart T-Mobile Coverage map tool]
====Global====
RaceCapture/Pro MK3, RaceCapture/Apex and PodiumConnect use a world-wide compatible GSM cellular module. Check with your carrier for support.  You will also likely need to set a custom APN setting in the telemetry configuration; the carrier will have these APN settings available.  


=====3rd party resellers (MVNOs)=====
* '''[http://wiki.apnchanger.org/Main_Page List of APNs for carriers worldwide]'''
* Straight talk wireless has some compelling plans starting at $15/month: http://www.straighttalkbyot.com/
=====Global/Other carriers=====


The RaceCapture/Pro uses a world-wide compatible GSM cellular module. Check with your carrier for support.  You will also likely need to set a custom APN setting in the telemetry configuration. These APN settings are provided by the carrier.
You will need:
* APN Host
* APN User name (might be blank)
* APN Password (might be blank)
 
Enter these values into the cellular provider section under Setup / Wireless:
 
[[Image:RaceCapture_telemetry_custom_apn_settings.png|600px]]
 
====How much data will I need?====
There are a number of factors that affect data usage:
* Duration of telemetry session
* Number of channels enabled
* Sample Rate of channels
 
For about 30 channels transmitting at 5-10Hz we have seen about 150MB of usage across a 2 day endurance racing weekend (15-20 hours of transmit time).
 
====What if the store is asking for the IMEI?====
Usually the store will set a default IMEI number, especially if you tell them the SIM may be swapped between devices. If they require setting a real number, you can get the IMEI by connecting to RaceCapture/Pro and checking the cellular section of the app's System Status page:
 
[[Image: RaceCapture_App_IMEI.png|500px]]


===Installing the SIM card===
===Installing the SIM card===
[[Image:RaceCapturePro_MK2_SIM_card.jpg|500px]]


* Use a pen, stylus or similar press the yellow eject button next to the SIM card slot - the card slot will pop out slightly from the front panel. Manually withdraw it from the front panel.
====RaceCapture/Apex====
* Remove the cover from the rear of the enclosure, and insert the SIM card into the bottom slot of the silver card holder (below the top SD card position).


====RaceCapture/Pro MK3====
* Use a pen, stylus or similar press the eject button next to the SIM card slot on the front panel - the card slot will pop out slightly. Manually withdraw it.
[[image:MK3_telemetry_slot.jpg|500px]]
* Insert the SIM card into the holder, noting the angled notch. Re-insert with the '''SIM card facing up''' and press until the front edge is flush with the face, until you feel the tray seat.
* '''Important:''' The card carrier should slide in smoothly, and require just a bit of force to lock in to place. Take care to not force the card in at an angle.
====RaceCapture/Pro MK2====
* Use a pen, stylus or similar press the eject button next to the SIM card slot - the card slot will pop out slightly. Manually withdraw it.
[[Image:RaceCapturePro_MK2_SIM_card_eject.jpg|500px]]
[[Image:RaceCapturePro_MK2_SIM_card_eject.jpg|500px]]


* Insert the SIM card into the holder, noting the angled notch. Re-insert and press until the front edge is flush or just below the surface of the enclosure face.
* Insert the SIM card into the holder, noting the angled notch. Re-insert with the '''SIM card facing down''' and press until the front edge is flush or just below the surface of the enclosure face, and you feel the tray seat.
* '''Important:''' The card carrier should slide in smoothly, and require just a bit of force to lock in to place. Take care to not force the card in at an angle.


'''IMPORTANT NOTES'''
====SIM adapters====
* The SIM card tray inserts into the unit with the word "SIM" on the edge '''upside down''', with the SIM card facing down.
Note that full-sized SIM cards can be cut down to micro-sized, and correspondingly micro SIMs can be inserted into a full-sized SIM card adapter.  
* The card carrier should slide in smoothly, and require just a bit of force to lock in to place. Take care to not force the card in at an angle.


[[Image:RaceCapturePro_MK2_SIM_card_insert.jpg|500px]]
===Attach cellular antenna===
Connect the included antenna to the antenna port of your RaceCapture device. Tighten to '''4-6 inch/lbs''' - just beyond finger-tight if you don't have the appropriate torque wrench.
* '''Important:''' Do not over-tighten antenna connection


===Attach Cellular Antenna===
===Antenna placement===
Connect the included antenna to the antenna port to the left of the SIM card slot. Tighten until snug.  
If you are using a roof-mount antenna, place the cellular antenna as far away from the GPS antenna as practically possible. About 1 meter (3 foot) separation is optimal.
* '''Do not over-tighten antenna connection'''
[[image:racecapture_telemetry_gps_antenna_placement.jpg|500px]]


[[Image:rcp_mk2_antenna.jpg|500px]]
===Telemetry Configuration===
* Launch the RaceCapture app and connect to your RaceCapture hardware.  
* Once it connects, navigate to '''Setup'''


===Configure your race capture unit options===
====Enable Telemetry====
* Connect RaceCapture/Pro to your computer with USB and run the RaceCapture software.
* Under Setup, select '''Telemetry''' section.
** '''Note:''' If this is the first time connecting, be sure you've gone through the [[RaceCapturePro2_QuickStart|Quick Start Guide]]
* In the Device ID field, enter the Telemetry Streaming Key (AKA Device ID) provided by your [http://podium.live podium.live] account.
* After the software detects and connects to RaceCapture/Pro, navigate to the configuration screen
* Ensure '''Background Streaming''' is enabled.
 
====Enable Telemetry and Device Id====
* Select the '''Telemetry''' option on the left side
* In the Device ID field, enter the Device Id assigned to the device you created in your [http://podium.live podium.live] account.  
[[Image:rc_app_telemetry_config.png|800px]]
[[Image:rc_app_telemetry_config.png|800px]]


====Enable Wireless and Cellular Carrier====
====Enable Cellular====
* Ensure '''Background Streaming''' is enabled.
* Select the '''Wireless''' option on the left side
* Select the '''Wireless''' option on the left side
* Ensure Cellular telemetry is enabled.
* Ensure Cellular telemetry is enabled.
* Select your cellular carrier.
* Select your cellular carrier.
** if your carrier is not listed, specify the APN settings provided by your wireless company.
** if your carrier is not listed, select '''other''' and specify the APN settings provided by your wireless company.
** [http://wiki.apnchanger.org/ List of APNs worldwide]
 
[[Image:rc_app_wireless_config.png|800px]]
[[Image:rc_app_wireless_config.png|800px]]


===Write and Save Configuration===
====Write Configuration====
* Write your configuration back to the unit using the buttons in the lower left of the screen.
* Write your configuration back to the RaceCapture unit
* '''Recommended:''' save your configuration to a file
** It's recommended you also save your configuration to a file for safe keeping.


==Testing Telemetry==
==Testing and Verification==
* Ensure the SIM card is installed in the RaceCapture/Pro unit per the earlier steps.


===Powering up===
===Powering up===
====3.5G module====
====3.5G module====
If you are using the 3.5G module, you can power using USB on the bench, or via 12v.
* Applies to: RaceCapture/Apex, RaceCapture/Pro MK3, MK2 (with 3.5G option)
Apply power to the system via USB or 12v


====2.5G module====
====2.5G module====
* Applies to: RaceCapture/Pro MK2 (with 2.5G option), MK1
If you are using the 2.5G module, follow this procedure for powering:
If you are using the 2.5G module, follow this procedure for powering:
* Power down RaceCapture/Pro and connect to a 12v power supply per the [[RaceCapturePro#Quick_Reference|wiring diagram]]
* Power down RaceCapture/Pro and connect to a 12v power supply per the [[RaceCapturePro#Quick_Reference|wiring diagram]]
Line 113: Line 178:
After powering up, the Cellular module will search for the network and connect. Typically this can take up to 1-3 minutes, depending on network conditions.
After powering up, the Cellular module will search for the network and connect. Typically this can take up to 1-3 minutes, depending on network conditions.


* When searching for the network, the top green telemetry LED will flash in a slow pattern.
====Observing cellular and telemetry status====
* When connected and transmitting, the top green LED will flash rapidly and steadily.
You can observe the Cellular status information in the System Status page of the app, under the '''Cellular''' section.
** See the [[RaceCapturePro#Quick_Reference|Quick Reference]] guide
 
[[Image:RC_cellular_status.png|800px]]


Once it is connected, you will see an ''Ad Hoc Event'' under your account on [http://podium.live/home podium.live]
====Observing telemetry data on Podium====
* You can view the live data by clicking on the event
Using your web browser, navigate to your [https://podium.live/home Events page on Podium] and watch for an event to appear.  This will likely be an '''Ad-Hoc''' event with a date. Click this event to see your current live dashboard.
** You can also edit and rename this event
* '''Note:''' You can also edit and rename this event.


===Setting up future events===
===LED indicators===
When connected, the telemetry status indicator will flash steadily.
====RaceCapture/Apex====
* Observe the blue telemetry status indicator on the top of the unit.
====RaceCapture/Pro MK3====
* Observe the blue telemetry status indicator on the front panel of the unit.
====RaceCapture/Pro MK2====
* When connected and transmitting, the top-right green telemetry LED will flash rapidly and steadily.
 
===Setting up future events on Podium===
You can create events in the future and assign your RaceCapture device to the event. if RaceCapture connects and transmits during that time, it will lock to that event for the duration of the time.
You can create events in the future and assign your RaceCapture device to the event. if RaceCapture connects and transmits during that time, it will lock to that event for the duration of the time.


==Troubleshooting==
==RaceCapture App Telemetry==
Typical connectivity problems are:
Using the RaceCapture app, you can broadcast telemetry while using the dashboard features in the app, including pit-to-car alerts.  
* '''No 12v power:''' The internal telemetry module '''requires''' external 12v (via green terminal block or OBD-II cable)
** Computer USB does not provide enough power to operate the cellular module.
* '''Expired SIM card:''' Make sure your T-mobile or AT&T card has enough credit to enable data.
* '''Incorrect cellular plan:''' Check with the carrier and confirm the plan is enabled with data.
* '''Incorrect APN settings:''' While T-Mobile makes it easy by always using the same APN, AT&T is known to require various APN settings based on the type of data plan.
** For AT&T, try the alternate AT&T settings (AT&T Alt #1 and Alt #2) if you cannot get a connection.
** For other carriers, contact their technical support to get a custom APN setting for their network.
* '''Poor signal quality:''' Ensure coverage area.
* '''Loose antenna:''' Ensure the antenna is snugly cinched to the connector.
* '''Missing / Incorrect Device Id:''' Ensure RaceCapture/Pro is configured with a Device ID provided by [http://podium.live podium.live]


===Debugging Cellular activity===
===Pre-requisites===
You can debug the cellular activity by monitoring the log generated by RaceCapture/Pro.  
Ensure you have a high quality 12v charger connected to the Android or iOS device so the device maintains charge throughout your race event.


* Navigate to Configuration/Scripting and enable debug level logging.
===Telemetry via direct USB connection + hotspot===
** Check the 'poll logfile' option
You can broadcat telemetry via the RaceCapture app while using a direct USB connection to the RaceCapture system:
** Select 'Debug' from the dropdown list.
* USB OTG via Android
* You will see the low-level conversation between RaceCapture/Pro and the cellular module.
* Direct USB Host using an Android stereo receiver
[[Image:rc_app_debugging_cellular.png|800px]]
* Direct USB Host using a Raspberry Pi


Copy and paste the data from this window (Ctrl-A / Ctrl-C) into an email and [mailto:[email protected] email us], or post it in [http://www.autosportlabs.org the forums] - we'll get right on helping you figure it out.
* System Compatibility:
** RaceCapture/Apex
** RaceCapture/Pro MK3 / MK2
** RaceCapture/Track MK2 / MK1
** PodiumConnect


==Bluetooth Telemetry==
===Telemetry Via Bluetooth connection + hotspot===
You can broadcast telemetry via the RaceCapture app while using the Bluetooth connection on compatible Android devices.
* '''Note''' You can also use an Android Phone in place of the hotspot.


An alternate way to enable telemetry is via the [https://play.google.com/store/apps/details?id=com.autosportlabs.racecapture&hl=en RaceCapture android app] on an internet-connected phone or tablet.
[[file:RaceCapture App telemetry with Bluetooth.jpg]]


===RaceCapture/Pro settings===
* System Compatibility
In the RaceCapture/Pro configuration software ensure following is set under the Wireless Configuration pane:
** RaceCapture/Apex
* Bluetooth is 'On'
** RaceCapture/Pro MK3
* Cellular Module is 'Off'
** RaceCapture/Track MK2
[[Image:RC_app_wireless_config.jpg|800px]]
** RaceCapture/Pro MK2 (with Bluetooth module)
** RaceCapture/Pro MK1 (with Bluetooth module)


When complete, write the updated configuration back to the RaceCapture/Pro device.
===Telemetry via WiFi connection to shared hotspot===
You can broadcast telemetry via the RaceCapture app by connecting both RaceCapture and your Android or iOS device to a common WiFi hotspot.  Data flows from RaceCapture to the RaceCapture app, which is then broadcast to Podium.


===Install the RaceCapture Mobile App===
[[file:RaceCapture App telemetry with WiFi.jpg]]


[https://play.google.com/store/apps/details?id=com.autosportlabs.racecapture&hl=en Install] From the Google Play Store
Configure RaceCapture  to connect to the hotspot by specifying the SSID and password under the WiFi client settings, located in the RaceCapture app under Setup/Wireless. Then, configure your Android or iOS device to connect to the same hotspot.


===Configure Bluetooth===
* '''Note:''' You must use the RaceCapture app to broadcast telemetry, your RaceCapture or PodiumConnect device will not directly broadcast telemetry directly via WiFi.
* Plug the Bluetooth module into the wireless connectivity port on RaceCapture/Pro and apply power (12v or USB)
* Associate the Bluetooth module with your android device in the system settings.
** Default password is '''1234'''


* In the RaceCapture App touch the Bluetooth icon and select the '''RaceCapturePro''' device you associated in the previous step.
* System Compatibility
* The RaceCapture app will negotiate a connection to RaceCapture/Pro.
** PodiumConnect
** Once connected, the LED on the bluetooth module will remain steadily lit
** RaceCapture/Apex
** ''Tip 1'' - If the the app does not connect, close the RaceCapture app completely (dismiss from the background apps) and re-start.
** RaceCapture/Pro MK3
** ''Tip 2'' - If you still cannot connect, enable / disable the bluetooth system in the device settings
** RaceCapture/Track MK2
** RaceCapture/Track MK1
** RaceCapture/Pro MK2 (with WiFi module)


===Configure your Device Id===
===Telemetry Configuration===
* Launch the RaceCapture app and connect to your RaceCapture hardware via Bluetooth or WiFi
* Once it connects, navigate to '''Setup'''


While connected to RaceCapture/Pro configure the device id you created on podium.live
====Enable Telemetry====
* Under Setup, select '''Telemetry''' section
* In the Device ID field, enter the Device Id provided by your [http://podium.live podium.live] account.
* Ensure '''Background Streaming''' is enabled.
[[Image:rc_app_telemetry_config.png|800px]]


'''Notes'''
====Disable Cellular====
* Ensure you write the config back to RaceCapture/Pro after setting the device id
* Select the '''Wireless''' section
* If cellular module is installed and enabled in RaceCapture/Pro, it will take priority over telemetry via app. To use in-app telemetry, disable the cellular module under the wireless configuration page.
* Ensure Cellular telemetry is '''disabled''', if the option is available.  


[[Image:race_capture_app_telemetry_config.jpg|800px]]
====Write Configuration====
* Write your configuration back to the RaceCapture unit
** It's recommended you also save your configuration to a file for safe keeping.


===Enable Telemetry under the app preferences===
===Enable Telemetry under the app preferences===
 
Access the app preferences under the main menu. Switch the application telemetry to '''on'''
Access the app preferences under the main menu. Switch the Application telemetry feature to 'On'


[[Image:race_capture_app_preferences_telemetry.jpg|800px]]
[[Image:race_capture_app_preferences_telemetry.jpg|800px]]


==Verify Telemetry==
===Verify Telemetry===
When telemetry is enabled and RaceCapture/Pro is streaming data, you will see the telemetry icon glowing bright green in the upper left corner of the app screen.  
When telemetry is enabled and the app is connected to RaceCapture, you will see the telemetry icon glowing bright green in the upper left corner of the app screen.  
* '''Dim Green''' Not active  
* '''Dim Green''' Not active  
* '''Green''' Connected and streaming
* '''Green''' Connected and streaming
Line 198: Line 277:
* '''Red''' Connection Error
* '''Red''' Connection Error


===View Telemetry Stream===
===Observing telemetry data on Podium===
Once you've verified telemetry is streaming, you can visit the [http://podium.live/home Events Page] on your Podium account!
Using your web browser, navigate to your [https://podium.live/home Events page on Podium] and watch for an event to appear.  This will likely be an '''Ad-Hoc''' event with a date. Click this event to see your current live dashboard.
* '''Note:''' You can also edit and rename this event.
 
===Troubleshooting===
* '''Missing / Incorrect Device Id:''' Ensure the Device ID provided by your [http://podium.live Podium account] is correctly set.
* '''App Telemetry disabled:''' Ensure the "Send Telemetry" option is enabled under the RaceCapture App preferences.
* '''Cellular enabled:''' If the Cellular option is available under the Wireless settings under Setup, ensure it is set to '''off''' - otherwise the system will assume you want to broadcast via the internal cellular module.
* '''Poor signal quality:''' Ensure adequate coverage in the area.
* '''No data available on plan:''' Verify internet connectivity on the phone or tablet using a simple browser connectivity test.
 
===Troubleshooting Internal cellular===
''Applies to RaceCapture/Pro with cellular option, PodiumConnect, and RaceCapture/Apex''
 
===Checking cellular status using the front panel LED===
* ''Applies to RaceCapture/Pro, RaceCapture/Apex, PodiumConnect''
If the unit is actively broadcasting telemetry, you will see the telemetry LED flashing on the device.
 
===Checking cellular status using the RaceCapture app===
You can check the status of the internal cellular modem by checking system status, accessed via main menu in the RaceCapture app.
 
===Checking cellular status using RaceCapture logging===
 
Your system will generate messages that can show additional debugging information.
 
To access the RaceCapture Log
* Ensure the RaceCapture app is connected to your system
* Go to '''Setup''' and then select the '''Scripting''' screen
* Check the box next to '''Poll Log''' at the bottom of the screen.
* The RaceCapture app will pull log messages from your system and display it in the window.
 
To troubleshoot the telemetry connection, perform these steps right after powering up and let it run for a few minutes. You will see messages about the system attempting to initialize the cellular subsystem and connect telemetry.
 
* '''Note:''' You can also copy the text in the log by pressing the '''Copy''' button - then paste it in an email or message to share with others for troubleshooting.
 
[[file:RaceCapture_system_log.png]]

Latest revision as of 16:44, 14 January 2023

Setting up real-time telemetry

With RaceCapture you can live-stream your race car's telemetry data to Podium to compare and share your laps with friends, do real-time coaching, monitor the health of your endurance race car, and much more.

Jump to integrated cellular telemetry guide

Jump to telemetry via RaceCapture app guide

<img src="WzHsdU1.gif" width="640"/>

Prerequisites

Get a Telemetry Streaming Key

Head over to Podium.live, create an account and a telemetry streaming key (AKA Device ID). Make a note of this id for later.

Integrated cellular telemetry

This section steps you through setting up the integrated cellular telemetry option.

RaceCapture-PodiumConnect cellular telemetry.jpg

Don't have integrated telemetry? Jump to telemetry via the RaceCapture app

Supported devices

  • PodiumConnect
  • RaceCapture/Apex
  • RaceCapture/Pro MK3, MK2

Get a SIM card

The RaceCapture telemetry unit requires a full-sized SIM card with a compatible data plan from a supported GSM carrier.

Which SIM card to get?

This is largely determined by the coverage map of the race track you'll be at. Use the coverage map checker for the respective carriers.

USA

Verizon (4G RaceCapture / PodiumConnect systems only)

If you have the newer 4G enabled system, you can also use a Verizon SIM card (USA). If your unit was bundled with a SIM card, you can call Wireless Zone at 508-834-3311 for activation and access to special data plan options.

If you did not receive a bundled SIM card, visit a Verizon store and ask for a pre-paid data only SIM for a hotspot or tablet (data only). If you already have a Verizon account, you can also add a SIM to your plan that shares your plan's data.

  • Note - If you have a 3G system, Verizon is not available for telemetry. Your best options are AT&T, T-Mobile or FreedomPop. Check your order details if you are not certain which unit you have.
Freedom Pop

We currently recommend the $0/month plan from FreedomPop. Based on the AT&T network, it offers good performance in rural areas across the USA.

FreedomPop's $0 SIM card plan includes 200MB of data/month - this should cover more than enough for a 24H endurance race.

To set up RaceCapture, just select FreedomPop from the list of cellular providers in the RaceCapture App. If you don't see it, set a custom APN and specify fp.com.attz as the APN host, with no user name or password.

Sign up for a FreedomPop plan today

  • Note: When signing up, FreedomPop will place you in a default monthly plan. If you want their basic $0/month plan, you will need to downgrade using your account - click through the warning messages until you're at the Basic/Free plan. When you are done, your billing page should show $0/month.

See the step by step guide for setting up FreedomPop

AT&T

AT&T is a good option as they have announced affordable plans targeting tablets and other data-only devices.

AT&T Gophone plans

When you arrive at the store:

  • Critically important: Ask for a pre-paid SIM card for a tablet data plan. It must be a tablet data plan; problems have been reported with phone SIMs.
    • Request a full-sized SIM (RaceCapture/Pro) or a micro SIM (RaceCapture/Apex)
  • IMEI: usually they will use a default IMEI. If they require one, you can from the system status page

AT&T Coverage Map tool

  • Important note about AT&T and legacy 2.5G modules in RaceCapture/Pro MK2

As of the end of 2016, AT&T ended their support for 2G devices. You have two options to enable live-streaming cellular data:

  • Use a carrier that still supports 2G Data, such as T-Mobile
  • Upgrade your RaceCapture/Pro MK2 with the 3.5G module
T-Mobile

Purchase a "Pay By the Day" SIM card from your local T-Mobile dealer. We recommend picking a plan with the 2G/3G unlimited data, that will work with a tablet, which is currently $3 USD/day. The plan is only charged when data is actually used during a 24 hour period.

This is the only US carrier that supports 2G - it should work with the 2G cellular module.

When you arrive at the store:

  • Ask for a pre-paid $3/day plan
    • Request a full-sized SIM (RaceCapture/Pro) or a micro SIM (RaceCapture/Apex)
  • IMEI: usually they will use a default IMEI. If they require one, you can get the IMEI from the system status page

Global

RaceCapture/Pro MK3, RaceCapture/Apex and PodiumConnect use a world-wide compatible GSM cellular module. Check with your carrier for support. You will also likely need to set a custom APN setting in the telemetry configuration; the carrier will have these APN settings available.

You will need:

  • APN Host
  • APN User name (might be blank)
  • APN Password (might be blank)

Enter these values into the cellular provider section under Setup / Wireless:

RaceCapture telemetry custom apn settings.png

How much data will I need?

There are a number of factors that affect data usage:

  • Duration of telemetry session
  • Number of channels enabled
  • Sample Rate of channels

For about 30 channels transmitting at 5-10Hz we have seen about 150MB of usage across a 2 day endurance racing weekend (15-20 hours of transmit time).

What if the store is asking for the IMEI?

Usually the store will set a default IMEI number, especially if you tell them the SIM may be swapped between devices. If they require setting a real number, you can get the IMEI by connecting to RaceCapture/Pro and checking the cellular section of the app's System Status page:

RaceCapture App IMEI.png

Installing the SIM card

RaceCapture/Apex

  • Remove the cover from the rear of the enclosure, and insert the SIM card into the bottom slot of the silver card holder (below the top SD card position).

RaceCapture/Pro MK3

  • Use a pen, stylus or similar press the eject button next to the SIM card slot on the front panel - the card slot will pop out slightly. Manually withdraw it.

MK3 telemetry slot.jpg

  • Insert the SIM card into the holder, noting the angled notch. Re-insert with the SIM card facing up and press until the front edge is flush with the face, until you feel the tray seat.
  • Important: The card carrier should slide in smoothly, and require just a bit of force to lock in to place. Take care to not force the card in at an angle.

RaceCapture/Pro MK2

  • Use a pen, stylus or similar press the eject button next to the SIM card slot - the card slot will pop out slightly. Manually withdraw it.

RaceCapturePro MK2 SIM card eject.jpg

  • Insert the SIM card into the holder, noting the angled notch. Re-insert with the SIM card facing down and press until the front edge is flush or just below the surface of the enclosure face, and you feel the tray seat.
  • Important: The card carrier should slide in smoothly, and require just a bit of force to lock in to place. Take care to not force the card in at an angle.

SIM adapters

Note that full-sized SIM cards can be cut down to micro-sized, and correspondingly micro SIMs can be inserted into a full-sized SIM card adapter.

Attach cellular antenna

Connect the included antenna to the antenna port of your RaceCapture device. Tighten to 4-6 inch/lbs - just beyond finger-tight if you don't have the appropriate torque wrench.

  • Important: Do not over-tighten antenna connection

Antenna placement

If you are using a roof-mount antenna, place the cellular antenna as far away from the GPS antenna as practically possible. About 1 meter (3 foot) separation is optimal. Racecapture telemetry gps antenna placement.jpg

Telemetry Configuration

  • Launch the RaceCapture app and connect to your RaceCapture hardware.
  • Once it connects, navigate to Setup

Enable Telemetry

  • Under Setup, select Telemetry section.
  • In the Device ID field, enter the Telemetry Streaming Key (AKA Device ID) provided by your podium.live account.
  • Ensure Background Streaming is enabled.

Rc app telemetry config.png

Enable Cellular

  • Select the Wireless option on the left side
  • Ensure Cellular telemetry is enabled.
  • Select your cellular carrier.
    • if your carrier is not listed, select other and specify the APN settings provided by your wireless company.
    • List of APNs worldwide

Rc app wireless config.png

Write Configuration

  • Write your configuration back to the RaceCapture unit
    • It's recommended you also save your configuration to a file for safe keeping.

Testing and Verification

Powering up

3.5G module

  • Applies to: RaceCapture/Apex, RaceCapture/Pro MK3, MK2 (with 3.5G option)

Apply power to the system via USB or 12v

2.5G module

  • Applies to: RaceCapture/Pro MK2 (with 2.5G option), MK1

If you are using the 2.5G module, follow this procedure for powering:

  • Power down RaceCapture/Pro and connect to a 12v power supply per the wiring diagram
    • Note The internal cellular module cannot be operated via USB as it requires more power than USB can supply.
    • You can power via the green terminal block, or via the OBD-II cable, if supplied.
    • If powered via the green terminal block, you can use automotive power or a regulated 12v power supply offering at least 1A capacity

Watching for telemetry

After powering up, the Cellular module will search for the network and connect. Typically this can take up to 1-3 minutes, depending on network conditions.

Observing cellular and telemetry status

You can observe the Cellular status information in the System Status page of the app, under the Cellular section.

RC cellular status.png

Observing telemetry data on Podium

Using your web browser, navigate to your Events page on Podium and watch for an event to appear. This will likely be an Ad-Hoc event with a date. Click this event to see your current live dashboard.

  • Note: You can also edit and rename this event.

LED indicators

When connected, the telemetry status indicator will flash steadily.

RaceCapture/Apex

  • Observe the blue telemetry status indicator on the top of the unit.

RaceCapture/Pro MK3

  • Observe the blue telemetry status indicator on the front panel of the unit.

RaceCapture/Pro MK2

  • When connected and transmitting, the top-right green telemetry LED will flash rapidly and steadily.

Setting up future events on Podium

You can create events in the future and assign your RaceCapture device to the event. if RaceCapture connects and transmits during that time, it will lock to that event for the duration of the time.

RaceCapture App Telemetry

Using the RaceCapture app, you can broadcast telemetry while using the dashboard features in the app, including pit-to-car alerts.

Pre-requisites

Ensure you have a high quality 12v charger connected to the Android or iOS device so the device maintains charge throughout your race event.

Telemetry via direct USB connection + hotspot

You can broadcat telemetry via the RaceCapture app while using a direct USB connection to the RaceCapture system:

  • USB OTG via Android
  • Direct USB Host using an Android stereo receiver
  • Direct USB Host using a Raspberry Pi
  • System Compatibility:
    • RaceCapture/Apex
    • RaceCapture/Pro MK3 / MK2
    • RaceCapture/Track MK2 / MK1
    • PodiumConnect

Telemetry Via Bluetooth connection + hotspot

You can broadcast telemetry via the RaceCapture app while using the Bluetooth connection on compatible Android devices.

  • Note You can also use an Android Phone in place of the hotspot.

RaceCapture App telemetry with Bluetooth.jpg

  • System Compatibility
    • RaceCapture/Apex
    • RaceCapture/Pro MK3
    • RaceCapture/Track MK2
    • RaceCapture/Pro MK2 (with Bluetooth module)
    • RaceCapture/Pro MK1 (with Bluetooth module)

Telemetry via WiFi connection to shared hotspot

You can broadcast telemetry via the RaceCapture app by connecting both RaceCapture and your Android or iOS device to a common WiFi hotspot. Data flows from RaceCapture to the RaceCapture app, which is then broadcast to Podium.

RaceCapture App telemetry with WiFi.jpg

Configure RaceCapture to connect to the hotspot by specifying the SSID and password under the WiFi client settings, located in the RaceCapture app under Setup/Wireless. Then, configure your Android or iOS device to connect to the same hotspot.

  • Note: You must use the RaceCapture app to broadcast telemetry, your RaceCapture or PodiumConnect device will not directly broadcast telemetry directly via WiFi.
  • System Compatibility
    • PodiumConnect
    • RaceCapture/Apex
    • RaceCapture/Pro MK3
    • RaceCapture/Track MK2
    • RaceCapture/Track MK1
    • RaceCapture/Pro MK2 (with WiFi module)

Telemetry Configuration

  • Launch the RaceCapture app and connect to your RaceCapture hardware via Bluetooth or WiFi
  • Once it connects, navigate to Setup

Enable Telemetry

  • Under Setup, select Telemetry section
  • In the Device ID field, enter the Device Id provided by your podium.live account.
  • Ensure Background Streaming is enabled.

Rc app telemetry config.png

Disable Cellular

  • Select the Wireless section
  • Ensure Cellular telemetry is disabled, if the option is available.

Write Configuration

  • Write your configuration back to the RaceCapture unit
    • It's recommended you also save your configuration to a file for safe keeping.

Enable Telemetry under the app preferences

Access the app preferences under the main menu. Switch the application telemetry to on

Race capture app preferences telemetry.jpg

Verify Telemetry

When telemetry is enabled and the app is connected to RaceCapture, you will see the telemetry icon glowing bright green in the upper left corner of the app screen.

  • Dim Green Not active
  • Green Connected and streaming
  • Yellow Disconnected / Retrying
  • Red Connection Error

Observing telemetry data on Podium

Using your web browser, navigate to your Events page on Podium and watch for an event to appear. This will likely be an Ad-Hoc event with a date. Click this event to see your current live dashboard.

  • Note: You can also edit and rename this event.

Troubleshooting

  • Missing / Incorrect Device Id: Ensure the Device ID provided by your Podium account is correctly set.
  • App Telemetry disabled: Ensure the "Send Telemetry" option is enabled under the RaceCapture App preferences.
  • Cellular enabled: If the Cellular option is available under the Wireless settings under Setup, ensure it is set to off - otherwise the system will assume you want to broadcast via the internal cellular module.
  • Poor signal quality: Ensure adequate coverage in the area.
  • No data available on plan: Verify internet connectivity on the phone or tablet using a simple browser connectivity test.

Troubleshooting Internal cellular

Applies to RaceCapture/Pro with cellular option, PodiumConnect, and RaceCapture/Apex

Checking cellular status using the front panel LED

  • Applies to RaceCapture/Pro, RaceCapture/Apex, PodiumConnect

If the unit is actively broadcasting telemetry, you will see the telemetry LED flashing on the device.

Checking cellular status using the RaceCapture app

You can check the status of the internal cellular modem by checking system status, accessed via main menu in the RaceCapture app.

Checking cellular status using RaceCapture logging

Your system will generate messages that can show additional debugging information.

To access the RaceCapture Log

  • Ensure the RaceCapture app is connected to your system
  • Go to Setup and then select the Scripting screen
  • Check the box next to Poll Log at the bottom of the screen.
  • The RaceCapture app will pull log messages from your system and display it in the window.

To troubleshoot the telemetry connection, perform these steps right after powering up and let it run for a few minutes. You will see messages about the system attempting to initialize the cellular subsystem and connect telemetry.

  • Note: You can also copy the text in the log by pressing the Copy button - then paste it in an email or message to share with others for troubleshooting.

RaceCapture system log.png