freeswitch新增模块

概述

freeswitch的架构由稳定的核心模块和大量的外围插件式模块组成。核心模块保持稳定，外围模块可以动态的加载/卸载，非常灵活方便。

外围模块通过核心提供的 Public API与核心进行通信，而核心则通过回调机制执行外围模块中的代码。

FS Core 是FreeSWITCH 的核心，它包含了关键的数据结构和复杂的代码，但这些代码只出现在核心中，并保持了最大限度的重用。核心代码都经过精心的编码和严格的测试，最大限度地保持了系统整体的稳定。

核心代码保持了最高度的抽象，因而它可以调用不同功能，不同协议的模块。同时，良好的API 也使得编写不同的外围模块非常容易。

下面我们来尝试开发一个新的外围模块，并由freeswitch启动、加载、测试。

开发环境

centos：CentOSrelease 7.0 (Final)或以上版本

freeswitch：v1.8.7

GCC：4.8.5

新增模块

新建目录$(top_srcdir)/src/mod/applications/mod_task

新建文件$(top_srcdir)/src/mod/applications/mod_task/Makefile.am

              $(top_srcdir)/src/mod/applications/mod_task/mod_task.c

目录结构如下

# tree mod_task/
mod_task/
├── Makefile.am
└── mod_task.c

Makefile.am内容如下： 

include $(top_srcdir)/build/modmake.rulesam
MODNAME=mod_task

mod_LTLIBRARIES = mod_task.la
mod_task_la_SOURCES  = mod_task.c
mod_task_la_CFLAGS   = $(AM_CFLAGS)
mod_task_la_LIBADD   = $(switch_builddir)/libfreeswitch.la
mod_task_la_LDFLAGS  = -avoid-version -module -no-undefined –shared

mod_task.c内容如下：

SWITCH_MODULE_LOAD_FUNCTION(mod_task_load);
SWITCH_MODULE_SHUTDOWN_FUNCTION(mod_task_shutdown);
SWITCH_MODULE_DEFINITION(mod_task, mod_task_load, mod_task_shutdown, NULL);

SWITCH_MODULE_LOAD_FUNCTION(mod_task_load)
{
    *module_interface = switch_loadable_module_create_module_interface(pool, modname);

  switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO, 
            "mod_task_load start\n");
    return SWITCH_STATUS_SUCCESS;
}

SWITCH_MODULE_SHUTDOWN_FUNCTION(mod_task_shutdown)
{
  switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO, 
            "mod_task_shutdown stop\n");
  return SWITCH_STATUS_SUCCESS;
}

编译安装

修改$(top_srcdir)/configure.ac 文件，mod_task为新增行，注意行前的空格要复制已有行的

…
    src/mod/applications/mod_voicemail_ivr/Makefile
    src/mod/applications/mod_task/Makefile
…

重新配置编译freeswitch项目

cd $(top_srcdir)
./bootstrap.sh 
./configure
make
make install

编译过程中常见问题就是缺少依赖库，根据提示查找安装即可

安装成功后，我们可以在freeswitch的默认安装目录下找到mod_task.so文件

cd /usr/local/freeswitch/mod/
-rwxr-xr-x. 1 root root   48808 8月  17 11:30 mod_task.so
-rwxr-xr-x. 1 root root    1329 8月  17 11:30 mod_task.la

配置启动

启动freeswitch

cd /usr/local/freeswitch/bin/
./freeswitch –nonat

freeswitch启动成功后，在freeswitch命令行中输入API命令：

freeswitch@localhost.localdomain> load mod_task
2021-08-17 14:18:32.614059 [INFO] mod_enum.c:882 ENUM Reloaded
2021-08-17 14:18:32.614059 [INFO] mod_task.c:56 mod_task_load start
2021-08-17 14:18:32.614059 [CONSOLE] switch_loadable_module.c:1540 Successfully Loaded [mod_task]

+OK Reloading XML
+OK

freeswitch@localhost.localdomain> module_exists mod_task

true
freeswitch@localhost.localdomain> unload mod_task
2021-08-17 14:18:55.434095 [CONSOLE] switch_loadable_module.c:2014 Stopping: mod_task
2021-08-17 14:18:55.434095 [INFO] mod_task.c:99 mod_task_shutdown stop
2021-08-17 14:18:55.434095 [CONSOLE] switch_loadable_module.c:2034 mod_task unloaded.

+OK

freeswitch@localhost.localdomain>

好了，今天我们的freeswitch新增模块就完成了

---

空空如常

求真得真