HUAWEI FreeLace Pro configuration protocol

This post describe FreeLace Pro specific configuration protocol notices.

Base protocol is the same as in HUAWEI FreeBuds 4i, so main information is available here. This page contains only differences from their.

Read commands difference

In all read commands, you should add empty parameters of fields which you want to get in response. For example, if you send Package(b"\x2b\x2a", []) (read ANC mode request), you’ll got a empty response. So you must place (2, b"") in parameters array to get values from device.

Commands that match with FreeBuds 4i

Except read request difference described above.

• Fetch device info

Commands that isn’t available

• In-ear state
  • Their command ID is used to notify about ANC mode changes
• Preferred ANC mode options
  • In this model, combined with long tap action
• Pause when plug-out option
  • HW not supported, no in-ear sensor;
• Voice language get/set request
  • Looks like not supported;
• Device logs
  • Didn’t got on that device;

Commands that have some differences

Fetch battery info

Request: To get current battery level, build and send command with ID 0108.

Playground example: Package(b"\x01\x08", [(2, b"")]).send().

Response: After that, you’ll got package like this. And the same package device will send if battery state will change while socket is connected.

Noise-cancellation

Request: If you want to request current ANC mode, send command ID 2B2A.

Playground example: Package(b"\x2b\x2a", [(1, b"")]).send().

Response: When you send that command, you’ll got a incoming package like that:

Change detection: When ANC mode is changed with touch button on deivce, you’ll get this package. Yes, command ID is the same as in FreeBuds 4i in-ear state change event. Also, sometimes it drop’s a package with 2b2a command ID and structure like above (response), but not all times…

Write: To change ANC mode, build and send this package:

Playground example: Package(b"\x2b\x04", [(1, NEW_MODE)]).send(), where NEW_MODE should two byte string, eg b"\x01\x02".

Power button double tap action

Request: To fetch current option value, send package with command ID 0120 (command ID is the same as double tap in 4i).

Playground: Package(b"\x01\x20", [(1, b""),(2, b"")]).send().

Response:

Write: To change this option, send package with command ID 011f, and place new option value to parameters 1 AND 2

Playground: Package(b"\x01\x1f", [(1, NEW_VALUE),(2, NEW_VALUE),]).send() where NEW_VALUE should be from table below.

Available options:

Long tap action option

Request: To fetch current option value, send package with command ID 2B17.

Playground: Package(b"\x2b\x17", []).send().

Response:

Write: Command ID is 2b16.

Playground: Package(b"\x2b\x16", [(1, NEW_VALUE),(2, NEW_VALUE),]).send() where NEW_VALUE should be from table below.

Available options: