{"type":"doc","content":[{"type":"paragraph","content":[{"text":"In this guide, we will step-by-step guide you to use video camera OV5647 on SP7350 platforms.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"f39a8609-15ed-4678-94a2-efde16c84d10"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"2594bcde-c0f6-4d76-8caa-3d0778d0ae87"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"1 OV5647 Specification","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"5MP Max photograph resolution (2592 x 1944 = 5,038,848 pixels)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pixel Size: 1.4 x 1.4 μm","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optical size: 1/4\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lens: f=3.6 mm, f/2.9","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Viewing Angle: 54° x 41°","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Max video resolution: 1080p@30fps","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Max frame rate: 480p@90fps","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Maximum exposure times (seconds): 0.97","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selectable video resolutions: 1080p@30fps, 720p@60fps, 480p@90fps","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2 Setup","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.1 Enable OV5647 in Linux Kernel Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"1 Enter the kernel configuration by running the following command in the top directory of project.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"make kconfig","type":"text"}]},{"type":"paragraph","content":[{"text":"2 Selects sub-menus: Device Drivers>Multimedia support>Media ancillary drivers>Camera sensor devices","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1648,"alt":"image-20240227-023120.png","id":"a04a71a3-1398-4883-9211-f938e3486c61","collection":"contentId-1991278623","type":"file","height":747}}]},{"type":"paragraph","content":[{"text":" 3 Select “OmniVision OV5647 sensor support” and press . Then save and exit.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.2 Modify Device-tree Source","type":"text"}]},{"type":"paragraph","content":[{"text":"Device-tree source files of SP7350 are located in ","type":"text"},{"text":"linux/kernel/arch/arm64/boot/dts/sunplus/","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Here lists all files for SP7350 boards:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1abc3b50-5a55-4ce1-91df-139ccac15ff0"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#81dfe4","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Boards","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#81dfe4","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Device-tree source files","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"C3V-W EVB","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sp7350-ev.dts","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Modify device tree source file to define OV5647 source for driver","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.2.1 Using SP7350 MIPI/CSI-RX4","type":"text"}]},{"type":"paragraph","content":[{"text":"Open OV5647_INT macro to add OV5647 node and link mipicsirx4.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2.2.2 Using SP7350 Other MIPI/CSI-RX","type":"text"}]},{"type":"paragraph","content":[{"text":"Define OV5647 node in i2c node:","type":"text"}]},{"type":"codeBlock","content":[{"text":"i2c {\n #address-cells = <1>;\n #size-cells = <0>;\n\n ov5647: ov5647@36 {\n \t\tcompatible = \"ovti,ov5647\";\n\t\treg = <0x36>;\n\t\tclocks = <&ov5647_clk>;\n\t\tavdd-supply = <&ov5647_avdd_2v8>;\n\t\tdovdd-supply = <&ov5647_dovdd_1v8>;\n\t\tdvdd-supply = <&ov5647_dvdd_1v5>;\n\n port {\n ov5647_out: endpoint {\n remote-endpoint = <&csi1_ep1>;\n data-lanes = <1 2>;\n\t\t\t\tclock-noncontinuous;\n\t\t\t\tlink-frequencies = /bits/ 64 <297000000>;\n };\n };\n };\n};","type":"text"}]},{"type":"paragraph","content":[{"text":"port: Should contain one endpoint sub-node used to model connection to the video receiver according to the specification defined in Documentation/devicetree/bindings/media/video-interfaces.txt.","type":"text"}]},{"type":"paragraph","content":[{"text":"Video receiver endpoint sub-node should defined in mipicsirx node. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mipicsirx: csirx@f8005480 {\n port@0 {\n\treg = <0>;\n\n\t/* MIPI CSI-2 bus endpoint */\n\tcsi1_ep1: endpoint {\n\t\tremote-endpoint = <&ov5647_out>;\n\t\tbus-type = <4>;\n\t\tclock-lanes = <0>;\n\t\tdata-lanes = <1 2>;\n\t};\n };","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.3 Compile and Burn","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://sunplus.atlassian.net/wiki/spaces/C3/pages/1988034774/A+guide+to+downloading+and+compiling+SP7350+code#7.-Build-code"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.4 Connect Sensor Module","type":"text"}]},{"type":"paragraph","content":[{"text":"Using C3V-W board MIPI/CSI-RX4, as follows：","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":924,"id":"ae36ef29-6242-4922-9e34-f0a610e39947","collection":"contentId-1991278623","type":"file","height":889}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2.5 Check","type":"text"}]},{"type":"paragraph","content":[{"text":"After the burning is completed, start the board. The system should print the following information through the serial port.","type":"text"}]},{"type":"codeBlock","content":[{"text":"[ 1.944413] sp-csi2 f8005480.csirx: 2 lanes found\n[ 1.944819] sp-vin f8005980.video: assigned reserved memory node mipicsirx@4f600000\n[ 1.948929] ov5647 0-0036: Consider updating driver ov5647 to match on endpoints\n[ 1.956573] sp-vin f8005980.video: Device VIN8 registered as video0\n[ 1.962544] sp-vin f8005980.video: SP VIN driver probed","type":"text"}]},{"type":"paragraph","content":[{"text":"After the system startup is completed, the video device can be viewed.","type":"text"}]},{"type":"codeBlock","content":[{"text":"root@dbv3:~# ls /dev/video0\n/dev/video0","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3 Test","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.1 v4l2-ctl Command","type":"text"}]},{"type":"paragraph","content":[{"text":"This command is ","type":"text"},{"text":"used to control V4L2 devices from the command line","type":"text","marks":[{"type":"strong"}]},{"text":". It allows you to query device capabilities, set device parameters, and capture video and still image.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use v4l2-ctl --all --device /dev/video0 command getting device all information.","type":"text"}]},{"type":"codeBlock","content":[{"text":"root@dbv3:~# v4l2-ctl --all --device /dev/video0\nDriver Info:\n\tDriver name : sp_vin\n\tCard type : SP_VIN\n\tBus info : platform:f8005980.video\n\tDriver version : 5.10.201\n\tCapabilities : 0xa5200001\n\t\tVideo Capture\n\t\tRead/Write\n\t\tStreaming\n\t\tExtended Pix Format\n\t\tDevice Capabilities\n\tDevice Caps : 0x25200001\n\t\tVideo Capture\n\t\tRead/Write\n\t\tStreaming\n\t\tExtended Pix Format\nMedia Driver Info:\n\tDriver name : sp_vin\n\tModel : sunplus,sp7350-vin\n\tSerial : \n\tBus info : platform:f8005980.video\n\tMedia version : 5.10.201\n\tHardware revision: 0x00000000 (0)\n\tDriver version : 5.10.201\nEntity Info:\n\tID : 15\n\tName : VIN8 output\n\tType : V4L2 I/O\n\tPad : 0: Sink\nPriority: 2\nVideo input : 0 (VIN8 output: ok)\nFormat Video Capture:\n\tWidth/Height : 640/480\n\tPixel Format : 'GBRG' (8-bit Bayer GBGB/RGRG)\n\tField : None\n\tBytes per Line : 640\n\tSize Image : 307200\n\tColorspace : Raw\n\tTransfer Function : Default (maps to None)\n\tYCbCr/HSV Encoding: Default (maps to ITU-R 601)\n\tQuantization : Default (maps to Full Range)\n\tFlags : \n\nUser Controls\n\n white_balance_automatic 0x0098090c (bool) : default=0 value=0\n exposure 0x00980911 (int) : min=4 max=980 step=1 default=980 value=980\n gain_automatic 0x00980912 (bool) : default=0 value=0\n horizontal_flip 0x00980914 (bool) : default=0 value=0 flags=modify-layout\n vertical_flip 0x00980915 (bool) : default=0 value=0 flags=modify-layout\n alpha_component 0x00980929 (int) : min=0 max=255 step=1 default=255 value=255\n\nCamera Controls\n\n auto_exposure 0x009a0901 (menu) : min=0 max=1 default=1 value=1\n\nImage Source Controls\n\n vertical_blanking 0x009e0901 (int) : min=24 max=32287 step=1 default=504 value=504\n horizontal_blanking 0x009e0902 (int) : min=1256 max=1256 step=1 default=1256 value=1256 flags=read-only\n analogue_gain 0x009e0903 (int) : min=16 max=1023 step=1 default=32 value=32\n\nImage Processing Controls\n\n pixel_rate 0x009f0902 (int64) : min=77291670 max=77291670 step=1 default=77291670 value=77291670 flags=read-only","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.2 Capture Image","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.2.1 Config Video Device","type":"text"}]},{"type":"paragraph","content":[{"text":"Use v4l2-ctl -d /dev/video0 --set-ctrl params=value setting device controls.","type":"text"}]},{"type":"paragraph","content":[{"text":"Enable auto_exposure:","type":"text"}]},{"type":"codeBlock","content":[{"text":"v4l2-ctl -d /dev/video0 --set-ctrl auto_exposure=1","type":"text"}]},{"type":"paragraph","content":[{"text":"Enable gain_automatic","type":"text"}]},{"type":"codeBlock","content":[{"text":"v4l2-ctl -d /dev/video0 --set-ctrl gain_automatic=1","type":"text"}]},{"type":"paragraph","content":[{"text":"Enable white_balance_automatic","type":"text"}]},{"type":"codeBlock","content":[{"text":"v4l2-ctl -d /dev/video0 --set-ctrl white_balance_automatic=1","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.2.2 Capture","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"v4l2-ctl --list-formats-ext --device /dev/video0","type":"text","marks":[{"type":"code"}]},{"text":" querying device video format.","type":"text"}]},{"type":"codeBlock","content":[{"text":"root@dbv3:~# v4l2-ctl --list-formats-ext --device /dev/video0\nioctl: VIDIOC_ENUM_FMT\n\tType: Video Capture\n\n\t[0]: 'GBRG' (8-bit Bayer GBGB/RGRG)\n\t\tSize: Discrete 640x480\n\t[1]: 'GB10' (10-bit Bayer GBGB/RGRG)\n\t\tSize: Discrete 2592x1944\n\t\tSize: Discrete 1920x1080\n\t\tSize: Discrete 1296x972\n\t\tSize: Discrete 640x480\n\t[2]: 'pGAA' (10-bit Bayer GBGB/RGRG Packed)\n\t\tSize: Discrete 2592x1944\n\t\tSize: Discrete 1920x1080\n\t\tSize: Discrete 1296x972\n\t\tSize: Discrete 640x480\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"v4l2-ctl --stream","type":"text","marks":[{"type":"code"}]},{"text":" capture image.","type":"text"}]},{"type":"codeBlock","content":[{"text":"v4l2-ctl -d /dev/video0 --set-fmt-video=width=1920,height=1080,pixelformat=pGAA --stream-mmap=3 --stream-to=/home/root/ov5647.raw --stream-skip=9 --stream-count=1","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--set-fmt-video=width=1920,height=1080,pixelformat=pGAA set image format","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--stream-count stream buffers. The default is to keep streaming forever. This count does not include the number of initial skipped buffers as is passed by --stream-skip.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--stream-skip skip the first buffers. The default is 0.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"--stream-to stream to this file. The default is to discard the data. If is '-', then the data is written to stdout and the --silent option is turned on automatically.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" --stream-mmap capture video using mmap() [VIDIOC_(D)QBUF] count: the number of buffers to allocate. The default is 3.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"After executing the capture command, the stream data is written to ","type":"text"},{"text":"/home/root/ov5647.raw","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3.3 Display Image Raw Data","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.3.1 Download and Install Raw Image Viewer","type":"text"}]},{"type":"paragraph","content":[{"text":"Download raw image viewer from ","type":"text"},{"text":"PixelViewer | Carina Studio","type":"text","marks":[{"type":"link","attrs":{"href":"https://carinastudio.azurewebsites.net/PixelViewer/"}}]},{"text":". And PixelViewer is an ","type":"text"},{"text":"open source project","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/carina-studio/PixelViewer/"}}]},{"text":" based cross-platform image which viewer supports reading raw Luminance/YUV/RGB/ARGB/Bayer pixels data from file and rendering it.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3.3.2 Use PixelViewer to Open Image","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1920,"id":"4d095fb0-eee2-4384-a931-1a63939f3417","collection":"contentId-1991278623","type":"file","height":968}}]},{"type":"paragraph","content":[{"text":"Config render params by 3.2.2 v4l2-ctl capture command","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1920,"id":"d3fedbb2-ab60-478f-bf8e-41ad5b32dc7e","collection":"contentId-1991278623","type":"file","height":968}}]},{"type":"paragraph"}],"version":1}

Browser not supported