// SPDX-License-Identifier: GPL-2.0-only
//
// rt-sdw-common.c
//
// Copyright(c) 2024 Realtek Semiconductor Corp.
//
/*
* This file defines common functions used with Realtek soundwire codecs .
*/
#include <linux/module.h>
#include <linux/regmap.h>
#include <linux/bitops.h>
#include <linux/soundwire/sdw_registers.h>
#include <sound/jack.h>
#include "rt-sdw-common.h"
/**
* rt_sdca_index_write - Write a value to Realtek defined register .
*
* @ map : map for setting .
* @ nid : Realtek - defined ID .
* @ reg : register .
* @ value : value .
*
* A value of zero will be returned on success , a negative errno will
* be returned in error cases .
*/
int rt_sdca_index_write(struct regmap *map, unsigned int nid,
unsigned int reg, unsigned int value)
{
unsigned int addr = (nid << 20 ) | reg;
int ret;
ret = regmap_write(map, addr, value);
if (ret < 0 )
pr_err("Failed to set value: %06x <= %04x ret=%d\n" ,
addr, value, ret);
return ret;
}
EXPORT_SYMBOL_GPL(rt_sdca_index_write);
/**
* rt_sdca_index_read - Read value from Realtek defined register .
*
* @ map : map for setting .
* @ nid : Realtek - defined ID .
* @ reg : register .
* @ value : value .
*
* A value of zero will be returned on success , a negative errno will
* be returned in error cases .
*/
int rt_sdca_index_read(struct regmap *map, unsigned int nid,
unsigned int reg, unsigned int *value)
{
unsigned int addr = (nid << 20 ) | reg;
int ret;
ret = regmap_read(map, addr, value);
if (ret < 0 )
pr_err("Failed to get value: %06x => %04x ret=%d\n" ,
addr, *value, ret);
return ret;
}
EXPORT_SYMBOL_GPL(rt_sdca_index_read);
/**
* rt_sdca_index_update_bits - Update value on Realtek defined register .
*
* @ map : map for setting .
* @ nid : Realtek - defined ID .
* @ reg : register .
* @ mask : Bitmask to change
* @ val : New value for bitmask
*
* A value of zero will be returned on success , a negative errno will
* be returned in error cases .
*/
int rt_sdca_index_update_bits(struct regmap *map,
unsigned int nid, unsigned int reg, unsigned int mask, unsigned int val)
{
unsigned int tmp;
int ret;
ret = rt_sdca_index_read(map, nid, reg, &tmp);
if (ret < 0 )
return ret;
set_mask_bits(&tmp, mask, val);
return rt_sdca_index_write(map, nid, reg, tmp);
}
EXPORT_SYMBOL_GPL(rt_sdca_index_update_bits);
/**
* rt_sdca_btn_type - Decision of button type .
*
* @ buffer : UMP message buffer .
*
* A button type will be returned regarding to buffer ,
* it returns zero if buffer cannot be recognized .
*/
int rt_sdca_btn_type(unsigned char *buffer)
{
u8 btn_type = 0 ;
int ret = 0 ;
btn_type |= buffer[0 ] & 0 xf;
btn_type |= (buffer[0 ] >> 4 ) & 0 xf;
btn_type |= buffer[1 ] & 0 xf;
btn_type |= (buffer[1 ] >> 4 ) & 0 xf;
if (btn_type & BIT(0 ))
ret |= SND_JACK_BTN_2;
if (btn_type & BIT(1 ))
ret |= SND_JACK_BTN_3;
if (btn_type & BIT(2 ))
ret |= SND_JACK_BTN_0;
if (btn_type & BIT(3 ))
ret |= SND_JACK_BTN_1;
return ret;
}
EXPORT_SYMBOL_GPL(rt_sdca_btn_type);
/**
* rt_sdca_headset_detect - Headset jack type detection .
*
* @ map : map for setting .
* @ entity_id : SDCA entity ID .
*
* A headset jack type will be returned , a negative errno will
* be returned in error cases .
*/
int rt_sdca_headset_detect(struct regmap *map, unsigned int entity_id)
{
unsigned int det_mode, jack_type;
int ret;
/* get detected_mode */
ret = regmap_read(map, SDW_SDCA_CTL(SDCA_NUM_JACK_CODEC, entity_id,
RT_SDCA_CTL_DETECTED_MODE, 0 ), &det_mode);
if (ret < 0 )
goto io_error;
switch (det_mode) {
case 0 x03:
jack_type = SND_JACK_HEADPHONE;
break ;
case 0 x05:
jack_type = SND_JACK_HEADSET;
break ;
default :
jack_type = 0 ;
break ;
}
/* write selected_mode */
if (det_mode) {
ret = regmap_write(map, SDW_SDCA_CTL(SDCA_NUM_JACK_CODEC, entity_id,
RT_SDCA_CTL_SELECTED_MODE, 0 ), det_mode);
if (ret < 0 )
goto io_error;
}
return jack_type;
io_error:
pr_err_ratelimited("IO error in %s, ret %d\n" , __func__, ret);
return ret;
}
EXPORT_SYMBOL_GPL(rt_sdca_headset_detect);
/**
* rt_sdca_button_detect - Read UMP message and decide button type .
*
* @ map : map for setting .
* @ entity_id : SDCA entity ID .
* @ hid_buf_addr : HID buffer address .
* @ hid_id : Report ID for HID .
*
* A button type will be returned regarding to buffer ,
* it returns zero if buffer cannot be recognized .
*/
int rt_sdca_button_detect(struct regmap *map, unsigned int entity_id,
unsigned int hid_buf_addr, unsigned int hid_id)
{
unsigned int btn_type = 0 , offset, idx, val, owner;
unsigned char buf[3 ];
int ret;
/* get current UMP message owner */
ret = regmap_read(map, SDW_SDCA_CTL(SDCA_NUM_HID, entity_id,
RT_SDCA_CTL_HIDTX_CURRENT_OWNER, 0 ), &owner);
if (ret < 0 )
return 0 ;
/* if owner is device then there is no button event from device */
if (owner == 1 )
return 0 ;
/* read UMP message offset */
ret = regmap_read(map, SDW_SDCA_CTL(SDCA_NUM_HID, entity_id,
RT_SDCA_CTL_HIDTX_MESSAGE_OFFSET, 0 ), &offset);
if (ret < 0 )
goto _end_btn_det_;
for (idx = 0 ; idx < sizeof (buf); idx++) {
ret = regmap_read(map, hid_buf_addr + offset + idx, &val);
if (ret < 0 )
goto _end_btn_det_;
buf[idx] = val & 0 xff;
}
/* Report ID for HID */
if (buf[0 ] == hid_id)
btn_type = rt_sdca_btn_type(&buf[1 ]);
_end_btn_det_:
/* Host is owner, so set back to device */
if (owner == 0 )
/* set owner to device */
regmap_write(map,
SDW_SDCA_CTL(SDCA_NUM_HID, entity_id,
RT_SDCA_CTL_HIDTX_CURRENT_OWNER, 0 ), 0 x01);
return btn_type;
}
EXPORT_SYMBOL_GPL(rt_sdca_button_detect);
MODULE_DESCRIPTION("Realtek soundwire common functions" );
MODULE_AUTHOR("jack yu <jack.yu@realtek.com>" );
MODULE_LICENSE("GPL" );
Messung V0.5 in Prozent C=91 H=97 G=93
¤ Dauer der Verarbeitung: 0.12 Sekunden
(vorverarbeitet am 2026-09-28)
¤
*© Formatika GbR, Deutschland