RaceCapture real time telemetry: Difference between revisions

(clarified)
Line 79: Line 79:
====Enable Telemetry and Device Id====
====Enable Telemetry and Device Id====
* Select the '''Telemetry''' option on the left side
* Select the '''Telemetry''' option on the left side
* Enter the Device Id you obtained from your race-capture.com account in the Device Id field.
* In the Device ID field, enter the Device Id assigned to the device you created in your [http://race-capture.com race-capture.com] account.  
[[Image:rc_app_telemetry_config.png]]
[[Image:rc_app_telemetry_config.png]]



Revision as of 01:49, 5 February 2015

Telemetry Quickstart

Prerequisites

Get a device Id

Head over to race-capture.com, create an account and a device id. Make a note of this id for later.

Integrated Telemetry

RaceCapturePro MK2 SIM card.jpg

Purchasing a SIM Card

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?

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).

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.

AT&T (Recommended)

AT&T is now our recommended service as they have annouced affordable plans targeting tablets and other data-only devices.

We recommend the $15/month Gophone plan which includes 250MB of data- plenty for a long endurance race weekend.

AT&T Gophone plans

When you arrive at the store:

  • Ask for a full-sized SIM for a $15/month Gophone plan.
  • If they ask for an IMEI number it's easiest to request they set a default number.

AT&T Coverage Map tool

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, which is currently $3 USD/day. The plan is only charged when data is actually used during a 24 hour period.

T-Mobile Prepaid Plans

When you arrive at the store:

  • Ask for a full-sized SIM for a pre-paid $3/day plan
  • If they ask for an IMEI number it's easiest to request they set a default number.

T-Mobile Coverage map tool

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.

Installing the SIM card

RaceCapturePro MK2 SIM card.jpg

  • 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.

RaceCapturePro MK2 SIM card eject.jpg

  • 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.

IMPORTANT NOTES

  • The SIM card tray inserts into the unit with the word "SIM" on the edge upside down, with the SIM card facing down.
  • 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.

RaceCapturePro MK2 SIM card insert.jpg

Attach Cellular Antenna

Connect the included antenna to the antenna port to the left of the SIM card slot. Tighten until snug.

  • Do not over-tighten antenna connection

Rcp mk2 antenna.jpg

Configure your race capture unit options

  • Connect RaceCapture/Pro to your computer with USB and run the RaceCapture software.
    • Note: If this is the first time connecting, be sure you've gone through the Quick Start Guide
  • After the software detects and connects to RaceCapture/Pro, navigate to the configuration screen

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 race-capture.com account.

Rc app telemetry config.png

Enable Wireless and Cellular Carrier

  • Ensure Background Streaming is enabled.
  • Select the Wireless option on the left side
  • Ensure Cellular telemetry is enabled.
  • Select your cellular carrier.
    • if your carrier is not listed, specify the APN settings provided by your wireless company.

Rc app wireless config.png

Write and Save Configuration

  • Write your configuration back to the unit using the buttons in the lower left of the screen.
  • Recommended: save your configuration to a file

Testing Telemetry

  • Ensure the SIM card is installed in the RaceCapture/Pro unit per the earlier steps.

Powering up

  • 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.

  • When searching for the network, the top green telemetry LED will flash in a slow pattern.
  • When connected and transmitting, the top green LED will flash rapidly and steadily.

Once it is connected, you will see an Ad Hoc Event under your account on race-capture.com

  • You can view the live data by clicking on the event
    • You can also edit and rename this event

Setting up future events

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

Typical connectivity problems are:

  • 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.
  • 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 race-capture.com

Debugging Cellular activity

You can debug the cellular activity by monitoring the log generated by RaceCapture/Pro.

  • Navigate to Configuration/Scripting and enable debug level logging.
    • Check the 'poll logfile' option
    • Select 'Debug' from the dropdown list.
  • You will see the low-level conversation between RaceCapture/Pro and the cellular module.

Rc app debugging cellular.png

Copy and paste the data from this window (Ctrl-A / Ctrl-C) into an email and email us, or post it in the forums - we'll get right on helping you figure it out.

Bluetooth Telemetry

An alternate way to enable telemetry is via the RaceCapture android app on an internet-connected phone or tablet.

Install the RaceCapture App

Install From the Google Play Store

Configure Bluetooth

  • 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.
  • The RaceCapture app will negotiate a connection to RaceCapture/Pro.
    • Once connected, the LED on the bluetooth module will remain steadily lit
    • Tip 1 - If the the app does not connect, close the RaceCapture app completely (dismiss from the background apps) and re-start.
    • Tip 2 - If you still cannot connect, enable / disable the bluetooth system in the device settings

Configure your Device Id

In the app set settings configure the device id you created on race-capture.com and also enable Real-Time Telemetry

Race capture app telemetry config.jpg

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.

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

View Telemetry Stream

Once you've verified telemetry is streaming, you can visit the Events Page on your race-capture account!