/* * 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 #include #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 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(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(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__*/