Control

This page will detail operations to command and control the GoPro.

Operations

Keep Alive
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x5B

In order to maximize battery life, GoPro cameras automatically go to sleep after some time. This logic is handled by a combination of the Auto Off setting which most (but not all) cameras support and a Keep Alive message that the user can regularly send to the camera. The camera will automatically go to sleep if both timers reach zero.

The Auto Power Down timer is reset when the user taps the LCD screen, presses a button on the camera, programmatically (un)sets the shutter, sets a setting, or loads a Preset.

The Keep Alive timer is reset when the user sends a keep alive message.

The best practice to prevent the camera from inadvertently going to sleep is to start sending Keep Alive messages every 3.0 seconds after a connection is established.

Request
UUID:

Setting

Parameters:
  • keep_alive (uint8) - hard-coded data set to 0x42
Response
UUID:

Settings Response

Press Button
MAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x1B

Simulates pressing a physical button on the camera. The resulting operation matches exactly what happens when the corresponding button is physically pressed.

Request
UUID:

Command

Parameters:
  • button_id (uint8) - Button to press (0 = shutter, 1 = mode)
  • press_type (uint8) - Type of button press (0 = short press, 1 = long press)
Response
UUID:

Command Response

Reboot the Camera
MAX 2HERO13 BlackHERO12 Black
Type:

TLV command

ID:
0x11

Reboot the camera, approximating a battery pull

Request
UUID:

Command

Response
UUID:

Command Response

Set Analytics
MAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x50

Configure the client as third-party for analytic tracking.

Request
UUID:

Command

Response
UUID:

Command Response

Set AP Control
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x17

Enable / disable the camera’s WiFi access point.

Request
UUID:

Command

Parameters:
  • mode (uint8) - 0 to disable, 1 to enable, 2 to bounce (disable --> enable)
Response
UUID:

Command Response

Set Camera Control
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 Black
Type:

Protobuf

../_images/global_behaviors.png
Request

Set Camera Control Status (as part of Global Behaviors feature)

This command is used to tell the camera that the app (i.e. External Control) wishes to claim control of the camera. This causes the camera to immediately exit most contextual menus and return to the idle screen. Any interaction with the camera’s physical buttons will cause the camera to reclaim control and update control status accordingly. If the user returns the camera UI to the idle screen, the camera updates control status to Idle.

The entity currently claiming control of the camera is advertised in camera status 114. Information about whether the camera is in a contextual menu or not is advertised in camera status 63.

Response: ResponseGeneric

UUID:

Command

Feature ID:
0xF1
Action ID:
0x69
Message:

RequestSetCameraControlStatus (docs) (source)

Response

Generic Response used across many response / notification messages

UUID:

Command Response

Feature ID:
0xF1
Action ID:
0xE9
Message:

ResponseGeneric (docs) (source)

Set Camera Name
LIT HEROMAX 2
Type:

Protobuf

Request

Set the camera name

Response: ResponseGeneric

UUID:

Command

Feature ID:
0xF1
Action ID:
0x62
Message:

RequestSetCameraName (docs) (source)

Response

Generic Response used across many response / notification messages

UUID:

Command Response

Feature ID:
0xF1
Action ID:
0xE2
Message:

ResponseGeneric (docs) (source)

Set Date Time
MAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x0D

Set the camera’s date and time (without timezone and daylight-savings information).

The date_time parameter is a 7 byte value defined as such:

  • uint16 year

  • uint8 month (1-12)

  • uint8 day (1-31)

  • uint8 hour (0-23)

  • uint8 minute (0-59)

  • uint8 second (0-59)

For example, date time “2023-01-31 03:04:05” is serialized as 07:e7:01:1f:03:04:05

Request
UUID:

Command

Parameters:
  • date_time (7 byte date_time defined above) - Date time to set
Response
UUID:

Command Response

Set Local Date Time
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 Black
Type:

TLV command

ID:
0x0F

Set the cameras date and time with timezone and daylight-savings information.

The date_time parameter is a 10 byte value defined as such:

  • uint16 year

  • uint8 month (1-12)

  • uint8 day (1-31)

  • uint8 hour (0-23)

  • uint8 minute (0-59)

  • uint8 second (0-59)

  • int16 UTC offset in minutes

  • uint8 is_dst (1 if daylight savings time is enabled, 0 otherwise)

For example, date time “2023-01-31 03:04:05 (utc-02:00) (dst: on)” is serialized as 07:E7:01:1F:03:04:05:FF:88:01

Request
UUID:

Command

Parameters:
  • date_time (10 byte date_time defined above) - Date time to set
Response
UUID:

Command Response

Set Pairing State
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

Protobuf

This should be used to finish the initial pairing process in order to clear the pairing screen on the camera UI.

Request

Set Wireless 2.0 Pairing State

This is often colloquially referred to as “sending pairing complete”

Response: ResponseGeneric

UUID:

Network Management Command

Feature ID:
0x03
Action ID:
0x01
Message:

RequestPairingFinish (docs) (source)

Response

Generic Response used across many response / notification messages

UUID:

Network Management Response

Feature ID:
0x03
Action ID:
0x81
Message:

ResponseGeneric (docs) (source)

Set Shutter
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x01

Set Shutter On / Off

Request
UUID:

Command

Parameters:
  • mode (uint8) - 0 for off, 1 for on
Response
UUID:

Command Response

Set Turbo Transfer
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

Protobuf

Request

Enable/disable display of “Transferring Media” UI

Response: ResponseGeneric

UUID:

Command

Feature ID:
0xF1
Action ID:
0x6B
Message:

RequestSetTurboActive (docs) (source)

Response

Generic Response used across many response / notification messages

UUID:

Command Response

Feature ID:
0xF1
Action ID:
0xEB
Message:

ResponseGeneric (docs) (source)

Sleep
LIT HEROMAX 2HERO13 BlackHERO12 BlackHERO11 Black MiniHERO11 BlackHERO10 BlackHERO9 Black
Type:

TLV command

ID:
0x05

Put the camera to sleep.

Note

The camera is still be connectable via BLE in sleep.

Request
UUID:

Command

Response
UUID:

Command Response