Blackmagic Pocket Cinema Camera USB control over PTP

How to control the Blackmagic Pocket Cinema Cameras over USB connection with gphoto2.

The 4k and 6k Blackmagic Pocket Cinema Cameras support control over USB connection, using the PTP protocol. We will be using gphoto2 for read and write settings.

You can easily control various camera settings. Set ISO, f-value, toggle recording, adjust focus, etc. And of course you can also read out various values like focal length, battery level, focal length, etc.

Below is a list of all the control points available, these can easily be read or written to with gphoto2, that should be available on just about any Linux distribution.
See the table below for various example commands set various camera parameters.

  • /main/actions/opcode
  • /main/status/serialnumber
  • /main/status/manufacturer
  • /main/status/cameramodel
  • /main/status/deviceversion
  • /main/status/vendorextension
  • /main/status/batterylevel
  • /main/imgsettings/imagesize
  • /main/imgsettings/iso
  • /main/capturesettings/f-number
  • /main/capturesettings/focusdistance
  • /main/capturesettings/focallength
  • /main/other/5001
  • /main/other/5002
  • /main/other/5003
  • /main/other/5007
  • /main/other/5008
  • /main/other/5009
  • /main/other/500f
  • /main/other/d001
  • /main/other/d002
  • /main/other/d003
  • /main/other/d004
  • /main/other/d005
  • /main/other/d006
  • /main/other/d007
  • /main/other/d008
  • /main/other/d009
  • /main/other/d00a

Examples gphoto2 commands

Operation gphoto2 command
Start recording gphoto2 --set-config /main/actions/movie=1
Stop recording gphoto2 --set-config /main/actions/movie=0

Set recording resolution

Note: Valid values depends on set recording codec

gphoto2 --set-config /main/imgsettings/imagesize=3
Read lens focal length gphoto2 --get-config /main/capturesettings/focallength
Set ISO to 100 gphoto2 --set-config /main/other/500f=2
Set ISO to 400 gphoto2 --set-config /main/other/500f=8
Set tint to 10 gphoto2 --set-config /main/other/d005=10
Set tint to 0 gphoto2 --set-config /main/other/d005=0
Manual focus, closest gphoto2 --set-config-value /main/other/d003=0
Manual focus, "in the middle" gphoto2 --set-config-value /main/other/d003=32768
Manual focus, infinite gphoto2 --set-config-value /main/other/d003=65536

 

And here is a more verbose version with all the supported options and values.

/main/actions/movie                                                            
Label: Movie Capture
Readonly: 0
Type: TOGGLE
Current: 2
END
/main/actions/opcode
Label: PTP Opcode
Readonly: 0
Type: TEXT
Current: 0x1001,0xparam1,0xparam2
END
/main/status/serialnumber
Label: Serial Number
Readonly: 0
Type: TEXT
Current: 18408459
END
/main/status/manufacturer
Label: Camera Manufacturer
Readonly: 0
Type: TEXT
Current: Blackmagic Design Inc
END
/main/status/cameramodel
Label: Camera Model
Readonly: 0
Type: TEXT
Current: Blackmagic Pocket Cinema Camera 6K G2
END
/main/status/deviceversion
Label: Device Version
Readonly: 0
Type: TEXT
Current: 8.1
END
/main/status/vendorextension
Label: Vendor Extension
Readonly: 0
Type: TEXT
Current: blackmagicdesign.com: 1.0;
END
/main/status/batterylevel
Label: Battery Level
Readonly: 1
Type: TEXT
Current: 75%
END
/main/imgsettings/imagesize
Label: Image Size
Readonly: 0
Type: RADIO
Current: 1920 x 1080
Choice: 0 6144 x 3456
Choice: 1 6144 x 2560
Choice: 2 3840 x 2160
Choice: 3 1920 x 1080
Choice: 4 3728 x 3104
Choice: 5 5744 x 3024
Choice: 6 2880 x 1512
Choice: 7 4096 x 2160
END
/main/imgsettings/iso
Label: ISO Speed
Readonly: 0
Type: RADIO
Current: 800
Choice: 0 25
Choice: 1 0
Choice: 2 100
Choice: 3 125
Choice: 4 160
Choice: 5 200
Choice: 6 250
Choice: 7 320
Choice: 8 400
Choice: 9 500
Choice: 10 640
Choice: 11 800
Choice: 12 1000
Choice: 13 1250
Choice: 14 1600
Choice: 15 2000
Choice: 16 2500
Choice: 17 3200
Choice: 18 4000
Choice: 19 5000
Choice: 20 6400
Choice: 21 8000
Choice: 22 10000
Choice: 23 12800
Choice: 24 16000
END
/main/capturesettings/f-number
Label: F-Number
Readonly: 0
Type: RADIO
Current: f/4
Choice: 0 f/0,21
Choice: 1 f/0
Choice: 2 f/4
Choice: 3 f/4,5
Choice: 4 f/4,8
Choice: 5 f/5,2
Choice: 6 f/5,6
Choice: 7 f/6,2
Choice: 8 f/6,7
Choice: 9 f/7,3
Choice: 10 f/8
Choice: 11 f/8,7
Choice: 12 f/9,5
Choice: 13 f/10
Choice: 14 f/11
Choice: 15 f/12
Choice: 16 f/14
Choice: 17 f/15
Choice: 18 f/16
Choice: 19 f/17
Choice: 20 f/19
END
/main/capturesettings/focusdistance
Label: Focus Distance
Readonly: 0
Type: RANGE
Current: 655,35
Bottom: 655,35
Top: 655,35
Step: 0,01
END
/main/capturesettings/focallength
Label: Focal Length
Readonly: 1
Type: RANGE
Current: 42
Bottom: 24
Top: 105
Step: 1
END
/main/other/5001
Label: Battery Level
Readonly: 1
Type: MENU
Current: 75
Choice: 0 0
Choice: 1 1
Choice: 2 2
Choice: 3 3
Choice: 4 4
Choice: 5 5
Choice: 6 6
Choice: 7 7
Choice: 8 8
Choice: 9 9
Choice: 10 10
Choice: 11 11
Choice: 12 12
Choice: 13 13
Choice: 14 14
Choice: 15 15
Choice: 16 16
Choice: 17 17
Choice: 18 18
Choice: 19 19
Choice: 20 20
Choice: 21 21
Choice: 22 22
Choice: 23 23
Choice: 24 24
Choice: 25 25
Choice: 26 26
Choice: 27 27
Choice: 28 28
Choice: 29 29
Choice: 30 30
Choice: 31 31
Choice: 32 32
Choice: 33 33
Choice: 34 34
Choice: 35 35
Choice: 36 36
Choice: 37 37
Choice: 38 38
Choice: 39 39
Choice: 40 40
Choice: 41 41
Choice: 42 42
Choice: 43 43
Choice: 44 44
Choice: 45 45
Choice: 46 46
Choice: 47 47
Choice: 48 48
Choice: 49 49
Choice: 50 50
Choice: 51 51
Choice: 52 52
Choice: 53 53
Choice: 54 54
Choice: 55 55
Choice: 56 56
Choice: 57 57
Choice: 58 58
Choice: 59 59
Choice: 60 60
Choice: 61 61
Choice: 62 62
Choice: 63 63
Choice: 64 64
Choice: 65 65
Choice: 66 66
Choice: 67 67
Choice: 68 68
Choice: 69 69
Choice: 70 70
Choice: 71 71
Choice: 72 72
Choice: 73 73
Choice: 74 74
Choice: 75 75
Choice: 76 76
Choice: 77 77
Choice: 78 78
Choice: 79 79
Choice: 80 80
Choice: 81 81
Choice: 82 82
Choice: 83 83
Choice: 84 84
Choice: 85 85
Choice: 86 86
Choice: 87 87
Choice: 88 88
Choice: 89 89
Choice: 90 90
Choice: 91 91
Choice: 92 92
Choice: 93 93
Choice: 94 94
Choice: 95 95
Choice: 96 96
Choice: 97 97
Choice: 98 98
Choice: 99 99
Choice: 100 100
END
/main/other/5002
Label: Functional Mode
Readonly: 0
Type: MENU
Current: 0
Choice: 0 2
Choice: 1 0
END
/main/other/5003
Label: Image Size
Readonly: 0
Type: MENU
Current: 1920 x 1080
Choice: 0 6144 x 3456
Choice: 1 6144 x 2560
Choice: 2 3840 x 2160
Choice: 3 1920 x 1080
Choice: 4 3728 x 3104
Choice: 5 5744 x 3024
Choice: 6 2880 x 1512
Choice: 7 4096 x 2160
END
/main/other/5007
Label: F-Number
Readonly: 0
Type: MENU
Current: 400
Choice: 0 21
Choice: 1 0
Choice: 2 400
Choice: 3 450
Choice: 4 480
Choice: 5 520
Choice: 6 560
Choice: 7 620
Choice: 8 670
Choice: 9 730
Choice: 10 800
Choice: 11 870
Choice: 12 950
Choice: 13 1000
Choice: 14 1100
Choice: 15 1200
Choice: 16 1400
Choice: 17 1500
Choice: 18 1600
Choice: 19 1700
Choice: 20 1900
END
/main/other/5008
Label: Focal Length
Readonly: 1
Type: RANGE
Current: 4200
Bottom: 2400
Top: 10500
Step: 100
END
/main/other/5009
Label: Focus Distance
Readonly: 0
Type: MENU
Current: 65535
Choice: 0 65535
END
/main/other/500f
Label: Exposure Index (film speed ISO)
Readonly: 0
Type: MENU
Current: 800
Choice: 0 25
Choice: 1 0
Choice: 2 100
Choice: 3 125
Choice: 4 160
Choice: 5 200
Choice: 6 250
Choice: 7 320
Choice: 8 400
Choice: 9 500
Choice: 10 640
Choice: 11 800
Choice: 12 1000
Choice: 13 1250
Choice: 14 1600
Choice: 15 2000
Choice: 16 2500
Choice: 17 3200
Choice: 18 4000
Choice: 19 5000
Choice: 20 6400
Choice: 21 8000
Choice: 22 10000
Choice: 23 12800
Choice: 24 16000
END
/main/other/d001
Label: PTP Property 0xd001
Readonly: 0
Type: RANGE
Current: 30
Bottom: 30
Top: 5000
Step: 1
END
/main/other/d002
Label: PTP Property 0xd002
Readonly: 0
Type: RANGE
Current: 36000
Bottom: 173
Top: 36000
Step: 1
END
/main/other/d003
Label: PTP Property 0xd003
Readonly: 0
Type: RANGE
Current: 0
Bottom: 0
Top: 65536
Step: 1
END
/main/other/d004
Label: PTP Property 0xd004
Readonly: 0
Type: RANGE
Current: 4650
Bottom: 2500
Top: 10000
Step: 50
END
/main/other/d005
Label: PTP Property 0xd005
Readonly: 0
Type: MENU
Current: 0
Choice: 0 -50
Choice: 1 -49
Choice: 2 -48
Choice: 3 -47
Choice: 4 -46
Choice: 5 -45
Choice: 6 -44
Choice: 7 -43
Choice: 8 -42
Choice: 9 -41
Choice: 10 -40
Choice: 11 -39
Choice: 12 -38
Choice: 13 -37
Choice: 14 -36
Choice: 15 -35
Choice: 16 -34
Choice: 17 -33
Choice: 18 -32
Choice: 19 -31
Choice: 20 -30
Choice: 21 -29
Choice: 22 -28
Choice: 23 -27
Choice: 24 -26
Choice: 25 -25
Choice: 26 -24
Choice: 27 -23
Choice: 28 -22
Choice: 29 -21
Choice: 30 -20
Choice: 31 -19
Choice: 32 -18
Choice: 33 -17
Choice: 34 -16
Choice: 35 -15
Choice: 36 -14
Choice: 37 -13
Choice: 38 -12
Choice: 39 -11
Choice: 40 -10
Choice: 41 -9
Choice: 42 -8
Choice: 43 -7
Choice: 44 -6
Choice: 45 -5
Choice: 46 -4
Choice: 47 -3
Choice: 48 -2
Choice: 49 -1
Choice: 50 0
Choice: 51 1
Choice: 52 2
Choice: 53 3
Choice: 54 4
Choice: 55 5
Choice: 56 6
Choice: 57 7
Choice: 58 8
Choice: 59 9
Choice: 60 10
Choice: 61 11
Choice: 62 12
Choice: 63 13
Choice: 64 14
Choice: 65 15
Choice: 66 16
Choice: 67 17
Choice: 68 18
Choice: 69 19
Choice: 70 20
Choice: 71 21
Choice: 72 22
Choice: 73 23
Choice: 74 24
Choice: 75 25
Choice: 76 26
Choice: 77 27
Choice: 78 28
Choice: 79 29
Choice: 80 30
Choice: 81 31
Choice: 82 32
Choice: 83 33
Choice: 84 34
Choice: 85 35
Choice: 86 36
Choice: 87 37
Choice: 88 38
Choice: 89 39
Choice: 90 40
Choice: 91 41
Choice: 92 42
Choice: 93 43
Choice: 94 44
Choice: 95 45
Choice: 96 46
Choice: 97 47
Choice: 98 48
Choice: 99 49
Choice: 100 50
END
/main/other/d006
Label: PTP Property 0xd006
Readonly: 0
Type: MENU
Current: 3000
Choice: 0 6
Choice: 1 2398
Choice: 2 2400
Choice: 3 2500
Choice: 4 2997
Choice: 5 3000
END
/main/other/d007
Label: PTP Property 0xd007
Readonly: 0
Type: RANGE
Current: 50
Bottom: 5
Top: 50
Step: 0
END
/main/other/d008
Label: PTP Property 0xd008
Readonly: 0
Type: MENU
Current: 0
Choice: 0 2
Choice: 1 0
END
/main/other/d009
Label: PTP Property 0xd009
Readonly: 1
Type: RANGE
Current: 0
Bottom: 0
Top: 0
Step: 0
END
/main/other/d00a
Label: PTP Property 0xd00a
Readonly: 1
Type: MENU
Current: 0
END