diff --git a/docs/Application_guide/en/hardware/audio-driver.md b/docs/Application_guide/en/hardware/audio-driver.md index d3c384a7acd1e9f4965b775a809e19cb59a76c7d..8636f09c4ffa5532c70f2a1452ab63a1486ed13a 100644 --- a/docs/Application_guide/en/hardware/audio-driver.md +++ b/docs/Application_guide/en/hardware/audio-driver.md @@ -124,54 +124,14 @@ For more interfaces and detailed usage of recording, please refer to [Record - A ## Overview The audio calibration tool can adjust the input gain (including analog gain and ADC gain), output gain (including analog gain, DAC gain, and algorithm gain), and sidetone gain of the built-in codec. The validation modes include real-time mode and non-real-time mode, which can be controlled via APIs. In the non-real-time mode, the adjusted parameters will take effect in the next playback/call. The tool can be adapted to various application scenarios and various input/output channels. After adjusting the audio parameters with the audio tool, they can be directly fixed in the NV file as the default audio parameters. -## Platform Support and Tool Applicability +## Obtain NV Files and Usage Methods -### ASR Platform +**Obtain NV Files:** -Currently, the ASR platform can calibrate audio parameters through the CAT-Audio tool in the CATStudio software. The main functionalities include: +Please contact Quectel technical support for assistance. -- **Audio Path Calibration**: It allows setting the gain at different volume levels. - - CAT-Audio's audio path includes the ability to modify *audio_gain.nvm* and send **AT*NVMFLUSH=1** commands. After modifying all the gains, to save the changes to flash, right-click on "**Profiles**" and select one of the three options: - - - "Save Gain to NVM": Saves the modifications to NVM, which takes effect immediately and the configuration is saved even after restarting. - - "Create Default NVMs": Restores the original NVM if the parameters are not saved to NVM. - - "Reload NVM files": Retrieves the original NVM from the CP. - -- **Call Recording and Playback**: Click the icon of "track view"to display the track view interface. - - - - In the VE topology, select the link where the recording is needed. - - - - Click the red circular button to start real-time recording, and the real-time waveform can be seen in the track view. - - - - - -- **Speech Enhancement Audio Calibration**: The speech enhancement topology provides control over all speech enhancement modules. It supports enabling or disabling each module and setting parameters within the modules. - - - -### Unisoc Platform - -The Unisoc platform uses the AudioCalibrator software for audio parameter calibration. The main codec parameters include: - -**Built-in Codec Input Gain (atctst_aud_codec_get_ingain)**: - -The input gain refers to the microphone gain in call mode, which cannot be adjusted in music playback mode. The analog gain and adc gain can be modified as shown in the following figure. The analog gain range varies for different channels, while the adc gain range remains the same. The value should not be too large, or else input distortion may occur. - - - -**Built-in Codec Output Gain (atctst_aud_codec_get_outgain)**: - -The output gain can be adjusted in both call mode and music playback mode. The output gain is related to the volume level and currently supports 0–11 levels, corresponding to outGains[0] to outGains[11] in the gain list. To readjust the volume gain, the corresponding dac, ana, and alg gains can be adjusted. Setting alg to the minimum achieves mute. It is not recommended to set the dac value higher than 63 because it may cause distortion. Users can set different gain combinations based on the application scenario. It is suggested to keep ana and alg value unchanged and adjust the dac gain. - - +**Usage Methods:** -**Sidetone Gain (atctst_aud_codec_get_sidetonegain)**: +Using the QPYCom tool, after connecting the module, open the repl port,place the NV file in the 'usr' directory and restart the module to take effect.Currently, only the EC600M series, EC800M series, EC600N series, and EG810M series support this method.For other models of modules, please contact Quectel technical support team. -The sidetone gain is used in call scenarios. The sidetone is disabled by default, but it can be adjusted here if needed. \ No newline at end of file + \ No newline at end of file diff --git a/docs/Application_guide/en/media/hardware/audio-driver/NVFile1.png b/docs/Application_guide/en/media/hardware/audio-driver/NVFile1.png new file mode 100644 index 0000000000000000000000000000000000000000..fab0bcc7c73ec00b0c06ee57ea493378dd6c22db Binary files /dev/null and b/docs/Application_guide/en/media/hardware/audio-driver/NVFile1.png differ diff --git a/docs/Application_guide/zh/hardware/audio-driver.md b/docs/Application_guide/zh/hardware/audio-driver.md index 8f455f5df33ccf4eb415cc6e09095db44de20520..88f27f3d888a5c33f27b121c0fa6e8e6bcf429bf 100644 --- a/docs/Application_guide/zh/hardware/audio-driver.md +++ b/docs/Application_guide/zh/hardware/audio-driver.md @@ -145,36 +145,14 @@ TTS是Text To Speech的缩写，即文本转语音，是一种能把文字内容 ## 概述 音频校准工具可调整内置 codec 输入增益（包含模拟增益，adc增益），输出增益（包含模拟增益，dac增益，算法增益），侧音增益。生效模式分为实时生效模式，和非实时生效模式，通过 API控制。其中非实时生效模式下，调整的参数将会在下次播放/通话时才能生效。工具可适配整多种应用场景，和多种输入/输出通道。音频工具调整好参数后，可以直接固定到NV文件中，作为默认音频参数。 -## 各平台支持情况和工具适用 - -### ASR平台 -目前ASR平台可以通过CATStuido软件中的CAT-Audio工具上进行音频参数的校准。主要功能有： -- **音频通路校准** 可以设置不同音量等级下的增益。 -CAT-Audio 音频通路自带 audio_gain.nvm 的修改和 AT*NVMFLUSH=1 的发送功能。 当所有增益修改完成，需要将改动保存至 flash 时，可以鼠标选中 Profiles 右击，会弹出 3 个选项： -“Save Gain to NVM”-----将修改保存到 NVM，即时生效， 重启也能保持设定的参数值； -“Create Default NVMs”--参数没保存到 NVM 时，点击可恢复原始 NVM； -“Reload NVM files”-----从 cp 调取原始 NVM。 -- **通话录音和播放** 点击 “track view”按钮 ，界面显示 tracks view； - -在 VE 拓扑图里勾选需要 dump 录音的点； - -点击红色圆形按钮进入实时录音，在 tracks view 处可以看到实时波形； - - - -- **语音增强音频校准** 语音增强拓扑图提供对所有语音增强模块的控制。它支持打开和关闭每个模块，并可以设置模块中的参数。 - - -### 展锐平台 -展锐平台使用AudioCalibrator软件去进行音频参数的标定。 -Codec参数校主要包含： -**内置codec输入增益（atctst_aud_codec_get_ingain）**： -输入增益即通话模式下的MIC增益，该增益在音乐播放模式下不可调。如下图，可以修改模拟增益和adc增益。不同通道下的模拟增益范围不同，adc增益范围相同。值不可过大，否则会造成输入失真。 - - -**内置codec输出增益（atctst_aud_codec_get_outgain）**： -输出增益在通话模式，或者音乐播放模式下均可调。输出增益与音量等级相关，当前支持0~11级音量，分别对应增益列表中的outGains[0] ~ outGains[11]。用户若要重新调整音量增益，可以调整对应音量等级下的dac，ana与alg增益。Alg调到最小可以实现静音。DAC的值不建议超过63，易造成失真。用户可根据应用场景，设置不同的增益组合。建议可保持ana与alg不变，调整dac增益。 - - -**侧音增益（atctst_aud_codec_get_sidetonegain）**： - 侧音增益用于通话场景。侧音默认关闭，客户若需要侧音,可在此调整。 \ No newline at end of file +## NV文件的获取和使用方式 + +**获取方式：** + +​ 请联系移远技术支持获取。 + +**使用方式：** + +​ 使用QPYCom工具，连接模组之后，打开调试端口，将NV文件放入usr目录下，重启模组即可生效。目前仅EC600M系列、EC800M系列、EC600N系列、EG810M系列支持该方法，其他型号模组请联系移远技术支持。 + + \ No newline at end of file diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/NVFile1.png b/docs/Application_guide/zh/media/hardware/audio-driver/NVFile1.png new file mode 100644 index 0000000000000000000000000000000000000000..fab0bcc7c73ec00b0c06ee57ea493378dd6c22db Binary files /dev/null and b/docs/Application_guide/zh/media/hardware/audio-driver/NVFile1.png differ