• Create a new file named ssh under the boot drive letter, without any extension. You can create a new file named ssh.txt, make sure the folder options display the extension, and then delete the .txt file. This way, you will have a file named ssh without any extension.
  
  
  

Use Windows SSH Login Command

1. Press the Win key and R key at the same time, input cmd, then press Enter to open the command line
2. Assume the obtained address is 192.168.10.36, the command should be:

   ssh pi@192.168.10.36

   
   
   
3. Enter Yes to confirm:
   
   
4. Enter the default password for the Raspberry Pi: raspberry:
   
   
Note: It is normal for the screen to remain unchanged when entering the password. After entering the password, press Enter to access the Raspberry Pi:
5. Here the SSH login is successful:
   
   

PUTTY Login

1. Open the corresponding flashing tool putty, click on session, and enter the Raspberry Pi's IP address in the IP address field:
   
   
2. Select Accept:
   
   
3. The login name is pi and the password is raspberry:
   
   
4. Here the login is successful:
   
   

libcamera-hello

This is a simple "hello world" program that previews the camera and displays the camera feed on the screen.

Usage example

libcamera-hello

This command will preview the camera on the screen for about 5 seconds, and the user can use the -t <duration> parameter to set the preview time, where the unit of <duration> is milliseconds, if it is set to 0, it will keep previewing. For example:

libcamera-hello -t 0

Tuning file

The libcamera driver of Raspberry Pi will call a tuning file for different camera modules, and various parameters are provided in the tuning file, and when the camera is called, libcamera will call the parameters in the tuning file, and the image will be processed in combination with the algorithm and finally output into a preview screen. Since the libcamera driver can only automatically detect the chip signal, but the final display effect of the camera will be affected by the entire module, the tuning file is used to flexibly handle the cameras of different modules and adjust to improve image quality.
If the camera output image is not ideal when using the default tuning file, the user can call a custom tuning file to adjust the image. For example, if you are using the official NOIR version camera, compared to the regular Raspberry Pi Camera V2, the NOIR camera may require different white balance parameters. In such cases, you can switch by calling the tuning file.

libcamera-hello --tuning-file /usr/share/libcamera/ipa/raspberrypi/imx219_noir.json

Users can copy the default tuning file and modify it according to their needs.
Note: The use of tuning files applies to other libcamera commands, which will not be described in subsequent commands

Preview window

Most libcamera commands will display a preview window on the screen. Users can customize the preview window's title information using the --info-text parameter. They can also call some camera parameters using %directives and display them in the window
For example, if you use HQ Camera: The focal length of the camera can be displayed on the window via --info-txe "%focus"br />

libcamera-hello --info-text "focus %focus"

Note: For more information about parameter setting, please refer to the subsequent section on command parameter settings

libcamera-jpeg

libcamera-jpeg is a simple static image capture program, unlike the complex features of libcamera-still, libcamera-jpeg code is more concise and has many of the same functions to complete image capture.

Take a full-pixel JPEG image

libcamera-jpeg -o test.jpg

This command will display a preview serial port for about 5 seconds, and then take a full-pixel JPEG image and save it as a test.jpg
The user can set the preview time with the -t parameter, and the resolution of the captured image can be set with --width and --height. For example:

libcamera-jpeg -o test.jpg -t 2000 --width 640 --height 480

Exposure control

All libcamera commands allow users to set shutter speed and gain, for example:

libcamera-jpeg -o test.jpg -t 2000 --shutter 20000 --gain 1.5

This command will capture an image, with an exposure of 20ms and a camera gain set to 1.5 times. The set gain parameter will prioritize adjusting the analog gain inside the photosensitive chip. If the set gain exceeds the maximum analog gain value built-in in the driver program, the system will first set the analog gain of the chip to the maximum value, and the remaining gain multiples will be implemented through digital gain.
Note: The digital gain is realized by ISP (Image Signal Processing), not directly adjusting the chip's built-in registers. Under normal circumstances, the digital gain is usually close to 1.0, unless the following three situations occur:

1. Gain requirement exceeds the analog gain range: When the analog gain cannot meet the set gain requirement, digital gain will be used for compensation.< br />
2. The gain of a certain color channel is less than 1: The digital gain can also be used to adjust the color gain. When the gain value of a certain color channel (such as red or blue) is less than 1, the system will apply a uniform digital gain, with a final value of 1/min (red_gain, blue_gain)< br />
3. Automatic exposure/gain control (AEC/AGC) adjustment: When AEC or AGC changes, the digital gain may be adjusted accordingly to eliminate brightness changes caused by parameter fluctuations. This change usually quickly returns to the "normal value". < br />

The AEC/AGX algorithm of Raspberry Pi allows the program to specify exposure compensation, which adjusts the brightness of the image by setting the aperture value. For example:

libcamera-jpeg --ev -0.5 -o darker.jpg
libcamera-jpeg --ev 0 -o normal.jpg
libcamera-jpeg --ev 0.5 -o brighter.jpg

libcamera-still

libcamera-still and libcamera-jpeg are very similar in functionality, but libcamera-still inherits more of the functionality originally provided by raspistill. For example, users can still use commands similar to the following to take a picture:

Test command

libcamera-still -o test.jpg

Encoder

libcamea-still supports image files in different formats, it can support png and bmp encoding, and it also supports saving binary dumps of RGB or YUV pixels directly to a file without encoding or any image format. If RGB or YUV data is saved directly, the program must know the pixel arrangement of the file when reading such files.

libcamera-still -e png -o test.png
libcamera-still -e bmp -o test.bmp
libcamera-still -e rgb -o test.data
libcamera-still -e yuv420 -o test.data

Note: The format of image saving is controlled by the -e parameter, if the -e parameter setting is not called, the format of the output file name will be saved by default.

Raw image capture

A raw image is an image output directly from an image sensor that has not been processed by any ISP or CPU. For color camera sensors, generally speaking, the output format of the original image is Bayer. Note that the original image is different from the bit-encoded RGB and YUV images we talked about earlier, and RGB and YUV are also ISP processed images.
The command to take a raw image:

libcamera-still -r -o test.jpg

The raw image is usually saved in DNG (Adobe Digital Negative) format, which is compatible with most standard programs such as dcraw or RawTherapee. The raw image is saved as a file with the same name with a .dng extension, e.g., if you run the above command, it will be saved as test.dng and a jpeg file will be generated at the same time. DNG files contain metadata related to image acquisition, such as white balance data, ISP color matrix, etc. The following metadata encoding information is displayed with the exiftool tool:

File Name                       : test.dng
Directory                       : .
File Size                       : 24 MB
File Modification Date/Time     : 2021:08:17 16:36:18+01:00
File Access Date/Time           : 2021:08:17 16:36:18+01:00
File Inode Change Date/Time     : 2021:08:17 16:36:18+01:00
File Permissions                : rw-r--r--
File Type                       : DNG
File Type Extension             : dng
MIME Type                       : image/x-adobe-dng
Exif Byte Order                 : Little-endian (Intel, II)
Make                            : Raspberry Pi
Camera Model Name               : /base/soc/i2c0mux/i2c@1/imx477@1a
Orientation                     : Horizontal (normal)
Software                        : libcamera-still
Subfile Type                    : Full-resolution Image
Image Width                     : 4056
Image Height                    : 3040
Bits Per Sample                 : 16
Compression                     : Uncompressed
Photometric Interpretation      : Color Filter Array
Samples Per Pixel               : 1
Planar Configuration            : Chunky
CFA Repeat Pattern Dim          : 2 2
CFA Pattern 2                   : 2 1 1 0
Black Level Repeat Dim          : 2 2
Black Level                     : 256 256 256 256
White Level                     : 4095
DNG Version                     : 1.1.0.0
DNG Backward Version            : 1.0.0.0
Unique Camera Model             : /base/soc/i2c0mux/i2c@1/imx477@1a
Color Matrix 1                  : 0.8545269369 -0.2382823821 -0.09044229197 -0.1890484985 1.063961506 0.1062747385 -0.01334283455 0.1440163847 0.2593136724
As Shot Neutral                 : 0.4754476844 1 0.413686484
Calibration Illuminant 1        : D65
Strip Offsets                   : 0
Strip Byte Counts               : 0
Exposure Time                   : 1/20
ISO                             : 400
CFA Pattern                     : [Blue,Green][Green,Red]
Image Size                      : 4056x3040
Megapixels                      : 12.3
Shutter Speed                   : 1/20

Ultra-long exposure

If we want to take an ultra long exposure image, we need to disable AEC/AGC and white balance, otherwise these algorithms will cause the image to wait for many more frames of data as it converges. Disabling these algorithms requires setting explicit values separately, and users can skip the preview process through the -- immediate setting.
Here is the command to take an image with a 100 second exposure:

libcamera-still -o long_exposure.jpg --shutter 100000000 --gain 1 --awbgains 1,1 --immediate

Note: The maximum exposure times for several official cameras are shown in the table.

libcamera-vid

libcamera-vid is a video recording program that uses the Raspberry Pi's hardware H.264 encoder by default. After running this program, a preview window will be displayed on the screen, and the bitstream will be encoded and output to the specified file. For example, recording a 10 second video.

libcamera-vid -t 10000 -o test.h264

If you want to view videos, you can use VLC to play them.

vlc test.h264

Note: The recorded video stream is unpacked, users can use --save-pts to set the output timestamp, which is convenient for converting the bitstream to other video formats.

libcamera-vid -o test.h264 --save-pts timestamps.txt

If you want to output an mkv file, you can use the following command:

mkvmerge -o test.mkv --timecodes 0:timestamps.txt test.h264

Encoder

The Raspberry Pi supports JPEG as well as YUV420 without compression and formatting:

libcamera-vid -t 10000 --codec mjpeg -o test.mjpeg
libcamera-vid -t 10000 --codec yuv420 -o test.data

The --codec option sets the output format, not the extension of the output file.
The -- segment parameter can be used to segment the output file into segments (in milliseconds), which is suitable for splitting JPEG video streams into individual JPEG files with relatively short processing times (approximately 1ms).

libcamera-vid -t 10000 --codec mjpeg --segment 1 -o test%05d.jpeg

UDP video streaming transmission

UDP can be used for video streaming, running on the Raspberry Pi server:

libcamera-vid -t 0 --inline -o udp://<ip-addr>:<port>

Where <ip-addr> needs to be replaced with the actual client IP address or multicast address.
On the client, enter the following commands to fetch and display the video stream (use one of the two commands):

vlc udp://@:<port> :demux=h264
vlc udp://@:<port> :demux=h264

Note: The port needs to be consistent with the one you set on the Raspberry Pi.

TCP video streaming transmission

TCP can be used for video streaming, running on the Raspberry Pi server:

libcamera-vid -t 0 --inline --listen -o tcp://0.0.0.0:<port>

The client runs:

vlc tcp/h264://<ip-addr-of-server>:<port> #Just pick one of the two commands
ffplay tcp://<ip-addr-of-server>:<port> -vf "setpts=N/30" -fflags nobuffer -flags low_delay -framedrop

RTSP video streaming transmission

On Raspberry Pi, VLC is commonly used to process RTSP video streams,

libcamera-vid -t 0 --inline -o - | cvlc stream:///dev/stdin --sout '#rtp{sdp=rtsp://:8554/stream1}' :demux=h264

On the playback end, you can run any of the following commands:

vlc rtsp://<ip-addr-of-server>:8554/stream1
ffplay rtsp://<ip-addr-of-server>:8554/stream1 -vf "setpts=N/30" -fflags nobuffer -flags low_delay -framedrop

Among all preview commands, if you want to close the preview window on the Raspberry Pi, you can use the parameter - n (-- nopeview) to set it. Additionally, please note the setting of the -inline parameter, which will force the header information of the video stream to be included in every I (intra) frame. This setting allows the client to correctly parse the video stream even if the video header is lost.

High frame rate mode

If you use the libcamera-vid command to record a high frame rate (generally higher than 60fps) and reduce frame drops, pay attention to the following points:

1. Set the target level for H.264: The encoding level for H.264 needs to be set to 4.2, which can be achieved by adding the -- level 4.2 parameter.
2. Turn off color noise reduction function: When recording high frame rate videos, the color noise reduction function must be turned off to reduce additional performance consumption. You can use the parameter -- denoise cdn_off to turn it off.
3. Close preview window (applicable for frame rates above 100fps): If the frame rate setting exceeds 100fps, it is recommended to close the preview window to free up more CPU resources and avoid frame loss. It can be set using the parameter -n.
4. Enable forced Turbo mode: Add the force_turbo=1 setting in the/boot/config.txt file to ensure that the CPU clock frequency is not limited during video recording, thereby improving performance.
5. Adjusting ISP output resolution: Lowering the resolution can reduce resource usage, for example, setting the resolution to 1280x720 using the parameters - width 1280- height 720, or adjusting it to a lower resolution based on the camera model.
6. Overclocking GPU (applicable to Raspberry Pi 4 or higher models): You can overclock the GPU by adding a value of gpu_freq=550 (or higher) in the/boot/config.txt file to improve performance and meet high frame rate requirements.

For example:
The following command is used to record a video with a resolution of 1280x720 and a frame rate of 120fps:

libcamera-vid --level 4.2 --framerate 120 --width 1280 --height 720 --save-pts timestamp.pts -o video.264 -t 10000 --denoise cdn_off -n

libcamera-raw

libcamera-raw is similar to a video recording program, except that libcamera-raw records data in Bayer format that is directly output by the sensor, i.e., raw image data. libcamera-raw does not show the preview window. For example, recording a 2-second raw data clip.

libcamera-raw -t 2000 -o test.raw

The program will dump the original frame directly without format information, and the program will print the pixel format and image size directly on the terminal, and the user can view the pixel data according to the output data.
By default, the program saves the original frame as a file, which is usually quite large and can be split by the --segement parameter.

libcamera-raw -t 2000 --segment 1 -o test%05d.raw

If the memory conditions are good (such as using SSD), libcamera-raw row can write official HQ Camera data (approximately 18MB per frame) to the hard drive at a speed of about 10 frames per second. To achieve this speed, the program writes raw frames that have not been formatted and cannot be saved as DNG files like libcamera-still. If you want to ensure that there is no frame loss, you can use -- framerate to reduce the frame rate.

libcamera-raw -t 5000 --width 4056 --height 3040 -o test.raw --framerate 8

General Command Setting Options

The general command setting options apply to all of libcamera's commands

--help, 	-h

Print the program help information, you can print the available setting options for each program command, and then exit.

--version

Print the software version, print the software version of libcamera and libcamera-app, and exit.

--list-cameras

Display the recognized supported cameras. For example:

Available cameras
-----------------
0 : imx219 [3280x2464] (/base/soc/i2c0mux/i2c@1/imx219@10)
    Modes: 'SRGGB10_CSI2P' : 640x480 [206.65 fps - (1000, 752)/1280x960 crop]
                             1640x1232 [41.85 fps - (0, 0)/3280x2464 crop]
                             1920x1080 [47.57 fps - (680, 692)/1920x1080 crop]
                             3280x2464 [21.19 fps - (0, 0)/3280x2464 crop]
           'SRGGB8' : 640x480 [206.65 fps - (1000, 752)/1280x960 crop]
                      1640x1232 [41.85 fps - (0, 0)/3280x2464 crop]
                      1920x1080 [47.57 fps - (680, 692)/1920x1080 crop]
                      3280x2464 [21.19 fps - (0, 0)/3280x2464 crop]
1 : imx477 [4056x3040] (/base/soc/i2c0mux/i2c@1/imx477@1a)
    Modes: 'SRGGB10_CSI2P' : 1332x990 [120.05 fps - (696, 528)/2664x1980 crop]
           'SRGGB12_CSI2P' : 2028x1080 [50.03 fps - (0, 440)/4056x2160 crop]
                             2028x1520 [40.01 fps - (0, 0)/4056x3040 crop]
                             4056x3040 [10.00 fps - (0, 0)/4056x3040 crop]

According to the printed information, IMX219 camera suffix 0, IM new 477 camera suffix 1. When calling the camera, the corresponding suffix can be specified.

--camera

Specify the camera, and the corresponding suffix can refer to the printing information of the command --list-camera.
For example: libcamera-hello -c config.txt
In the settings file, set parameters one by one in the format of key=value:

timeout=99000
verbose=

--config,	-c

In general, we can directly set camera parameters through commands. Here, we use the -- config parameter to specify a settings file and directly read the settings parameters from the file to set the camera preview effect.

--timeout, 	-t

The -t option sets the running time for the libcamera program. If the command is for video recording, the timeout option sets the recording duration. If the command is for taking an image, the timeout option sets the preview time before capturing and outputting the image.
If no timeout is set when running the libcamera program, the default timeout value is 5000 (5 seconds). If the timeout is set to 0, the program will run indefinitely.
For example: libcamera-hello -t 0

--preview,  -p

The -p option sets the preview window size and position (if qualified, the setting will be valid in both X and DRM versions of the window), set the format to --preview <x, y, w, h> where x and y set the position of the preview window on the display, and w and h set the width and height of the preview window.
The settings of the preview window do not affect the resolution and aspect ratio of the camera image preview. The program will zoom the preview image to the preview window and adapt it to the original image aspect ratio.
For example: libcamera-hello -p 100,100,500,500

--fullscreen, -f

The -f option sets the preview window to be displayed in full screen, and the preview window and border in full screen display mode. Like -p, it does not affect the resolution and aspect ratio, and will be automatically adapted.
For example: libcamera-still -f -o test.jpg

--qt-preview

Use a preview window based on the QT framework. Normally, this setting is not recommended because the preview program does not use zero-copy buffer sharing or GPU acceleration, which can lead to high resource consumption. The QT preview window supports X forwarding (not supported by the default preview program).
The Qt preview window does not support the --fullscreen setting option. If the user wants to use Qt preview, it is recommended to keep the preview window small to avoid high resource consumption affecting the normal operation of the system.
For example: libcamera-hello --qt-preview

--nopreview, -n

Do not preview the image. This setting will turn off the image preview function.
Example: libcamera-hello -n

--info-text

Set the preview window title and information display (only effective in X graphical windows) using the format --info-text <string>. To call this option, there are multiple parameters that can be set, and the parameters are usually called in the form of % command. The program calls the corresponding values in the graphical metadata according to the commands.
If no window information is specified, the default --info-text setting is "#%frame (%fps fps) exp %exp ag %ag dg %dg"
For example: libcamera-hello --info-test "Focus measure: %focus Available parameters:

--width
--height

These two parameters set the width and height of the image respectively. For the libcamera-still, libcamera-jpeg and libcamera-vid commands, these two parameters can set the resolution of the output image/video.
If the libcamera-raw command is used, these two parameters will affect the size of the metadata frame obtained. The camera has a 2x2 block reading mode. If the set resolution is smaller than the block mode, the camera will obtain the metadata frame according to the 2x2 block size.
libcamera-hello cannot specify the resolution.< br /> For example:
libcamera-vid -o test.h264 --width 1920 --height 1080 records 1080p video.
libcamera-still -r -o test.jpg --width 2028 --height 1520 takes a JPEG image with a resolution of 2028x1520.

--viewfinder-width
--viewfinder-height

This setting option is also used to set the resolution of the image, except that only the size of the image for the preview is set. It does not affect the resolution of the final output image or video. The device that previews the size of the image does not affect the size of the preview window, and it will be adapted according to the window.
For example: libcamera-hello --viewfinder-width 640 --viewfinder-height 480

--rawfull

This setting forces the sensor to activate --width and --height settings, outputting static images and videos in full resolution read mode. This setting libcamera-hello is invalid.
With this setting, the frame rate is sacrificed. In full-resolution mode, frame reading speeds will be slower.
For example: libcamera-raw -t 2000 --segment 1 --rawfull -o test%03d.raw example command captures multiple frames of metadata in full resolution mode. If you are using the HQ camera. The size of each frame is 18MB. If --rawfull is not set, the HQ camera defaults to 2x2 mode, and the data size of each frame is only 4.5MB.

--mode

This parameter is more universal than rawfull and is used to set the camera mode. When using it, you need to specify the width, height, bit depth, and packaging mode, and separate them with colons. The set values do not necessarily have to be completely accurate, the system will automatically match the closest values, and the bit depth and packaging mode can be set (default is 12 and P represents packaging).

• 4056:3040:12:P - 4056x3040 resolution, 12bit per pixel, packaged. Packaging means that the original image data will be packed in the buffer, in which case, two pixel points will only occupy 3 bytes, saving memory.
• 1632:1224:10 - 1632x1224 resolution, 10bit per pixel, default packaging. In the 10-bit packaging mode, 4 pixel data points will occupy 5 bytes.
• 2592:1944:10:U - 2592x1944 resolution, 10 bits per pixel, not packaged. Without packaging, each speed limit will occupy 2 bytes of memory, in which case, the highest 6 bits will be set to 0.
• 3262:2448 - 3264x2448 resolution, default using 12 bits and packed mode. However, if the camera model, such as the Camera V2 (IMX219) does not support 12 bits mode, the system will automatically select 10 bits mode.

--viewfinder-mode       #Specify sensor mode, given as <width>:<height>:<bit-depth>:<packing>

--mode parameter is used to set the camera mode when recording videos and taking static images. If you want to set it during preview, you can use the --viewfinder-mode parameter.

--lores-width
--lores-height	

These two options set low resolution images. Low-resolution data streams compress images, causing a change in the aspect ratio. When recording videos with libcamera-vid, if the low resolution is set, the color denoising and other functions will be disabled.
For example: libcamera-hello --lores-width 224 --lores-height 224 Note that low resolution settings are usually combined with image post-processing; otherwise, they are not very effective.

--hflip   #Flip the image horizontally
--vflip    #Flip the image vertically
--rotation     #Depending on the angle given, flip the image horizontally or vertically <angle>

These three options are used to flip the image. --rotation parameter currently only supports 0 and 180, which is equivalent to --hflip and --vflip.
For example: libcamera-hello --vflip --hflip

--roi   #Crop image<x, y, w, h>

--roi allows users to crop their desired image area from the full image provided by the sensor according to coordinates, which is essentially digital scaling. Note that the coordinate values should be within the valid range. For example, --roi 0, 0, 1, 1 is an invalid command.
Example: libcamera-hello --roi 0.25,0.25,0.5,0.5 example command crops 1/4 of the image from the center of the image.

--hdr				Run the camera in HDR mode (supported cameras only)

The hdr parameter is used to set the wide dynamic mode of the camera. This setting will only take effect if the camera supports wide dynamic range. You can use--list-camera to see if the camera supports hdr mode.

--sharpness #Set the image sharpness <number>

Adjust the image sharpness through <number> values. If set to 0, no sharpening is applied. If the value is set higher than 1.0, the extra sharpening amount is used.
For example: libcamera-still -o test.jpg --sharpness 2.0

--contrast  #Set the image contrast <number>

For example: libcamera-still -o test.jpg --contrast 1.5

--brightness  #Set the image brightness<number>

The setting range is -1.0~1.0
Example: libcamera-still -o test.jpg --brightness 0.2

--saturation  #Set the image color saturation<number>

Example: libcamera-still -o test.jpg --saturation 0.8

--ev  #Set EV compensation<number>

Set the EV compensation of the image in aperture units, the setting range is -10 ~ 10, the default value is 0. The program runs using AEC/AGC algorithms.
Example: libcamera-still -o test.jpg --ev 0.3

--shutter  #Set exposure time, unit is ms <number>

Note: If the frame rate of the camera is too fast, it may not work according to the set shutter time, if this happens, you can try to reduce the frame rate with --framerate.
Example: libcamera-hello --shutter 30000

--gain  #Set the gain value (combination of numerical gain and analog gain) <number>
--analoggain  #--Synonymous with gain

--analoggain and --gain are the same, and using --analoggain is only for compatibility with the raspicam program.

--metering  #Set the metering mode <string>

To set the metering mode of the AEC/AGC algorithm, the available parameters are:

• centre - center metering (default)
• spot - spot metering
• averag - average or full-frame metering
• custom - custom metering mode, which can be set by the tuning file

Example: libcamera-still -o test.jpg --metering spot

--exposure   #Set exposure configuration file <string>

The exposure mode can be set to normal or sport. The reporting profile files of these two modes does not affect the overall exposure of the image, but in the case of sport mode, the program shortens the exposure time and increases the gain to achieve the same exposure effect.

• sport: short exposure time, large gain
• normal: normal exposure, normal gain
• long: long exposure time, small gain

Example: libcamera-still -o test.jpg --exposure sport

--awb  #Set white balance mode<string>

Available white balance modes:

For example: libamera-still -o test.jpg --awb tungsten

--awbgains   #Set fixed color gain<number,number>

Set the red and blue gains.
For example: libcamera-still -o test.jpg --awbgains 1.5, 2.0

--denoise  #Set the denoising mode <string>

Supported denoising modes:

• Auto - Default mode, uses standard spatial denoising, uses fast color denoising for video, and uses high-quality color denoising for static images. Preview images will not use any color denoising
• off—Turns off spatial denoising and color denoising
• cdn_off - Turn off color denoising
• cdn_fast - Use fast color denoising
• cdn_hq - Uses high-quality color denoising, not applicable for video recording

For example: libcamera-vid -o test.h264 --denoise cdn_off

--tuning-file #Specify the camera tuning file <string>

For more instructions on tuning files, please refer to the official tutorial
For example: libcamera-hello --tuning-file ~/my~camera-tuning.json

--autofocus-mode			Specify the autofocus mode <string>

Set the autofocus mode.

• default - By default, the camera will start continuous autofocus mode, unless --lens-position or --autofocus-on-capture manual focus is set
• manual - Manual focus mode, you can set the focus position by --lens-position
• auto - Only focuses when the camera is turned on; does not adjust focus in other situations (If the libcamera-still command is used, autofocus will only occur before taking a photo when the --autofocus-on-capture option is used)
• continuous - The camera will automatically adjust the focus position according to the scene changes

--autofocus-range   Specify the autofocus range <string>

Set the autofocus range.

• normal - Default item, from nearest to infinity
• macro - Macro mode, only focus on close objects
• full - Full distance mode, adjust to infinity for nearest objects

--autofocus-speed   Specify the autofocus speed <string>

Set the focus speed.

• normal - Default item, normal speed
• fast - Fast focus mode

--autofocus-window   --autofocus-window

To display the focus window, you need to set x, y, width, height, where the coordinate values are set according to the scale of the image. For example, -autofocus-window 0.25,0.25,0.5,0.5 will set a window that is half the size of the image and is in the center.

--lens-position	    Set the lens to a given position <string>

Set the focus position.

• 0.0 -- Set the focus position to infinity
• number --Set the focus position to 1/number, where the number is any value you set, for example, if set to 2, it means the focus will be on a position of 0.5m
• default -- Focus to the default position relative to the lens hyperfocal length

--output, -o  #Output filename <string>

Set the file name of the output image or video. In addition to setting the file name, you can also specify the udp or tcp server address for the output to output the image to the server. If you are interested, you can check the relevant setup instructions for subsequent tcp and udp.
For example: libcamera-vid -t 100000 -o test.h264

--wrap  #Package the output file counter<number>

示例： libcamera-vid -t 0 --codec mjpeg --segment 1 --wrap 100 -o image%d.jpg

--flush  #Refresh the output file immediately

--flush will write each frame image to the hard disk immediately while updating, reducing latency.
Example: libcamera-vid -t 10000 --flush -o test.h264

Still Picture Shooting Setting Parameters

--qiality, -q  #Set JPEG image quality <0 ~ 100>
--exif, -x #Add additional EXIF flags
--timelapse  #The time interval for taking pictures with time delay, the unit is ms
--framestart #The starting value of the frame count
--datetime  #Name the output file in date format
--timestamp #Name the output file with the system timestamp
-- restart  #Set the JPEG restart time interval
--keypress, -k  #Set Enter button to take a photo mode
--signal, -s  #Set signal to trigger photography
--thumb #Set thumbnail parameters <w:h:q>
--ebcoding, -e  #Sets the image encoding type jpg / png / bmp / rgb / yuv420
--raw, -r  #Save the original image
--latest #Associate the symbol to the latest saved file
--autofocus-on-capture  #Set to perform a focus action before taking a photo

Video Recording Image Setting Parameters

--quality, -q  #Set the JPEG quality <0 - 100>
--bitrate, -b  #Set H.264 bitrate
--intra, -g #Set internal frame period (only supports H.264)
--profile #Set H.264 configuration
--level  #Set H.264 level
--codec  #Set encoding type h264/mjpeg/yuv420
--keypress, -k  #Set Enter to pause and record
--signal, -s  #Set signal pause and recording
--initial #Start the program while recording or pausing
--split #Split the video and save it to another file
--segment #Split the video into multiple video segments
--circular  #Write the video into a circular buffer
--inline #Write data header in each I-frame (only supports H.264)
--listen #Wait for TCP connection
--frames #Set the number of frames recorded

• For more camera settings instructions, please refer to the Official camera documentation

Install Raspicam (optional)

Open the Raspberry Pi terminal and enter the following command to install the driver. Note: This driver temporarily does not support 64-bit Raspberry Pi systems.

sudo apt-get update
cd
sudo apt install cmake
git clone https://github.com/raspberrypi/userland
cd userland
./buildme
cp build/bin/* ~/bin/

Reboot the system after installation

sudo reboot

Call Camera

raspistill

The raspistill command is used to take static pictures. Example: raspistill -o cam.jpg

raspivid

The raspivid command is used to record videos. For example: raspivid -o vid.h264

raspiyuv

The raspiyuv command has the same function as raspisitll, except that raspiyuv does not output standard image files such as jpgs, but generates YUV420 or RGB888 image files from the camera's ISP output.
In most cases, it's better to shoot images with raspistill, but if you want to use uncompressed black and white images, you can choose to use the raspiyuv command. Example: raspiyuv -o cam.jpg

Command Setting Options

When using the raspicam command, you can adjust the final image effect of the image by setting the options. The available setting options are listed below for reference.

--preview, -p  #Set preview window<x, y, w, h>

Users can set the position of the preview window by setting the values of x and y, and adjust the resolution of the preview image by setting the values of w and h.

--fullscreen, -f  #Full screen preview window

Display the preview window in full screen

--nopreview, -n  #Does not display the preview window

Close the preview window, and the command will output the image or video directly to the file.

--opacity, -op  #Sets the transparency of the preview window

Set the transparency of the preview window, 0 is invisible, 255 is fully transparent

--sharpness, -sh  #Set the image sharpness (-100 - 100)

The default sharpening value is 0

--contrast. -co  #Set the image contrast (-100 - 100)

The default contrast ratio is 0

--brightness, -br  #Set image contrast (0 - 100)

The default brightness is 50, 0 is all black, and 100 is all white.

--saturation, -sa  #Set image saturation (-100 - 100)

The default saturation is 0

--ISO  #Set shutter sensitivity (100 - 800)

Set the sensitivity for photography

--vstab, -vs  #Enable video stabilization

Only effective in video recording mode, enable video stabilization.

--ev  #Set EV compensation

Set the EV compensation value of the image, the default is 0

--exposure,  -ex  #Set exposure mode

Exposure options that can be set:

• auto: Auto exposure mode
• night: Night shot mode
• nightpreview
• backlight: Backlight mode
• spotlight
• sports: Sport mode (Shutter time is shortened in sport mode)
• snow: Snow mode
• beach: Beach mode
• verylong: Long exposure mode
• fixedfps: Fixed fps
• antishake: Anti-shake mode
• fireworks: Fireworks mode

Note: Depending on the camera model, some modes are unavailable

--flicker, -fli   #Flicker avoidance

The modes that can be set:

• off: Turn off anti-flicker mode
• auto: Automatic frequency detection
• 50Hz: Set the anti-flicker frequency to 50Hz
• 60Hz: Set the anti-flicker frequency to 60Hz

--awb,  #Set auto white balance mode

• off: Turn off auto white balance
• auto： Auto white balance mode (default)
• sun: Sunny mode (5000K ~ 6500K)
• cloud: Cloudy mode (6500K ~ 12000K)
• shade: Shadow mode
• tungsten: Tungsten lamp mode (2500K ~ 3500K)
• Incandescent: Incandescent mode (2500K ~ 4500K)
• flash: Flash mode
• horizon: Horizon mode
• greyworld: If you are using a camera without an IR filter (such as NoIR), you can fix the white balance imbalance caused by the lack of an IR filter

Note: Depending on the camera model, some modes are unavailable

--imfx, -ifx  #Set image filter effect

Image filter effects that can be set:

• none: No effect (default)
• negative: Color flip mode
• solarise: Sunlight effect
• posterise: Poster effect
• whiteboard: Whiteboard effect
• backboard: Blackboard effect
• sketch: Sketch effect
• denoise: Denoising effect
• emboss: Embossed effect
• oilpaint: Oil painting effect
• hatch: Texture effect
• gpen: Pencil sketch effect
• pastel: Color pencil effect
• watercolour: Watercolor effect
• film: Film effect
• blur: Blur effect
• saturation: Saturation effect

Note: Depending on the camera model, some modes are unavailable

--colfx, -cfx  #Set the color effect<U:V>

U and V parameters are set in the range of 0 ~ 255, used to adjust the values of the U and Y channels. For example: --colfx 128:128 will set the image to monochrome.

--metering, -mm  #Set metering mode

Options that can be set:

• average: Average or full-frame metering
• spot: Spot metering
• backlit: Preset a backlit image
• matrix: Matrix metering

--rotation, -rot  #Set image rotation (0 - 359)

Set image rotation angle via the angle parameter

--hflip, -hf  #Set the image to flip horizontally

1. Set the image to flip horizontally

--vflip, -vf  #Set the image to flip vertically

Flip the image vertically

--roi, #Crop image <x, y, w, h>

Crop the image according to the parameters, note that the parameter setting range is (0,0~1.0). For example, if you want to crop 1/4 of the image, you can use the command -roi 0.5,0.5,0.25,0.25

--shutter, --ss  #Set the shutter speed/time

Set the shutter time (unit: ms). The maximum shutter time that can be set varies depending on the photosensitive chip.

--drc, -drc  #Enable/disable dynamic range compression

• off (default)
• low
• med
• high

--stats, -st  #Count images by still image frames

--awbgains, -awbg

Set blue and green gain, effective when --awb off is set

--analoggain, -ag

Sets the analog gain value

--digitalgain, -dg

Set the digital gain value

--mode, -md

Set the sensor mode:

• OV5647

• IMX219

• HQ Camera

--camselect, -cs

When the system connects to multiple cameras, select the camera 0 or 1.

--annotate, -a #Enable/set comments

Parameters can be represented by bitmasks in metadata, which can be directly expressed by addition. For example, 12 can be used to represent the display time (4) and the display date (8), which is represented by the addition of 4+8 = 12.
Options that can be set:

--annotateex, -ae  #Set additional annotation parameter

--stereo, -3d

Set binocular mode.

• sbs - Side by side mode
• tb: -Vertical mode
• off -Disable binocular mode (default)

--decimate, -dec

Halve the width and height of the binocular image

--setting, -set

Output the current camera setting

raspistill Setting Parameters

--width, -w  #Set the image width
--height, -h  #Set the image height
--quality, 0q  #Set the JPEG quality <0 ~ 100>
--raw, -r  #Add the original Bayer data to the JPEG metadata
--output, -o #Output file <filename>
--latest, -l  #Associate the last frame image with the file <filename>
--verbose, -v #Print details
--timeout, -t  #Set the program preview time
--timelapse, -tl  #Set time-lapse photography
--framestart, -fs #Save the number of the first frame
--datetime, -dt  #Name files with date and time
--timestamp, -ts #Name the file with a timestamp
--thumb, -th #Set thumbnail parameters <x:y:qulity>, the default is (64:48:35)
--demo, -d  #Run demo mode<ms>
--encoding, -e #Encode in the specified format, jpg, bmp or png
--restart, -rs  #Set the JPEG restart flag
--exif, -x   #Set the EXIF tag
--gpsdexif, -gps #Set real-time exif time (requires GPS Dongle access)
--fullpreview,  -fg  #Full screen preview
--keypress, -k  #Key-pess photography mode
--signal, -s  #Signal mode
--burst, -bm #Snapshot mode

raspivid Setting Parameters

--width, -w  #Sets the video width
--height, -h  #Set the video height
--bitrate, -b #Set bit rate
--output, -o #Set the output file name<filename>
--listen, -l #When using a network connection, waiting for the network connection
--versbose, -v #Print details
--timeout, -t  #Set the preview time
--demo, -d  #Run demo<ms>
--framerate, -fs #Set the frame rate
--penc, -e #Displays the encoded preview image
--intra, -g #Set the internal refresh cycle
--qp, -qp #Set the quantization parameter
--profile, -pf #Specify H264 configuration file, baseline / main / high
--level, -lev  #Set the H264 encoding level
--irefresh, -if #Set the H264 internal refresh type, cyclic / adaptive / both / cyclicrows
--inline, -ih  #Insert PPS and SPS headers
--spstimings, -stm #Insert timing information into the SPS block
--timed, -td  #Regularly switch recording and pause functions
--keypress, -k  #Press to pause recording
--signal, -s  #Switch the pause and recording status according to SIGUSR1
--split, -sp  #Each time you re-record in signal and keypress mode, a new file will be created
--vectors, -x  #Vector output
--flush, -fl  #Write video data and immediately force refresh the output data buffer, bypassing any operating system cache and reducing latency
--save-pts, -pts  #Save the timestamp information to the specified file
--codec, -cd  #Specify encoder H264 / MJPEG
--initial, -i  #Sets the initial state at startup
--segment, -sg #Split the video stream into multiple files
--wrap, -wr  #Set the maximum value for splitting
--start, -sn #Set the initial split encoding
--raw, -r #Set the metadata file name
--raw-format, -rf #Specify the metadata formats yuv / rgb / grey