mayhem-firmware/firmware/common/wm8731.hpp
Mark Thompson ef92c5bc0a
Enhanced Debug -> Peripherals app to allow direct register modification (#1584)
* Add files via upload

* Add files via upload

* Add files via upload

* Add files via upload

* Clang

* Clang

* Tweak position of field on screen

* Reverted text on Write button per reviewer feedback
2023-11-17 12:10:11 -06:00

439 lines
12 KiB
C++

/*
* Copyright (C) 2014 Jared Boone, ShareBrained Technology, Inc.
*
* This file is part of PortaPack.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2, or (at your option)
* any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; see the file COPYING. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street,
* Boston, MA 02110-1301, USA.
*/
#ifndef __WM8731_H__
#define __WM8731_H__
#include <cstdint>
#include <array>
#include "i2c_pp.hpp"
#include "audio.hpp"
namespace wolfson {
namespace wm8731 {
enum class ADCSource {
Line = 0,
Microphone = 1,
};
using address_t = uint8_t;
using reg_t = uint16_t;
constexpr size_t reg_count = 10;
enum class Register : address_t {
LeftLineIn = 0x00,
RightLineIn = 0x01,
LeftHeadphoneOut = 0x02,
RightHeadphoneOut = 0x03,
AnalogAudioPathControl = 0x04,
DigitalAudioPathControl = 0x05,
PowerDownControl = 0x06,
DigitalAudioInterfaceFormat = 0x07,
SamplingControl = 0x08,
ActiveControl = 0x09,
};
struct LeftLineIn {
reg_t linvol : 5;
reg_t reserved0 : 2;
reg_t linmute : 1;
reg_t lrinboth : 1;
reg_t reserved1 : 7;
};
static_assert(sizeof(LeftLineIn) == sizeof(reg_t), "LeftLineIn type wrong size");
struct RightLineIn {
reg_t rinvol : 5;
reg_t reserved0 : 2;
reg_t rinmute : 1;
reg_t rlinboth : 1;
reg_t reserved1 : 7;
};
static_assert(sizeof(RightLineIn) == sizeof(reg_t), "RightLineIn type wrong size");
struct LeftHeadphoneOut {
reg_t lhpvol : 7;
reg_t lzcen : 1;
reg_t lrhpboth : 1;
reg_t reserved0 : 7;
};
static_assert(sizeof(LeftHeadphoneOut) == sizeof(reg_t), "LeftHeadphoneOut type wrong size");
struct RightHeadphoneOut {
reg_t rhpvol : 7;
reg_t rzcen : 1;
reg_t rlhpboth : 1;
reg_t reserved0 : 7;
};
static_assert(sizeof(RightHeadphoneOut) == sizeof(reg_t), "RightHeadphoneOut type wrong size");
struct AnalogAudioPathControl {
reg_t micboost : 1;
reg_t mutemic : 1;
reg_t insel : 1;
reg_t bypass : 1;
reg_t dacsel : 1;
reg_t sidetone : 1;
reg_t sideatt : 2;
reg_t reserved0 : 8;
};
static_assert(sizeof(AnalogAudioPathControl) == sizeof(reg_t), "AnalogAudioPathControl type wrong size");
struct DigitalAudioPathControl {
reg_t adchpd : 1;
reg_t deemp : 2;
reg_t dacmu : 1;
reg_t hpor : 1;
reg_t reserved0 : 11;
};
static_assert(sizeof(DigitalAudioPathControl) == sizeof(reg_t), "DigitalAudioPathControl type wrong size");
struct PowerDownControl {
reg_t lineinpd : 1;
reg_t micpd : 1;
reg_t adcpd : 1;
reg_t dacpd : 1;
reg_t outpd : 1;
reg_t oscpd : 1;
reg_t clkoutpd : 1;
reg_t poweroff : 1;
reg_t reserved0 : 8;
};
static_assert(sizeof(PowerDownControl) == sizeof(reg_t), "PowerDownControl type wrong size");
struct DigitalAudioInterfaceFormat {
reg_t format : 2;
reg_t iwl : 2;
reg_t lrp : 1;
reg_t lrswap : 1;
reg_t ms : 1;
reg_t bclkinv : 1;
reg_t reserved0 : 8;
};
static_assert(sizeof(DigitalAudioInterfaceFormat) == sizeof(reg_t), "DigitalAudioInterfaceFormat type wrong size");
struct SamplingControl {
reg_t usb_normal : 1;
reg_t bosr : 1;
reg_t sr : 4;
reg_t clkidiv2 : 1;
reg_t clkodiv2 : 1;
reg_t reserved0 : 8;
};
static_assert(sizeof(SamplingControl) == sizeof(reg_t), "SamplingControl type wrong size");
struct ActiveControl {
reg_t active : 1;
reg_t reserved0 : 15;
};
static_assert(sizeof(ActiveControl) == sizeof(reg_t), "ActiveControl type wrong size");
struct Reset {
reg_t reset : 9;
reg_t reserved0 : 7;
};
static_assert(sizeof(Reset) == sizeof(reg_t), "Reset type wrong size");
struct Register_Type {
LeftLineIn left_line_in;
RightLineIn right_line_in;
LeftHeadphoneOut left_headphone_out;
RightHeadphoneOut right_headphone_out;
AnalogAudioPathControl analog_audio_path_control;
DigitalAudioPathControl digital_audio_path_control;
PowerDownControl power_down_control;
DigitalAudioInterfaceFormat digital_audio_interface_format;
SamplingControl sampling_control;
ActiveControl active_control;
};
static_assert(sizeof(Register_Type) == reg_count * sizeof(reg_t), "Register_Type wrong size");
struct RegisterMap {
constexpr RegisterMap(
Register_Type values)
: r(values) {
}
union {
Register_Type r;
std::array<reg_t, reg_count> w;
};
};
static_assert(sizeof(RegisterMap) == reg_count * sizeof(reg_t), "RegisterMap type wrong size");
constexpr RegisterMap default_after_reset{Register_Type{
.left_line_in = {
.linvol = 0b10111,
.reserved0 = 0b00,
.linmute = 0b1,
.lrinboth = 0b0,
.reserved1 = 0,
},
.right_line_in = {
.rinvol = 0b10111,
.reserved0 = 0b00,
.rinmute = 0b1,
.rlinboth = 0b0,
.reserved1 = 0,
},
.left_headphone_out = {
.lhpvol = 0b1111001,
.lzcen = 0b0,
.lrhpboth = 0b0,
.reserved0 = 0,
},
.right_headphone_out = {
.rhpvol = 0b1111001,
.rzcen = 0b0,
.rlhpboth = 0b0,
.reserved0 = 0,
},
.analog_audio_path_control = {
.micboost = 0b0,
.mutemic = 0b1,
.insel = 0b0,
.bypass = 0b1,
.dacsel = 0b0,
.sidetone = 0b0,
.sideatt = 0b00,
.reserved0 = 0,
},
.digital_audio_path_control = {
.adchpd = 0b0,
.deemp = 0b00,
.dacmu = 0b1,
.hpor = 0b0,
.reserved0 = 0,
},
.power_down_control = {
.lineinpd = 0b1,
.micpd = 0b1,
.adcpd = 0b1,
.dacpd = 0b1,
.outpd = 0b1,
.oscpd = 0b0,
.clkoutpd = 0b0,
.poweroff = 0b1,
.reserved0 = 0,
},
.digital_audio_interface_format = {
.format = 0b10,
.iwl = 0b10,
.lrp = 0b0,
.lrswap = 0b0,
.ms = 0b0,
.bclkinv = 0b0,
.reserved0 = 0,
},
.sampling_control = {
.usb_normal = 0b0,
.bosr = 0b0,
.sr = 0b0000,
.clkidiv2 = 0b0,
.clkodiv2 = 0b0,
.reserved0 = 0,
},
.active_control = {
.active = 0b0,
.reserved0 = 0,
},
}};
class WM8731 : public audio::Codec {
public:
constexpr WM8731(
I2C& bus,
const I2C::address_t bus_address)
: bus(bus),
bus_address(bus_address) {
}
void init() override;
bool reset() override;
std::string name() const override {
return "WM8731";
}
bool detected();
void set_line_in_volume(const volume_t volume) {
const auto normalized = line_in_gain_range().normalize(volume);
auto n = normalized.centibel() / 15;
write(LeftLineIn{
.linvol = static_cast<reg_t>(n),
.reserved0 = 0,
.linmute = 0,
.lrinboth = 1,
.reserved1 = 0,
});
}
void set_wm_headphone_volume(const volume_t volume) {
const auto normalized = headphone_gain_range().normalize(volume);
auto n = normalized.centibel() / 10;
write(LeftHeadphoneOut{
.lhpvol = static_cast<reg_t>(n),
.lzcen = 0,
.lrhpboth = 1,
.reserved0 = 0,
});
}
void set_headphone_volume(const volume_t volume) override {
headphone_volume = volume;
set_wm_headphone_volume(volume);
}
volume_range_t headphone_gain_range() const override {
return {-121.0_dB, 6.0_dB};
}
volume_range_t line_in_gain_range() const {
return {-34.5_dB, 12.0_dB};
}
void headphone_mute() {
set_wm_headphone_volume(headphone_gain_range().min);
}
void headphone_enable() override {
set_wm_headphone_volume(headphone_volume);
}
void headphone_disable() override {
headphone_mute();
}
void speaker_enable(){};
void speaker_disable(){};
bool speaker_disable_supported() const override {
return false;
}
void microphone_enable(int8_t wm8731_boost_GUI, bool mic_to_HP_enabled) override {
microphone_mute(true); // c/m to reduce "plop noise" when changing wm8731_boost_GUI.
// chThdSleepMilliseconds(20); // does not help to reduce the "plop noise"
microphone_boost((wm8731_boost_GUI < 2) ? 1 : 0); // 1 = Enable Boost (+20 dBs) . 0 = Disable Boost (0dBs).
chThdSleepMilliseconds(120); // >50 msegs, very effective , >100 msegs minor improvement ,120 msegs trade off speed .
microphone_mute(false);
// (void)alc_mode; In prev. fw version , when we did not use at all param., to avoid "unused warning" when compiling.)
if (mic_to_HP_enabled)
microphone_to_HP_enable();
else
microphone_to_HP_disable();
}
void microphone_disable() override {
microphone_mute(true);
microphone_to_HP_disable();
}
void microphone_to_HP_enable() override {
map.r.analog_audio_path_control.sidetone = 1; // Side Tone Switch (Analogue) 1 = Enable Side Tone
map.r.analog_audio_path_control.sideatt = 0b00; // Side Tone Attenuation 00 = -6dB
write(Register::AnalogAudioPathControl);
headphone_enable();
}
void microphone_to_HP_disable() override {
map.r.analog_audio_path_control.sidetone = 0; // Side Tone Switch (Analogue) 0 = Disable Side Tone
map.r.analog_audio_path_control.sideatt = 0b11; // Side Tone Attenuation 11 = -15dB
write(Register::AnalogAudioPathControl);
}
void microphone_boost(const bool boost) {
map.r.analog_audio_path_control.micboost = (boost ? 1 : 0);
write(Register::AnalogAudioPathControl);
}
void microphone_mute(const bool mute) {
map.r.analog_audio_path_control.mutemic = (mute ? 1 : 0); // 1 = Enable Mute , 0 = Disable Mute
write(Register::AnalogAudioPathControl);
}
// void set_adc_source(const ADCSource adc_source) {
// map.r.analog_audio_path_control.insel = toUType(adc_source);
// write(Register::AnalogAudioPathControl);
// }
size_t reg_count() const override {
return wolfson::wm8731::reg_count;
}
size_t reg_bits() const override {
return 9;
}
uint32_t reg_read(const size_t reg_address) override;
void reg_write(const size_t reg_address, uint32_t value) override;
private:
I2C& bus;
const I2C::address_t bus_address;
RegisterMap map{default_after_reset};
volume_t headphone_volume = -60.0_dB;
void configure_interface_i2s_slave();
void configure_interface_i2s_master();
bool write(const Register reg);
bool write(const address_t reg_address, const reg_t value);
void write(const LeftLineIn value);
void write(const RightLineIn value);
void write(const LeftHeadphoneOut value);
void write(const RightHeadphoneOut value);
void write(const AnalogAudioPathControl value);
void write(const DigitalAudioPathControl value);
void write(const PowerDownControl value);
void write(const DigitalAudioInterfaceFormat value);
void write(const SamplingControl value);
void write(const ActiveControl value);
};
} /* namespace wm8731 */
} /* namespace wolfson */
#endif /*__WM8731_H__*/