Skip to main content

H8 — Bluetooth Fuel Sensor Setup

This guide takes you from a new Bluetooth fuel sensor to live fuel levels on Traqcare. Follow the steps in order.

You will need:

  • Your H8 GPS tracker, installed in the vehicle and online on Traqcare.
  • The Bluetooth fuel sensor (model YSBLE-B).
  • A smartphone with Bluetooth and Location (GPS) turned on.
  • Your fuel tank capacity in litres.
  • A login to track.traqcare.com.

The steps at a glance​

StepWhat you doWhere
1Check whether the sensor probe was cutOn the sensor
2Install the sensor appPhone
3Connect the phone to the sensorSensor app
4Calibrate the sensorSensor app
5Install the sensor and check the readingSensor app
6Link the sensor to the H8Traqcare or SMS
7Turn on the fuel sensor in TraqcareTraqcare
8Fill in the fuel calibration formTraqcare
9Check the live fuel levelTraqcare

Step 1 — Was the sensor probe cut?​

The sensor probe (the long metal rod) is often cut so that it fits the depth of the tank. This decides which steps you need:

Your situationWhat to do
Probe NOT cut (original length)The sensor is already calibrated at the factory (range 0–65535). Write down the MAC address from the sensor's label, then go straight to Step 6.
Probe cut to fit the tankCutting changes the sensor's "empty" and "full" points, so it must be calibrated again. Do Steps 2 to 9.

The MAC address is printed on the top of the sensor, for example F7:DA:B8:E9:2B:6E. You will need it in Step 3 and Step 6.

Sensor label with the MAC address highlighted
The MAC address is on the sensor label.

Step 2 — Install the sensor app​

Android: scan this QR code with your phone's camera or browser, or open the link below on the phone, then install the app.

QR code to download the Android sensor app

Download link: https://wldata.51js.net.cn/ys2024/ys1008.apk

note

Because the Android app is downloaded from a link and not from Google Play, your phone may ask you to allow installing apps from this source. Allow it for your browser, then tap the file again to install.

iPhone: open the App Store, search for us Ble Sensor (green icon) and install it.

us Ble sensor app in the App Store

Before you open the app, turn on Bluetooth and Location on your phone. The app uses Location to find nearby Bluetooth sensors and will not find the sensor without it. When the app asks for Bluetooth or Location permission, tap Allow.

Step 3 — Connect the phone to the sensor​

  1. Open the app and tap Device list.
  2. Tap YSBLE-B — sensor device.
  3. The app searches for nearby sensors. Find the one whose MAC address matches the label on your sensor, then tap connect.
Device list, then YSBLE-B sensor device, then the nearby sensor list with the MAC address highlighted
Device list → YSBLE-B → connect to the sensor with your MAC address.
  1. The first time you connect, the app asks you to create a 6-digit password (numbers only). This password protects the sensor's settings.
Write the password down

You will need this password every time you connect to the sensor. To change or remove it later, open the password menu and enter the old password.

Enter a 6-digit password
Set a 6-digit password.
Reset password screen
Change or delete it later in the password menu.

After connecting, you will see the sensor menu: reading, set up, password and calibration.

Sensor settings (leave as they are)​

The set up menu shows two values. Both are set at the factory and should not be changed:

SettingFactory valueWhat it means
Highest value65535The sensor's top reading (a full tank).
Damping coefficient6Smooths out fuel moving around in the tank while driving. A higher number gives steadier readings but reacts more slowly.
Sensor menu with set up highlighted
Set up page showing highest value 65535 and damping coefficient 6
Damping levels and response time
Damping level123456789
Response time (seconds)22334469120180240300360

Step 4 — Calibrate the sensor​

Only needed if the probe was cut (see Step 1). Open the calibration menu. There are two ways to calibrate. Manual calibration is more accurate and is the one we recommend.

Calibration page with the Remove fuel for calibration switch, Mark empty, Marked full and Confirm calibration buttons
The calibration page.
  1. Turn OFF the Remove fuel for calibration switch.
  2. Set the empty point: hold the sensor upright in the air (dry, not in fuel). Wait until the status on the right shows stable, then tap Mark empty. Wait for the success message.
  3. Set the full point: stand the sensor upright in a tube or container filled with the same fuel the vehicle uses. The fuel must cover the small vent hole at the top of the probe. Wait until the status shows stable, then tap Marked full.

When both points are saved, calibration is complete.

Method B — Automatic calibration​

  1. Turn ON the Remove fuel for calibration switch.
  2. Hold the sensor upright in the air. Wait until the status shows stable.
  3. Tap Confirm calibration. Calibration is done when the app shows Calibration complete.

Step 5 — Install the sensor and check the reading​

  1. Install the sensor in the fuel tank.
  2. In the app, open the reading menu.
  3. The page shows the sensor name, MAC address, analog quantity, temperature, raw data, and a fuel level picture on the right.
  4. Check that the level matches the fuel in the tank. When fuel is added or used, the reading should change. If it does, the sensor is working correctly.
Sensor menu with reading highlighted
Reading page showing analog quantity, temperature, raw data and the fuel level graphic

Send this command to the H8 so it knows which sensor to read:

BLELIST,<MAC>;0;1#

Replace <MAC> with your sensor's MAC address, written without the colons and in capital letters. Keep ;0;1# exactly as it is.

MAC on the sensor labelCommand to send
CE:26:1F:75:B8:47BLELIST,CE261F75B847;0;1#
F7:DA:B8:E9:2B:6EBLELIST,F7DAB8E92B6E;0;1#

You can send the command in either of these ways:

Option A — From Traqcare (the H8 must be online)

  1. Log in at track.traqcare.com and select the vehicle.
  2. Open Send GPRS Command from the vehicle's action menu.
  3. Choose a custom command, paste your BLELIST command and send it.
  4. The device's reply appears in the command history.

Option B — By SMS

Send the BLELIST command as a text message to the phone number of the SIM card inside the H8. The SIM must be able to receive SMS.

Step 7 — Turn on the fuel sensor in Traqcare​

First, find which channel carries the fuel reading. It is usually io270, ADC1 or ADC2.

  1. On the Traqcare map, click your vehicle and open the Parameters tab.
  2. Look for io270, ADC1 or ADC2. The one that shows a number (and changes when the fuel level changes) is your fuel channel. In the example below it is io270.
Parameters tab showing io270 with value 3349

Then turn on the fuel sensor:

  1. Go to Settings → Devices, find your H8 and click Modify.
  2. Open the Device Sensors tab.
  3. Switch on FUEL.
  4. In Parameter, choose the channel you found above (io270, ADC1 or ADC2).
  5. Set Reading Type to Direct.
Device Sensors tab with FUEL switched on and parameter io270
Adding a new H8?

If the H8 is not on Traqcare yet, add it first under Settings → Devices → Add Device and select the JT808 protocol. See Adding a Device.

Step 8 — Fill in the fuel calibration form​

The Fuel Calibration tab appears once the fuel sensor is switched on. Open it and enter:

FieldValue
Sensor Output UnitVoltage
Conversion Factor1.0
Calibration TypeAutomatic
Empty Tank Reading0
Half Tank ReadingLeave empty
Full Tank Reading65535
Tank CapacityYour tank size in litres (for example 650)

Click Submit.

Fuel Calibration form with Empty 0, Full 65535 and Tank Capacity 650
note

Make sure the Tank Capacity is correct. Traqcare uses it to turn the sensor reading into litres, so a wrong value gives wrong fuel figures.

Step 9 — Check the live fuel level​

That's it. Open the vehicle on the Traqcare map: the fuel level now updates in real time. Fuel history is available in the fuel chart and fuel reports — see Fuel Management in the Traqcare platform docs.

Troubleshooting​

ProblemWhat to check
The app does not find the sensorBluetooth and Location are on, the app has Location permission, and the phone is close to the sensor. Make sure no other phone is connected to the sensor.
No fuel value in TraqcareThe H8 is online; the BLELIST command used the correct MAC (no colons, capital letters); in Parameters, the fuel channel shows a value; the same channel is selected in Device Sensors.
Fuel level is wrongIf the probe was cut, calibrate it again (Step 4). Check that Empty is 0, Full is 65535 and the tank capacity is correct (Step 8).
Reading jumps up and downNormal while driving, as fuel moves in the tank. Leave the damping coefficient at the factory value 6.
Forgot the sensor passwordContact Skywonder support.

Still stuck? Raise a ticket at track.traqcare.com/ticket with your H8 IMEI and the sensor's MAC address.