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