# CC_DEMO 项目说明

## 项目概述
本项目是基于 Air780EHM/Air780EGH 的语音通信演示demo，实现了基本的语音通话功能，包括音频设备初始化、通话建立、通话管理等核心功能。

## 文件结构
- main.lua: 主程序入口，仅加载初始化模块
- audio_device.lua: 管理音频设备初始化与控制
- cc_app.lua: 实现完整通话业务逻辑
- pins_Air780EHM.json/pins_Air780EGH.json: IO复用描述文件，由LuatIO工具自动生成

## 功能说明
1. **音频设备初始化与控制**：配置并管理ES8311音频编解码芯片和扬声器功放，包括I2C、I2S接口设置及音量控制。

2. **完整通话业务逻辑处理**：实现4种通话场景，包括呼入和呼出的各种情况处理。

按照自己的通话需求启用对应的Lua文件，其余注释掉；

- (1)呼入，主动挂断（响铃3次后自动拒接）；

- (2)呼入，自动接听，接听消息识别打印，主动挂断，挂断消息识别打印；

- (3)呼入，自动接听，接听消息识别打印，等待对方挂断，挂断消息识别打印；

- (4)呼出，对方接通，接听消息识别打印，建立通话后一段时间，等待对方挂断，挂断消息识别打印；

3. **通话状态监控与日志记录**：实时记录通话状态变化及相关信息。

## 演示硬件环境
 
 Air780EHM核心板/Air780EGH核心板+AirAUDIO_1010 音频扩展板+喇叭

![alt text]( https://docs.openLuat.com/cdn/image/Air780EHM+Airaudio1010.jpg)


![alt text]( https://docs.openLuat.com/cdn/image/Air780EGH-AIRAUDIO_1010.jpg)

- 具备volte功能的电话卡插入开发板/核心板的sim卡槽

2、TYPE-C USB数据线一根
- Air780EHM核心板通过 TYPE-C USB 口供电；
- TYPE-C USB 数据线直接插到核心板的 TYPE-C USB 座子，另外一端连接电脑 USB 口；

3、可Air780EHM核心板/Air780EGH核心板和AirAudio_1010 扩展板的硬件接线方式为:
|  Air780EHM核心板/Air780EGH核心板 | AirAUDIO_1010扩展板 |
| ---------------                 | -----------------   |
| 33/I2S_MCLK                     | I2S_MCLK            |
| 30/I2S_BCK                      | I2S_BCK             |
| 31/I2S_LRCK                     | I2S_LRCK            |
| 32/I2S_DIN                      | I2S_DIN             |
| 33/I2S_DOUT                     | I2S_DOUT            |
| 67/I2C1_SCL                     | I2C_SCL             |
| 66/I2C1_SDA                     | I2C_SDA             |
| 25/GPIO26                       | PA_EN               |
| 23/GPIO2                        | 8311_EN             |
| VDD_EXT                         | VCC                 |
| GND                             | GND                 |

## 演示软件环境
1、[Luatools下载调试工具](https://docs.openluat.com/air780epm/common/Luatools/)

2、[Air780EHM V2016版本固件](https://cdn6.vue2.cn/Luat_tool_src/v2tools/LuatOS_Air780EHM/LuatOS-SoC_V2016_Air780EHM.zip)，选择支持Volte功能的1、2、13或101、102、113号固件。不同版本区别请见[Air780EHM LuatOS固件版本](https://docs.openluat.com/air780epm/luatos/firmware/version/)


 [Air780EGH V2016版本固件](https://cdn6.vue2.cn/Luat_tool_src/v2tools/LuatOS_Air780EGH/LuatOS-SoC_V2016_Air780EGH.zip)选择支持Volte功能的1、2、13或101、102、113号固件。不同版本区别参考[Air780EGH LuatOS固件版本](https://docs.openluat.com/air780egh/luatos/firmware/version/)。

3、[合宙 LuatIO 工具(GPIO 复用初始化配置)使用说明] (https://docs.openluat.com/air780epm/common/luatio/)

4、 lib 脚本文件：使用 Luatools 烧录时，勾选 添加默认 lib 选项，使用默认 lib 脚本文件；

## 相关软件资料
1、cc库   https://docs.openluat.com/osapi/core/cc/

2、exaudio - 音频扩展库  https://docs.openluat.com/osapi/ext/exaudio/

3、CC_IND -- 通话状态变化

  "READY":通话准备完成，可以拨打电话或者呼入电话了

  "INCOMINGCALL"：有电话呼入
  
  "CONNECTED"：电话已经接通

  "DISCONNECTED"：电话被对方挂断

  "SPEECH_START"：通话开始

  "MAKE_CALL_OK"：拨打电话请求成功

  "MAKE_CALL_FAILED"：拨打电话请求失败

  "ANSWER_CALL_DONE"：接听电话请求完成

  "HANGUP_CALL_DONE"：挂断电话请求完成

  "PLAY"：开始有音频输出

## 演示核心步骤
1、搭建好硬件环境

2、demo脚本代码cc_app.lua中的local TEST_PHONE_NUMBER = "139xxxxxxxx"  -- 场景4拨打的测试号码，修改为自己测试时要拨打的电话号码

3、Luatools烧录内核固件和修改后的demo脚本代码

4、烧录成功后，自动开机运行

5、运行程序，观察日志输出了解通话状态

- 场景1 呼入立即挂断

    当设备启动并初始化完成后，打印READY和电话系统初始化完成。

    当有来电时，会打印INCOMINGCALL，并开始计数响铃次数。

    响铃3次后，自动拒接来电，打印拒接来电和挂断完成。

    类似以下日志：

    ``` lua
    I/user.cc_app 通话业务逻辑模块加载完成，当前场景: 1
    I/user.exaudio_device 使用exaudio.setup初始化音频设备
    I/user.exaudio_device exaudio.setup初始化成功
    I/user.CC状态 READY
    I/user.exaudio_device 通话录音已启用
    I/user.cc_app 电话系统初始化完成
    I/user.CC状态 INCOMINGCALL
    I/user.场景1 收到来电，号码: 139XXXXXXXX 响铃次数: 1
    I/user.CC状态 INCOMINGCALL
    I/user.场景1 收到来电，号码: 139XXXXXXXX 响铃次数: 2
    I/user.CC状态 INCOMINGCALL
    I/user.场景1 收到来电，号码: 139XXXXXXXX 响铃次数: 3
    I/user.场景1 拒接来电
    I/user.CC状态 HANGUP_CALL_DONE
    I/user.场景1 挂断完成
    ``` 
- 场景2 呼入自动接听+10秒后主动挂断

    来电响铃2次后自动接听，通话建立10秒后设备会自动挂断。通话期间持续进行双向录音。

    类似以下日志：

    ``` lua
    I/user.cc_app 通话业务逻辑模块加载完成，当前场景: 2
    I/user.exaudio_device 使用exaudio.setup初始化音频设备
    I/user.exaudio_device exaudio.setup初始化成功
    I/user.CC状态 READY
    I/user.exaudio_device 通话录音已启用
    I/user.cc_app 电话系统初始化完成
    I/user.CC状态 PLAY
    I/user.CC状态 INCOMINGCALL   
    I/user.场景2 收到来电，号码: 139xxxxxxxx 响铃次数: 1  
    I/user.场景2 收到来电，号码: 139xxxxxxxx 响铃次数: 2  
    I/user.场景2 自动接听来电   
    I/user.场景2 接听完成，等待通话建立             
    I/user.场景2 通话已建立，开始计时  
    I/user.场景2 10秒挂断定时器创建成功，ID: 2097153
    I/user.录音 上行数据，位于缓存 1 缓存1数据量 6400 缓存2数据量 0
    I/user.通话质量 2
    I/user.CC状态 DISCONNECTED
    I/user.场景2 10秒通话结束，主动挂断  
    I/user.场景2 已取消挂断定时器 
    
           
- 场景3 呼入自动接听+等待对方挂断

    呼入主动接听并等待对方主动挂断。通话期间持续进行双向录音。
    
    类似以下日志：

  ``` lua
    I/user.cc_app 通话业务逻辑模块加载完成，当前场景: 3
    I/user.exaudio_device 使用exaudio.setup初始化音频设备
    I/user.exaudio_device exaudio.setup初始化成功
    I/user.CC状态 READY
    I/user.exaudio_device 通话录音已启用
    I/user.cc_app 电话系统初始化完成
    I/user.CC状态 PLAY
    I/user.CC状态 INCOMINGCALL   
    I/user.场景2 收到来电，号码: 139xxxxxxxx 响铃次数: 1  
    I/user.场景2 收到来电，号码: 139xxxxxxxx 响铃次数: 2  
    I/user.场景2 自动接听来电  
    I/user.场景3 电话已接通，电话号码: 139xxxxxxxx
    I/user.录音 上行数据，位于缓存 1 缓存1数据量 6400 缓存2数据量 0
    I/user.通话质量 2
    I/user.CC状态 DISCONNECTED
    I/user.场景3 通话结束对方挂断

- 场景4 主动呼出预设号码并等待对方挂断。
  
  类似以下效果：

  ``` lua
   I/user.cc_app 通话业务逻辑模块加载完成，当前场景: 4
   I/user.exaudio_device 使用exaudio.setup初始化音频设备
   I/user.exaudio_device exaudio.setup初始化成功
   I/user.CC状态 READY
   I/user.exaudio_device 通话录音已启用
   I/user.cc_app 电话系统初始化完成
   I/user.场景4 开始拨打 139xxxxxxxx
   I/user.CC状态 MAKE_CALL_OK
   I/user.CC状态 PLAY
   I/user.录音 上行数据，位于缓存 1 缓存1数据量 6400 缓存2数据量 0
   I/user.通话质量 2
   I/user.CC状态 DISCONNECTED
   I/user.场景4 通话结束（对方挂断）