diff --git a/docs/Application_guide/en/hardware/audio-driver.md b/docs/Application_guide/en/hardware/audio-driver.md index 7c11657e953654fefd4184943e671566fba4f028..3f7186bcc9cb229f91555742f705de227aca46d8 100644 --- a/docs/Application_guide/en/hardware/audio-driver.md +++ b/docs/Application_guide/en/hardware/audio-driver.md @@ -124,54 +124,15 @@ 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 -### ASR Platform +## **Obtain NV Files and Usage Methods** -Currently, the ASR platform can calibrate audio parameters through the CAT-Audio tool in the CATStudio software. The main functionalities include: +**Obtain NV Files:** -- **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. +Please contact Quectel technical support for assistance. - +**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/AudioCalibrator1.png b/docs/Application_guide/en/media/hardware/audio-driver/AudioCalibrator1.png deleted file mode 100644 index 350c5d92cb9aab6aa93df723242eb61a49255de8..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/AudioCalibrator1.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/AudioCalibrator2.png b/docs/Application_guide/en/media/hardware/audio-driver/AudioCalibrator2.png deleted file mode 100644 index f5bc6e9c9bfa154cd828c2ddf9373d8d2a1cc499..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/AudioCalibrator2.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio1.png b/docs/Application_guide/en/media/hardware/audio-driver/CATStudio1.png deleted file mode 100644 index 26cdb4ae1502358129d025cf325e3dfdc144dda0..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio1.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio2.png b/docs/Application_guide/en/media/hardware/audio-driver/CATStudio2.png deleted file mode 100644 index 0473559b5a6ca79a94bcc6d944d414b191e71b23..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio2.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio3.png b/docs/Application_guide/en/media/hardware/audio-driver/CATStudio3.png deleted file mode 100644 index 7f4b26318a554813f1f43a90dfa0b0a870829b51..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio3.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio4.png b/docs/Application_guide/en/media/hardware/audio-driver/CATStudio4.png deleted file mode 100644 index ef3d23f2eddf38a1ed79f484e69fcbbd3ff03977..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio4.png and /dev/null differ diff --git a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio5.png b/docs/Application_guide/en/media/hardware/audio-driver/CATStudio5.png deleted file mode 100644 index d862b20edf8c862c475943304c9d61df3d60b63b..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/en/media/hardware/audio-driver/CATStudio5.png and /dev/null differ 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..e47a09ce49f217020a8ff1262311e871fa99a52a 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 a9f416d403195d7a39b88839e7cbf2d231ecabc9..796a3240ec8aebdb4ea30450cd42f9126038f037 100644 --- a/docs/Application_guide/zh/hardware/audio-driver.md +++ b/docs/Application_guide/zh/hardware/audio-driver.md @@ -145,36 +145,15 @@ 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/AudioCalibrator1.png b/docs/Application_guide/zh/media/hardware/audio-driver/AudioCalibrator1.png deleted file mode 100644 index 350c5d92cb9aab6aa93df723242eb61a49255de8..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/AudioCalibrator1.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/AudioCalibrator2.png b/docs/Application_guide/zh/media/hardware/audio-driver/AudioCalibrator2.png deleted file mode 100644 index f5bc6e9c9bfa154cd828c2ddf9373d8d2a1cc499..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/AudioCalibrator2.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio1.png b/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio1.png deleted file mode 100644 index 26cdb4ae1502358129d025cf325e3dfdc144dda0..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio1.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio2.png b/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio2.png deleted file mode 100644 index 0473559b5a6ca79a94bcc6d944d414b191e71b23..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio2.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio3.png b/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio3.png deleted file mode 100644 index 7f4b26318a554813f1f43a90dfa0b0a870829b51..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio3.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio4.png b/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio4.png deleted file mode 100644 index ef3d23f2eddf38a1ed79f484e69fcbbd3ff03977..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio4.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio5.png b/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio5.png deleted file mode 100644 index d862b20edf8c862c475943304c9d61df3d60b63b..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/hardware/audio-driver/CATStudio5.png and /dev/null differ 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..e47a09ce49f217020a8ff1262311e871fa99a52a Binary files /dev/null and b/docs/Application_guide/zh/media/hardware/audio-driver/NVFile1.png differ diff --git a/smtp_quectel.py b/smtp_quectel.py index 9dd8cada93aa34858647e51ddb41c9481519cc32..b56b45f666ffd8913710052cb431ac8f7b73c90a 100644 Binary files a/smtp_quectel.py and b/smtp_quectel.py differ