Control

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

Operations

Keep Alive

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

Set Analytics

Type:: TLV command
ID:: 0x50

Configure the client as third-party for analytic tracking.

Request

UUID:: Command

Response

UUID:: Command Response

Set AP Control

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

Response

UUID:: Command Response

Set Camera Control

Type:: Protobuf

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