16#include <linux/videodev2.h>
20#include <libcamera/base/span.h>
36 bool isOpen()
const {
return fd_.isValid(); }
43 const struct v4l2_query_ext_ctrl *
controlInfo(uint32_t
id)
const;
45 const std::string &
deviceNode()
const {
return deviceNode_; }
58 int open(
unsigned int flags);
61 int ioctl(
unsigned long request,
void *argp);
63 int fd()
const {
return fd_.get(); }
66 static std::optional<ColorSpace>
toColorSpace(
const T &v4l2Format,
70 static int fromColorSpace(
const std::optional<ColorSpace> &colorSpace, T &v4l2Format);
74 static std::unique_ptr<ControlId> v4l2ControlId(
const v4l2_query_ext_ctrl &ctrl);
75 std::optional<ControlInfo> v4l2ControlInfo(
const v4l2_query_ext_ctrl &ctrl);
76 std::optional<ControlInfo> v4l2MenuControlInfo(
const v4l2_query_ext_ctrl &ctrl);
80 Span<const v4l2_ext_control> v4l2Ctrls);
82 void eventAvailable();
84 std::map<unsigned int, struct v4l2_query_ext_ctrl> controlInfo_;
85 std::vector<std::unique_ptr<ControlId>> controlIds_;
88 std::string deviceNode_;
92 bool frameStartEnabled_;
A map of ControlId to ControlInfo.
Definition controls.h:367
Associate a list of ControlId with their values for an object.
Definition controls.h:411
Notify of activity on a file descriptor.
Definition event_notifier.h:20
Base class to support log message extensions.
Definition log.h:92
Generic signal and slot communication mechanism.
Definition signal.h:39
unique_ptr-like wrapper for a file descriptor
Definition unique_fd.h:17
~V4L2Device()
Destroy a V4L2Device.
Definition v4l2_device.cpp:68
Signal< uint32_t > frameStart
A Signal emitted when capture of a frame has started.
Definition v4l2_device.h:50
int setFrameStartEnabled(bool enable)
Enable or disable frame start event notification.
Definition v4l2_device.cpp:483
int ioctl(unsigned long request, void *argp)
Perform an IOCTL system call on the device node.
Definition v4l2_device.cpp:514
static int fromColorSpace(const std::optional< ColorSpace > &colorSpace, T &v4l2Format)
Fill in the color space fields of a V4L2 format from a ColorSpace.
Definition v4l2_device.cpp:1012
const ControlInfoMap & controls() const
Retrieve the supported V4L2 controls and their information.
Definition v4l2_device.h:38
void close()
Close the device node.
Definition v4l2_device.cpp:140
void updateControlInfo()
Update the information for all device controls.
Definition v4l2_device.cpp:759
int open(unsigned int flags)
Open a V4L2 device node.
Definition v4l2_device.cpp:81
bool supportsFrameStartEvent()
Check if frame start event is supported.
Definition v4l2_device.cpp:461
std::string devicePath() const
Retrieve the device path in sysfs.
Definition v4l2_device.cpp:435
const std::string & deviceNode() const
Retrieve the device node path.
Definition v4l2_device.h:45
ControlList getControls(const std::vector< uint32_t > &ids)
Read controls from the device.
Definition v4l2_device.cpp:177
int fd() const
Retrieve the V4L2 device file descriptor.
Definition v4l2_device.h:63
int setControls(ControlList *ctrls)
Write controls to the device.
Definition v4l2_device.cpp:295
int setFd(UniqueFD fd)
Set the file descriptor of a V4L2 device.
Definition v4l2_device.cpp:119
static std::optional< ColorSpace > toColorSpace(const T &v4l2Format, PixelFormatInfo::ColourEncoding colourEncoding)
Convert the color space fields in a V4L2 format to a ColorSpace.
Definition v4l2_device.cpp:933
const struct v4l2_query_ext_ctrl * controlInfo(uint32_t id) const
Retrieve the v4l2_query_ext_ctrl information for the given control.
Definition v4l2_device.cpp:415
V4L2Device(const std::string &deviceNode)
Construct a V4L2Device.
Definition v4l2_device.cpp:59
bool isOpen() const
Check if the V4L2 device node is open.
Definition v4l2_device.h:36
Class and enums to represent color spaces.
Framework to manage controls related to an object.
Top-level libcamera namespace.
Definition backtrace.h:17
ControlType
Define the data type of a Control.
Definition controls.h:29
std::unordered_map< unsigned int, const ControlId * > ControlIdMap
A map of numerical control ID to ControlId.
Definition controls.h:364
Signal & slot implementation.
File descriptor wrapper that owns a file descriptor.