DriveWorks SDK Reference

| 0.6.67 Release

/builds/driveav/dw/sdk/samples/sensors/camera_gmsl_raw/README.md
Go to the documentation of this file.
1 # Copyright (c) 2017, NVIDIA CORPORATION. All rights reserved.
2 
3 @page dwx_camera_gmsl_raw_sample RAW GMSL Camera Capture Sample
4 
5 The RAW GMSL Camera Capture sample uses the GMSL camera interface available on
6 NVIDIA DRIVE<sup>&trade;</sup> PX 2 platforms. The sample creates a file for the RAW
7 data from the first camera on the selected CSI-port. The file is written to the disk.
8 
9 ![RAW GMSL Camera Capture Sample](sample_camera_gmsl_raw.png)
10 
11 ## Setting Up Cameras
12 
13 For information about the physical location of the ports on the NVIDIA DRIVE
14 platform, see "Camera Setup under Configuration and Setup" in _NVIDIA DRIVE 5.0 Linux
15 PDK Development Guide_.
16 
17 ## Running the Sample
18 
19 A camera must be connected to one of the NVIDIA DRIVE PX 2 CSI-ports.
20 
21 The following options are supported:
22 - `--csi-port={ab,cd,ef}` specifies a CSI port. Default value: `ab`.
23 - `--camera-type` specifies the type of the camera.
24  Supported cameras are`ar0231-rccb` (`ar0231-rccb-ss3322`, `ar0231-rccb-ss3323`), `ar0231-rccb-bae` and `ar0231-rccb-ssc`.
25 - `--write-file` specifies the output file. If `write-file` is not provided, no file is written out on disk.
26 
27 If the camera type is `ar0231-rccb-ssc` and the `csi-port` is the default ab, enter:
28 
29  ./sample_camera_gmsl_raw --write-file <filename>
30 
31 Otherwise, enter a command such as:
32 
33  ./sample_camera_gmsl_raw --csi-port=cd --camera-type=ar0231-rccb --write-file <filename>
34 
35 If camera capture is running, i.e., no error occurred, the sample prints on the
36 console:
37 
38  First 16 bytes from top data lines:
39  80 2 82 2a 0 8 42 29 0 0 81 16 0 0 81 16
40 
41  First 16 bytes from bottom data lines:
42  10 0 10 0 10 0 10 0 10 0 10 0 10 0 10 0
43 
44  Exposure Time (s): 0.000658364
45 
46 You can specify a demosaicing option with the `--interpolationDemosaic` option.
47 The following values are supported:
48 - 0 : half camera resolution is used.
49 - > 0 : full camera resolution with interpolation is used.
50 The argument `serializer-type` must be `uncompressed`.
51 
52 Press S to take a 16 bit png snapshot of the current RAW frame.
53 
54 ## Run on Tegra B
55 
56 #### Master Mode Prerequisites
57 
58 Before running camera applications only on Tegra B, you must disable FRSYNC and
59 the forward/reverse control channel of the Tegra A aggregator. For related information,
60 see *Camera Setup (P2379)* in *NVIDIA DRIVE Linux 5.0 PDK Development Guide*.
61 This guide explains how to:
62 * Turn on the MAX9286 aggregator.
63 * Disable FRSYNC and the forward/reverse control channel on MAX9286 aggregator
64  to avoid any interference with MAX96799.
65 
66 #### Master Mode
67 
68 After you have addressed the prerequisites (above) and have rebooted Tegra B,
69 you can run camera applications on Tegra B.
70 
71 @note Running camera applications on Tegra A re-enables the forward/reverse control channel and FRSYNC from MAX9286
72 and the procecedure of activating camera for Tegra B need to be repeated.
73 
74 #### Slave mode
75 Cameras can be captured on Tegra B in slave mode, i.e. when they are already captured
76 by an application on Tegra A. In such case it is possible to specify the "slave" flag, which can
77 be 0 or 1. If slave is 1, then Tegra B will not be able to run cameras
78 autonomously but it requires that camera to run at the same time from Tegra A.
79 If slave is false, then Tegra B can control any camera that is not currently
80 being used by Tegra A.