libcamera v0.5.1
Supporting cameras in Linux since 2019
Loading...
Searching...
No Matches
v4l2_subdevice.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2019, Google Inc.
4 *
5 * V4L2 Subdevice
6 */
7
8#pragma once
9
10#include <memory>
11#include <optional>
12#include <ostream>
13#include <stdint.h>
14#include <string>
15#include <vector>
16
17#include <linux/v4l2-subdev.h>
18
20#include <libcamera/base/log.h>
21
23#include <libcamera/geometry.h>
24
28
29namespace libcamera {
30
31class MediaDevice;
32
34{
35public:
41
42 bool isValid() const { return code != 0; }
43
44 static const MediaBusFormatInfo &info(uint32_t code);
45
46 const char *name;
47 uint32_t code;
49 unsigned int bitsPerPixel;
51};
52
53struct V4L2SubdeviceCapability final : v4l2_subdev_capability {
54 bool isReadOnly() const
55 {
56 return capabilities & V4L2_SUBDEV_CAP_RO_SUBDEV;
57 }
58 bool hasStreams() const
59 {
60 return capabilities & V4L2_SUBDEV_CAP_STREAMS;
61 }
62};
63
65 uint32_t code;
67 std::optional<ColorSpace> colorSpace;
68
69 const std::string toString() const;
70};
71
72std::ostream &operator<<(std::ostream &out, const V4L2SubdeviceFormat &f);
73
75{
76public:
77 using Formats = std::map<unsigned int, std::vector<SizeRange>>;
78
79 enum Whence {
80 TryFormat = V4L2_SUBDEV_FORMAT_TRY,
81 ActiveFormat = V4L2_SUBDEV_FORMAT_ACTIVE,
82 };
83
84 struct Stream {
86 : pad(0), stream(0)
87 {
88 }
89
90 Stream(unsigned int p, unsigned int s)
91 : pad(p), stream(s)
92 {
93 }
94
95 unsigned int pad;
96 unsigned int stream;
97 };
98
99 struct Route {
101 : flags(0)
102 {
103 }
104
105 Route(const Stream &snk, const Stream &src, uint32_t f)
106 : sink(snk), source(src), flags(f)
107 {
108 }
109
112 uint32_t flags;
113 };
114
115 using Routing = std::vector<Route>;
116
117 explicit V4L2Subdevice(const MediaEntity *entity);
119
120 int open();
121
122 const MediaEntity *entity() const { return entity_; }
123
124 int getSelection(const Stream &stream, unsigned int target,
125 Rectangle *rect);
126 int getSelection(unsigned int pad, unsigned int target, Rectangle *rect)
127 {
128 return getSelection({ pad, 0 }, target, rect);
129 }
130 int setSelection(const Stream &stream, unsigned int target,
131 Rectangle *rect);
132 int setSelection(unsigned int pad, unsigned int target, Rectangle *rect)
133 {
134 return setSelection({ pad, 0 }, target, rect);
135 }
136
137 Formats formats(const Stream &stream);
138 Formats formats(unsigned int pad)
139 {
140 return formats({ pad, 0 });
141 }
142
143 int getFormat(const Stream &stream, V4L2SubdeviceFormat *format,
144 Whence whence = ActiveFormat);
145 int getFormat(unsigned int pad, V4L2SubdeviceFormat *format,
146 Whence whence = ActiveFormat)
147 {
148 return getFormat({ pad, 0 }, format, whence);
149 }
150 int setFormat(const Stream &stream, V4L2SubdeviceFormat *format,
151 Whence whence = ActiveFormat);
152 int setFormat(unsigned int pad, V4L2SubdeviceFormat *format,
153 Whence whence = ActiveFormat)
154 {
155 return setFormat({ pad, 0 }, format, whence);
156 }
157
158 int getRouting(Routing *routing, Whence whence = ActiveFormat);
159 int setRouting(Routing *routing, Whence whence = ActiveFormat);
160
161 const std::string &model();
162 const V4L2SubdeviceCapability &caps() const { return caps_; }
163
164 static std::unique_ptr<V4L2Subdevice>
165 fromEntityName(const MediaDevice *media, const std::string &entity);
166
167protected:
168 std::string logPrefix() const override;
169
170private:
172
173 std::optional<ColorSpace>
174 toColorSpace(const v4l2_mbus_framefmt &format) const;
175
176 std::vector<unsigned int> enumPadCodes(const Stream &stream);
177 std::vector<SizeRange> enumPadSizes(const Stream &stream,
178 unsigned int code);
179
180 int getRoutingLegacy(Routing *routing, Whence whence);
181 int setRoutingLegacy(Routing *routing, Whence whence);
182
183 const MediaEntity *entity_;
184
185 std::string model_;
186 struct V4L2SubdeviceCapability caps_;
187};
188
189bool operator==(const V4L2Subdevice::Stream &lhs, const V4L2Subdevice::Stream &rhs);
190static inline bool operator!=(const V4L2Subdevice::Stream &lhs,
191 const V4L2Subdevice::Stream &rhs)
192{
193 return !(lhs == rhs);
194}
195
196std::ostream &operator<<(std::ostream &out, const V4L2Subdevice::Stream &stream);
197std::ostream &operator<<(std::ostream &out, const V4L2Subdevice::Route &route);
198std::ostream &operator<<(std::ostream &out, const V4L2Subdevice::Routing &routing);
199
200} /* namespace libcamera */
Utilities to help constructing class interfaces.
#define LIBCAMERA_DISABLE_COPY(klass)
Disable copy construction and assignment of the klass.
Definition class.h:27
Information about media bus formats.
Definition v4l2_subdevice.h:34
Type type
The media bus format type.
Definition v4l2_subdevice.h:48
bool isValid() const
Check if the media bus format info is valid.
Definition v4l2_subdevice.h:42
uint32_t code
The media bus format code described by this instance (MEDIA_BUS_FMT_*)
Definition v4l2_subdevice.h:47
const char * name
The format name as a human-readable string, used as the text representation of the format.
Definition v4l2_subdevice.h:46
unsigned int bitsPerPixel
The average number of bits per pixel.
Definition v4l2_subdevice.h:49
static const MediaBusFormatInfo & info(uint32_t code)
Retrieve information about a media bus format.
Definition v4l2_subdevice.cpp:830
PixelFormatInfo::ColourEncoding colourEncoding
The colour encoding type.
Definition v4l2_subdevice.h:50
Type
The format type.
Definition v4l2_subdevice.h:36
@ EmbeddedData
The format describes sensor embedded data.
Definition v4l2_subdevice.h:39
@ Image
The format describes image data.
Definition v4l2_subdevice.h:37
@ Metadata
The format describes generic metadata.
Definition v4l2_subdevice.h:38
The MediaDevice represents a Media Controller device with its full graph of connected objects.
Definition media_device.h:25
The MediaEntity represents an entity in the media graph.
Definition media_object.h:97
ColourEncoding
The colour encoding type.
Definition formats.h:23
Describe a rectangle's position and dimensions.
Definition geometry.h:241
Describe a two-dimensional size.
Definition geometry.h:51
Video stream for a camera.
Definition stream.h:76
V4L2Device(const std::string &deviceNode)
Construct a V4L2Device.
Definition v4l2_device.cpp:59
A V4L2 subdevice as exposed by the Linux kernel.
Definition v4l2_subdevice.h:75
static std::unique_ptr< V4L2Subdevice > fromEntityName(const MediaDevice *media, const std::string &entity)
Create a new video subdevice instance from entity in media device media.
Definition v4l2_subdevice.cpp:1759
int open()
Open a V4L2 subdevice.
Definition v4l2_subdevice.cpp:1129
int setSelection(unsigned int pad, unsigned int target, Rectangle *rect)
Set selection rectangle rect for target.
Definition v4l2_subdevice.h:132
std::string logPrefix() const override
Retrieve a string to be prefixed to the log message.
Definition v4l2_subdevice.cpp:1769
int setRouting(Routing *routing, Whence whence=ActiveFormat)
Set a routing table on the V4L2 subdevice.
Definition v4l2_subdevice.cpp:1633
int getSelection(unsigned int pad, unsigned int target, Rectangle *rect)
Get selection rectangle rect for target.
Definition v4l2_subdevice.h:126
int setSelection(const Stream &stream, unsigned int target, Rectangle *rect)
Set selection rectangle rect for target.
Definition v4l2_subdevice.cpp:1231
const V4L2SubdeviceCapability & caps() const
Retrieve the subdevice V4L2 capabilities.
Definition v4l2_subdevice.h:162
int getSelection(const Stream &stream, unsigned int target, Rectangle *rect)
Get selection rectangle rect for target.
Definition v4l2_subdevice.cpp:1183
std::map< unsigned int, std::vector< SizeRange > > Formats
A map of supported media bus formats to frame sizes.
Definition v4l2_subdevice.h:77
Whence
Specify the type of format for getFormat() and setFormat() operations.
Definition v4l2_subdevice.h:79
@ TryFormat
The format operation applies to TRY formats.
Definition v4l2_subdevice.h:80
@ ActiveFormat
The format operation applies to ACTIVE formats.
Definition v4l2_subdevice.h:81
Formats formats(const Stream &stream)
Enumerate all media bus codes and frame sizes on a stream.
Definition v4l2_subdevice.cpp:1285
int setFormat(unsigned int pad, V4L2SubdeviceFormat *format, Whence whence=ActiveFormat)
Set an image format on one of the V4L2 subdevice pads.
Definition v4l2_subdevice.h:152
const MediaEntity * entity() const
Retrieve the media entity associated with the subdevice.
Definition v4l2_subdevice.h:122
int setFormat(const Stream &stream, V4L2SubdeviceFormat *format, Whence whence=ActiveFormat)
Set an image format on one of the V4L2 subdevice pads.
Definition v4l2_subdevice.cpp:1407
const std::string & model()
Retrieve the model name of the device.
Definition v4l2_subdevice.cpp:1707
V4L2Subdevice(const MediaEntity *entity)
Create a V4L2 subdevice from a MediaEntity using its device node path.
Definition v4l2_subdevice.cpp:1115
int getFormat(unsigned int pad, V4L2SubdeviceFormat *format, Whence whence=ActiveFormat)
Retrieve the image format set on one of the V4L2 subdevice pads.
Definition v4l2_subdevice.h:145
std::vector< Route > Routing
V4L2 subdevice routing table.
Definition v4l2_subdevice.h:115
int getFormat(const Stream &stream, V4L2SubdeviceFormat *format, Whence whence=ActiveFormat)
Retrieve the image format set on one of the V4L2 subdevice streams.
Definition v4l2_subdevice.cpp:1360
int getRouting(Routing *routing, Whence whence=ActiveFormat)
Retrieve the subdevice's internal routing table.
Definition v4l2_subdevice.cpp:1543
Formats formats(unsigned int pad)
Enumerate all media bus codes and frame sizes on a pad.
Definition v4l2_subdevice.h:138
Class and enums to represent color spaces.
Data structures related to geometric objects.
Types and helper functions to handle libcamera image formats.
Logging infrastructure.
Provides a class hierarchy that represents the media objects exposed by the Linux kernel Media Contro...
Top-level libcamera namespace.
Definition backtrace.h:17
std::ostream & operator<<(std::ostream &out, const Point &p)
Insert a text representation of a Point into an output stream.
Definition geometry.cpp:91
struct v4l2_subdev_capability object wrapper and helpers
Definition v4l2_subdevice.h:53
bool hasStreams() const
Retrieve if a subdevice supports the V4L2 streams API.
Definition v4l2_subdevice.h:58
bool isReadOnly() const
Retrieve if a subdevice is registered as read-only.
Definition v4l2_subdevice.h:54
The V4L2 sub-device image format and sizes.
Definition v4l2_subdevice.h:64
const std::string toString() const
Assemble and return a string describing the format.
Definition v4l2_subdevice.cpp:926
Size size
The image size in pixels.
Definition v4l2_subdevice.h:66
std::optional< ColorSpace > colorSpace
The color space of the pixels.
Definition v4l2_subdevice.h:67
uint32_t code
The image format bus code.
Definition v4l2_subdevice.h:65
V4L2 subdevice routing table entry.
Definition v4l2_subdevice.h:99
Stream source
The source stream of the route.
Definition v4l2_subdevice.h:111
uint32_t flags
The route flags (V4L2_SUBDEV_ROUTE_FL_*)
Definition v4l2_subdevice.h:112
Stream sink
The sink stream of the route.
Definition v4l2_subdevice.h:110
Route()
Construct a Route with default streams.
Definition v4l2_subdevice.h:100
Route(const Stream &snk, const Stream &src, uint32_t f)
Construct a Route from sink to source.
Definition v4l2_subdevice.h:105
V4L2 subdevice stream.
Definition v4l2_subdevice.h:84
Stream(unsigned int p, unsigned int s)
Construct a Stream with a given pad and stream number.
Definition v4l2_subdevice.h:90
Stream()
Construct a Stream with pad and stream set to 0.
Definition v4l2_subdevice.h:85
unsigned int pad
The 0-indexed pad number.
Definition v4l2_subdevice.h:95
unsigned int stream
The stream number.
Definition v4l2_subdevice.h:96
Common base for V4L2 devices and subdevices.