AG-BFLS

Quick start快速接入

Read fuel data without a connection through advertising, or connect to configure and calibrate a sensor. Identify the device by manufacturer data and its sensor ID; the Bluetooth name may be absent.通过广播可免连接读取液位数据；连接后可配置和校准。使用厂商数据与传感器 ID 识别设备，蓝牙名称可能不存在。

1. 1Scan manufacturer data扫描厂商数据
2. 2Identify sensor ID识别传感器 ID
3. 3Connect & discover service连接并发现服务
4. 4Enable FFF2 notifications启用 FFF2 通知
5. 5Verify for protected commands受保护操作先验证
6. 6Write FFF1 → validate FFF2 reply写入 FFF1 → 校验 FFF2 响应

Enable notifications before sending a command. Send one request at a time. The examples below use sensor ID 999999 (0F 42 3F); replace it with the actual advertised ID and recalculate CRC.先启用通知再发送命令，同一时间只保留一个未完成请求。以下示例使用传感器 ID 999999（0F 42 3F）；实际使用时替换为广播中的 ID，并重新计算 CRC。

0C 05 0F 42 3F 26 FD

Expected example reply: 0C 07 0F 42 3F 26 08 1B A1 → version 8.27. Example values are synthetic, not a recording from a connected sensor.示例响应：0C 07 0F 42 3F 26 08 1B A1 → 版本 8.27。示例数值为构造数据，不是连接实机的采集记录。

BLE advertisingBLE 广播

Offsets below start at the manufacturer payload after the two company bytes. First parse AD structures as Length | Type | Value. Find AD type FF; do not assume the name, flags or field order are fixed. Company bytes are little-endian.下表偏移从厂商数据的两个 Company 字节之后开始。先按 Length | Type | Value 解析 AD 结构，查找类型 FF；不要假设名称、Flags 或字段顺序固定。Company 字节为小端。

Universal / Dominator · current format通用 / Dominator · 当前格式

A complete current advertisement is 31 bytes: 02 01 06 (Flags), then 1B FF FF FF and the 24-byte payload. There is no local name in this format. The four-byte counter is independent of the version and can restart; do not use it as a permanent device identity.当前完整广播为 31 字节：02 01 06（Flags），随后是 1B FF FF FF 与 24 字节载荷。该格式不携带本地名称。四字节计数与版本独立，可能重新开始，不能用作永久设备身份。

02 01 06 1B FF FF FF 3F 36 B4 08 1B 5B 0F 42 3F 00 00 01 26 01 35 C2 34 BC 34 80 13 88 43 64

Decoded: ID 999999; version 8.27; counter 294; frequency 13762 Hz; empty frequency 13440 Hz; output 5000 = 50.00% only in mode 0; temperature 27°C; battery 100%. Reserved bytes are ignored.解析：ID 999999；版本 8.27；计数 294；频率 13762 Hz；空频率 13440 Hz；输出 5000，仅在模式 0 下表示 50.00%；温度 27°C；电量 100%。保留字节忽略。

Modes 1/2 do not put their unit in this payload. Store/read the configured output mode. This advertisement only carries the low 16 bits of integer output; use GATT for fractional values or values above 65535.模式 1/2 不在此载荷中携带单位，需保存或读取配置的输出类型。该广播只携带整数输出的低 16 位；小数或超过 65535 的值请通过 GATT 读取。

AOOOG · manufacturer payloadAOOOG · 厂商数据载荷

0F 42 3F 02 BC 00 D8 00 08 4F 46 00 40 9C 45

Decoded: ID 999999; mode 0; battery code 700; temperature 27°C; frequency 13250 Hz; output 5000 = 50.00%. The FF AD structure begins 12 FF 43 FF followed by this payload.解析：ID 999999；模式 0；电量码 700；温度 27°C；频率 13250 Hz；输出 5000 = 50.00%。对应 FF AD 结构以 12 FF 43 FF 开头，后接上述载荷。

Android manufacturer-data APIs commonly supply the company identifier separately; iOS manufacturer data includes those two bytes. Normalize the input to the payload boundary before applying these offsets.Android 厂商数据接口通常将 Company 标识单独提供；iOS 厂商数据包含这两个字节。先统一到上述载荷起点再按偏移解析。

GATT connectionGATT 连接

Use the full 128-bit UUIDs. Subscribe to FFF2 notifications (CCCD value 01 00), then write complete frames to FFF1. Reading FFF1 is not the command-response path. A successful BLE write acknowledges transport, not execution; wait for the FFF2 response.使用完整的 128 位 UUID。订阅 FFF2 通知（CCCD 值 01 00），然后向 FFF1 写入完整帧。直接读取 FFF1 不能代替命令响应。蓝牙写入成功只代表传输确认，执行结果应等待 FFF2。

Prefer Write With Response. For Android, request MTU 247 and check the negotiated result. On iOS, check the available write length rather than assuming it. The characteristic limit is 128 bytes. This protocol does not reassemble application frames split across separate writes; keep each request in one supported write.优先使用带响应写入。Android 可请求 MTU 247，并检查实际协商结果；iOS 检查可用写入长度，不作固定假设。特征值上限 128 字节。协议不会拼接多次独立写入中的应用帧，每个请求应通过一次受支持的写入完成。

On reconnect, rediscover as needed, enable notifications and verify access again. Use sensor ID for business identity; an iOS peripheral identifier is not a MAC address.重连后按需重新发现服务、启用通知并再次验证访问。业务身份使用传感器 ID；iOS 外设标识符不是 MAC 地址。

Frames & CRC数据帧与 CRC

0C LL ID2 ID1 ID0 CMD [DATA …] CRC8

A status response uses LL = 06 and one payload byte: 00 = success; 01 = failure. A data response uses the same command code and its documented payload length. For a one-byte read, interpret the byte as data, not a success flag. Validate total size, sensor ID, command and CRC before parsing.状态响应 LL = 06，载荷一字节：00 成功，01 失败。数据响应使用同一命令码与规定载荷长度。对于单字节读取，字节代表数据，不是成功标志。解析前先校验总长度、传感器 ID、命令码和 CRC。

CRC-8/MAXIM-DOWCRC-8/MAXIM-DOW

Polynomial 0x31 (reflected implementation 0x8C); initial value 0x00; reflected input/output; XOR-out 0x00. The result is one byte. This CRC applies to GATT application frames, not the manufacturer advertising payload.多项式 0x31（反射实现 0x8C）；初始值 0x00；输入/输出反射；最终异或 0x00；结果一字节。此 CRC 用于 GATT 应用帧，不用于厂商广播载荷。

function crc8(bytes) {
  let crc = 0;
  for (const byte of bytes) {
    crc ^= byte;
    for (let bit = 0; bit < 8; bit++) {
      crc = (crc & 1) ? (crc >>> 1) ^ 0x8C : crc >>> 1;
    }
  }
  return crc;
}

fun crc8(bytes: ByteArray): Int {
    var crc = 0
    for (byte in bytes) {
        crc = crc xor (byte.toInt() and 0xFF)
        repeat(8) {
            crc = if ((crc and 1) != 0) (crc ushr 1) xor 0x8C else crc ushr 1
        }
    }
    return crc
}

func crc8(_ bytes: [UInt8]) -> UInt8 {
    var crc: UInt8 = 0
    for byte in bytes {
        crc ^= byte
        for _ in 0..<8 {
            crc = (crc & 1) != 0 ? (crc >> 1) ^ 0x8C : crc >> 1
        }
    }
    return crc
}

Public command reference公开命令参考

All command codes and frame examples are hexadecimal. “Verify first” means command 12 must have succeeded on the same connection. Examples show one possible response, not fixed measurement values. Use the real sensor ID in every request.所有命令码与帧示例均为十六进制。“需先验证”表示本次连接中命令 12 必须先成功。响应示例为一组可能的值，不是固定测量结果。请求必须使用实际传感器 ID。

0C 05 0F 42 3F 01 5D

0C 06 0F 42 3F 01 00 7F

0C050F423F015D

0C060F423F01007F

0C 05 0F 42 3F 02 BF

0C 06 0F 42 3F 02 00 2A

0C050F423F02BF

0C060F423F02002A

0C 06 0F 42 3F 04 14 7C

0C 06 0F 42 3F 04 00 80

0C060F423F04147C

0C060F423F040080

0C 05 0F 42 3F 05 3C

0C 06 0F 42 3F 05 14 B8

0C050F423F053C

0C060F423F0514B8

0C 06 0F 42 3F 0A 00 5C

0C 06 0F 42 3F 0A 00 5C

0C060F423F0A005C

0C060F423F0A005C

0C 05 0F 42 3F 0B 23

0C 06 0F 42 3F 0B 00 98

0C050F423F0B23

0C060F423F0B0098

0C 06 0F 42 3F 0C 01 A8

0C 06 0F 42 3F 0C 00 F6

0C060F423F0C01A8

0C060F423F0C00F6

0C 05 0F 42 3F 0D FE

0C 12 0F 42 3F 0D 05 00 01 00 00 60 6A 46 00 40 1C 46 00 2D

0C050F423F0DFE

0C120F423F0D0500010000606A4600401C46002D

0C 05 0F 42 3F 10 9E

0C 06 0F 42 3F 10 00 57

0C050F423F109E

0C060F423F100057

0C 05 0F 42 3F 11 C0

0C 06 0F 42 3F 11 00 93

0C050F423F11C0

0C060F423F110093

0C 0D 0F 42 3F 12 P0 P1 P2 P3 P4 P5 P6 P7 CRC

0C 06 0F 42 3F 12 00 C6

0C 05 0F 42 3F 14 FF

0C 1B 0F 42 3F 14 02 BC 00 D8 52 00 00 40 1C 46 00 60 6A 46 00 08 4F 46 00 40 9C 45 36

0C050F423F14FF

0C1B0F423F1402BC00D8520000401C4600606A4600084F4600409C4536

0C 06 0F 42 3F 15 00 A8

0C 55 0F 42 3F 15 00 00 00 00 00 00 00 00 00 00 48 42 2C 01 C4 09 00 00 C8 42 58 02 88 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2D

0C060F423F1500A8

0C550F423F150000000000000000000048422C01C4090000C8425802881300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002D

0C 56 0F 42 3F 16 00 00 00 00 00 00 00 00 00 00 00 48 42 2C 01 C4 09 00 00 C8 42 58 02 88 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 56

0C 06 0F 42 3F 16 00 FD

0C560F423F16000000000000000000000048422C01C4090000C84258028813000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000056

0C060F423F1600FD

0C 06 0F 42 3F 19 00 E5

0C 06 0F 42 3F 19 00 E5

0C060F423F1900E5

0C060F423F1900E5

0C 05 0F 42 3F 1A E0

0C 06 0F 42 3F 1A 00 B0

0C050F423F1AE0

0C060F423F1A00B0

0C 05 0F 42 3F 1B BE

0C 09 0F 42 3F 1B 00 40 1C 45 92

0C050F423F1BBE

0C090F423F1B00401C4592

0C 05 0F 42 3F 20 20

0C 0B 0F 42 3F 20 66 55 44 33 22 11 F5

0C050F423F2020

0C0B0F423F20665544332211F5

0C 05 0F 42 3F 21 7E

0C 06 0F 42 3F 21 01 E0

0C050F423F217E

0C060F423F2101E0

0C 06 0F 42 3F 22 01 B5

0C 06 0F 42 3F 22 00 EB

0C060F423F2201B5

0C060F423F2200EB

0C 05 0F 42 3F 26 FD

0C 07 0F 42 3F 26 08 1B A1

0C050F423F26FD

0C070F423F26081BA1

No matching command.未找到匹配命令。

Response layouts响应数据结构

All offsets in this section start at the first response payload byte (frame byte 6). Floats are four-byte IEEE 754 little-endian values, not integer bit patterns or text.本节偏移从响应载荷首字节开始（完整帧字节 6）。浮点数均为四字节 IEEE 754 小端格式，不应按整数或文本解释。

0D · Parameters, 13 bytes0D · 参数，13 字节

14 · Current data, 22 bytes14 · 当前数据，22 字节

The sample response under command 14 decodes to battery code 700, 27°C, legacy version byte 82, full 10000 Hz, empty 15000 Hz, current 13250 Hz and output 5000. In mode 0 this output is 50.00%.命令 14 示例响应解析为：电量码 700、27°C、旧版本字节 82、满频率 10000 Hz、空频率 15000 Hz、当前频率 13250 Hz、输出 5000。模式 0 下输出对应 50.00%。

Data conversion数据转换

Battery code 700 gives 90%, not 700% or 100%. It is a battery code, not a millivolt field. The public profile does not specify a separate calibrated voltage measurement. Reject non-finite floats. Frequency is not linearly proportional to the final output: use the sensor’s output instead of applying a second frequency-to-level conversion.电量码 700 对应 90%，不是 700% 或 100%。这是电量码，不是毫伏字段；此公开协议不规定独立的校准电压测量。应拒绝非有限浮点数。频率与最终输出并非简单线性关系，应使用传感器输出，不再重复进行频率到液位转换。

Empty/full calibration is required for meaningful level output. An output of zero by itself cannot distinguish an uncalibrated sensor from a genuinely empty tank. Read the empty/full frequencies to inspect calibration.有效液位输出依赖空满校准。仅凭输出 0 无法区分未校准与真正空箱；可读取空满频率检查校准状态。

Calibration workflows校准流程

Empty & full空点与满点

1. Connect, enable notifications, verify access and read current data.连接、启用通知、验证访问，并读取当前数据。
2. Place the sensor in the specified empty condition. Wait for frequency and temperature to stabilize. Send 10 and validate the reply. Read 0D to confirm the recorded empty frequency.将传感器置于规定空状态，等待频率与温度稳定。发送 10 并校验响应；读取 0D 确认记录的空频率。
3. Repeat in the specified full condition with 11, then read back the full frequency.在规定满状态重复上述过程，使用 11，随后读回满频率。
4. Read 14 at intermediate levels to confirm output. Writes are saved asynchronously; a success response is not a flash-commit notification. Do not remove power immediately.在中间液位读取 14 验证输出。参数异步保存；成功响应不是 Flash 落盘通知。不要立即断电。

Customer calibration table客户校准表

The table has 100 slots. Each entry is 8 bytes, with no padding. Commands 15/16 transfer exactly 10 entries per block. The response to 15 contains entries only; retain the requested index in the app.校准表包含 100 个槽位，每条 8 字节，无填充。命令 15/16 每块固定传输 10 条。15 的响应只含条目，APP 需保存请求索引。

For an entry with 50 L, 300 mm and coordinate 2500, the bytes are:一条 50 L、300 mm、坐标 2500 的数据编码为：

00 00 48 42 2C 01 C4 09

1. Back up the existing table with 15. Collect stable coordinates with 1B at measured levels/volumes. Round to uint16 deliberately and sort by strictly increasing coordinate; do not allow duplicate coordinates.先用 15 备份旧表。在实测高度/容积下用 1B 获取稳定坐标，明确取整为 uint16，按坐标严格递增排列，不允许重复坐标。
2. Build the full replacement in the app. The example uses three entries: (0 L, 0 mm, 0), (50 L, 300 mm, 2500), (100 L, 600 mm, 5000). Remaining entries in the block are zero.在 APP 中准备整张新表。示例为三条：（0 L、0 mm、0）、（50 L、300 mm、2500）、（100 L、600 mm、5000）。块内剩余条目补零。
3. Verify access. Write index 0 first; it clears the entire old table. Send later blocks in order. Each payload must include all 80 entry bytes even for a partially filled block. An all-zero entry after the first is a terminator; no gaps are allowed.验证访问后，先写索引 0，它会清空整张旧表。依次发送后续块；即使最后一块未填满也要携带完整 80 字节条目。首条之后的全零条目表示结束，中间不允许空洞。
4. Read back each written block with 15 and compare all bytes. After the full table is verified, select mode 1 or 2 with 19. Keep the backup until readings are validated.每块写完后使用 15 读回并逐字节比较。整表验证后使用 19 选择模式 1 或 2。在读数验证完成前保留备份。

Transfer is not an atomic whole-table transaction. An interrupted upload can leave a partial table; reconnect, read back and recover the complete table. Never blindly restart an upload from index 0. Test the minimum and maximum calibrated levels before commissioning.传输不是整表原子事务。上传中断可能留下部分表格；应重连、读回并恢复完整表。不要盲目从索引 0 重传。交付使用前应测试最低和最高校准液位。

Connection & error handling连接与错误处理

An incorrect sensor ID or CRC, an unsupported command, or a protected command sent before verification can be silently ignored. There is no automatic error notification for these cases.传感器 ID 或 CRC 错误、不支持的命令，以及验证前发送的受保护命令，都可能被直接忽略，不会自动返回错误通知。

A closed sensor requires magnet activation. Hold the magnet near the sensing area for about 3 seconds, then remove it before another activation. Fast discovery is temporary. Temperature and battery are cached and may update less frequently than frequency; this is expected for a battery-powered sensor.关闭的传感器需要磁铁激活。将磁铁靠近感应区约 3 秒，下次触发前先移开。快速发现是临时状态。温度和电量使用缓存，更新频率可能低于频率数据，这是电池设备的正常行为。

For firmware upgrade integration, request the separate approved upgrade guide and firmware package from AoooG. Upgrade transfer is outside this application communication profile.需要集成固件升级时，请向 AoooG 获取单独的升级指南和授权固件包。升级传输不属于本应用通信协议。

Version compatibility版本兼容

This page describes the current AG-BFLS application format verified against firmware 8.27 on 19 September 2026. A firmware version is not a Bluetooth specification version.本页描述 2026 年 9 月 19 日对照固件 8.27 核实的当前 AG-BFLS 应用格式。固件版本不等于蓝牙规范版本。

Only the commands documented here are part of this public profile. Public integration does not require internal sensor algorithms or production programming instructions.只有本文档列出的命令属于此公开接口。客户接入不需要内部传感算法或生产编程指令。