STRUCT V4L2_SUBDEV_AUDIO_OPS(9)

🎧 NAME

okay bestie, this is the struct v4l2_...ev_audio_ops(9) page from the Kernel API Manual, and it's literally giving “callbacks used for audio-related settings” — the whole cute little callback crew for struct v4l2_subdev_audio_ops. no cap, that's the name vibe. 💖

📜 SYNOPSIS

struct v4l2_subdev_audio_ops {
    int (*s_clock_freq)(struct v4l2_subdev *sd, u32 freq);
    int (*s_i2s_clock_freq)(struct v4l2_subdev *sd, u32 freq);
    int (*s_routing)(struct v4l2_subdev *sd, u32 input, u32 output, u32 config);
    int (*s_stream)(struct v4l2_subdev *sd, int enable);
 };

🎤 Members

• s_clock_freq — sets the frequency (in Hz) of the audio clock output. It's used to slave an audio processor to the video decoder, ensuring that audio and video remain synchronized. The usual values for the frequency are 48000, 44100 or 32000 Hz. If the frequency is not supported, then -EINVAL is returned. ⏰
• s_i2s_clock_freq — sets I2S speed in bps. This is used to provide a standard way to select I2S clock used by driving digital audio streams at some board designs. The usual values for the frequency are 1024000 and 2048000. If the frequency is not supported, then -EINVAL is returned. 🎚️
• s_routing — used to define the input and/or output pins of an audio chip, and any additional configuration data.

⚠️ Big warning, bestie: never attempt to use user-level input IDs (e.g. Composite, S-Video, Tuner) at this level. An i2c device shouldn't know about whether an input pin is connected to a Composite connector — because on another board or platform it might be connected to something else entirely. The calling driver is responsible for mapping a user-level input to the right pins on the i2c device. 🔌

• s_stream — used to notify the audio code that stream will start or has stopped. ▶️⏹️

🌈 SEE ALSO

Here's the whole extended friend group 🫶 — every reference, no skips:

• Kernel file ./include/media/v4l2-subdev.h
• struct v4l2_decode_vbi_line(9)
• enum v4l2_subdev_io_pin_bits(9)
• struct v4l2_subdev_io_pin_config(9)
• struct v4l2_subdev_core_ops(9)
• struct v4l2_subdev_tuner_ops(9)
• struct v4l2_mbus_frame_desc_entry_csi2(9)
• enum v4l2_mbus_frame_desc_flags(9)
• struct v4l2_mbus_frame_desc_entry(9)
• enum v4l2_mbus_frame_desc_type(9)
• struct v4l2_mbus_frame_desc(9)
• enum v4l2_subdev_pre_streamon_flags(9)
• struct v4l2_subdev_video_ops(9)
• struct v4l2_subdev_vbi_ops(9)
• struct v4l2_subdev_sensor_ops(9)
• enum v4l2_subdev_ir_mode(9)
• struct v4l2_subdev_ir_parameters(9)
• struct v4l2_subdev_ir_ops(9)
• struct v4l2_subdev_pad_config(9)
• struct v4l2_subdev_stream_configs(9)
• struct v4l2_subdev_krouting(9)
• struct v4l2_subdev_state(9)
• struct v4l2_subdev_pad_ops(9)
• struct v4l2_subdev_ops(9)
• struct v4l2_subdev_internal_ops(9)
• struct v4l2_subdev_platform_data(9)
• struct v4l2_subdev(9)
• media_entity_to_v4l2_subdev(9)
• vdev_to_v4l2_subdev(9)
• struct v4l2_subdev_fh(9)
• to_v4l2_subdev_fh(9)
• v4l2_set_subdevdata(9)
• v4l2_get_subdevdata(9)
• v4l2_set_subdev_hostdata(9)
• v4l2_get_subdev_hostdata(9)
• v4l2_subdev_get_fwnode_pad_1_to_1(9)
• v4l2_subdev_link_validate_default(9)
• v4l2_subdev_link_validate(9)
• v4l2_subdev_has_pad_interdep(9)
• __v4l2_subdev_state_alloc(9)
• __v4l2_subdev_state_free(9)
• v4l2_subdev_init_finalize(9)
• v4l2_subdev_cleanup(9)
• v4l2_subdev_state_get_format(9)
• v4l2_subdev_state_get_crop(9)
• v4l2_subdev_state_get_compose(9)
• v4l2_subdev_state_get_interval(9)
• v4l2_subdev_get_fmt(9)
• v4l2_subdev_get_frame_interval(9)
• v4l2_subdev_set_routing(9)
• for_each_active_route(9)
• v4l2_subdev_set_routing_with_fmt(9)
• v4l2_subdev_routing_find_opposite_end(9)
• v4l2_subdev_state_get_opposite_stream_format(9)
• v4l2_subdev_state_xlate_streams(9)
• enum v4l2_subdev_routing_restriction(9)
• v4l2_subdev_routing_validate(9)
• v4l2_subdev_enable_streams(9)
• v4l2_subdev_disable_streams(9)
• v4l2_subdev_s_stream_helper(9)
• __v4l2_subdev_get_frame_desc_passthrough(9)
• v4l2_subdev_get_frame_desc_passthrough(9)
• v4l2_subdev_lock_state(9)
• v4l2_subdev_unlock_state(9)
• v4l2_subdev_lock_states(9)
• v4l2_subdev_unlock_states(9)
• v4l2_subdev_get_unlocked_active_state(9)
• v4l2_subdev_get_locked_active_state(9)
• v4l2_subdev_lock_and_get_active_state(9)
• v4l2_subdev_init(9)
• v4l2_subdev_call(9)
• v4l2_subdev_call_state_active(9)
• v4l2_subdev_call_state_try(9)
• v4l2_subdev_has_op(9)
• v4l2_subdev_notify_event(9)
• v4l2_subdev_is_streaming(9)

💖 cute little sign-off 💖 source/version: ./include/media · date: October 2026 · page: struct v4l2_...ev_audio_ops(9). mwah, bye bestie 🫶