添加FTP lib

Author: loogg

libraries/Kconfig

@@ -337,5 +337,12 @@ menu "External Libraries"
         select BSP_USING_LCD
         select RT_USING_CPLUSPLUS
         default n
+    
+    config ART_PI_USING_FTP_LIB
+        bool "Using FTP Library"
+        select RT_USING_SAL
+        select SAL_USING_POSIX
+        select RT_USING_DFS
+        default n
 
 endmenu

libraries/ftp_lib/README.md

@@ -0,0 +1,63 @@
+# 如何使用
+
+## 注意事项
+
+- 目前只提供了gcc的静态库
+- 推荐使用RT-Thread Studio开发
+
+## 快速上手
+
+1. `#include "ftp.h"`
+2. `ftp_init(2048, 27, 100);`
+3. 默认端口21，默认用户名和密码都为 loogg
+
+## API介绍
+
+1. `ftp_get_max_session_num`
+    获取最大客户端数量
+
+2. `ftp_set_max_session_num`
+    设置最大客户端数量
+
+3. `ftp_get_session_username`
+    获取客户端用户名
+
+4. `ftp_set_session_username`
+    设置客户端用户名
+
+5. `ftp_get_session_password`
+    获取客户端密码
+
+6. `ftp_set_session_password`
+    设置客户端密码
+
+7. `ftp_get_session_welcome_msg`
+    获取客户端欢迎词
+
+8. `ftp_set_session_welcome_msg`
+    设置客户端欢迎词
+
+9. `ftp_session_force_quit`
+    强制关闭所有客户端连接(异步)
+
+10. `ftp_force_restart`
+    强制重启服务器(异步)
+
+11. `ftp_get_port`
+    获取服务器监听端口
+
+12. `ftp_set_port`
+    设置服务器监听端口
+
+13. `ftp_init`
+    初始化ftp服务
+
+## 动态设置参数
+
+- 使用 `ftp_force_restart` 和 `ftp_session_force_quit`
+
+## 联系方式 & 感谢
+
+- 维护：malongwei
+- 主页：<https://github.com/loogg/ftp>
+- 邮箱：<[email protected]>

libraries/ftp_lib/SConscript

@@ -0,0 +1,15 @@
+Import('rtconfig')
+from building import *
+
+cwd = GetCurrentDir()
+src = []
+path = [cwd + '/inc']
+libs = []
+libpath = [cwd + '/libs']
+
+if rtconfig.CROSS_TOOL == 'gcc':
+    libs += ['FTP_gcc']
+
+group = DefineGroup('FTP', src, depend = ['ART_PI_USING_FTP_LIB'], CPPPATH = path, LIBS = libs, LIBPATH = libpath)
+
+Return('group')

libraries/ftp_lib/inc/ftp.h

@@ -0,0 +1,20 @@
+#ifndef __FTP_H
+#define __FTP_H
+#include <rtthread.h>
+
+int ftp_get_max_session_num(void);
+int ftp_set_max_session_num(int num);
+const char *ftp_get_session_username(void);
+int ftp_set_session_username(const char *username);
+const char *ftp_get_session_password(void);
+int ftp_set_session_password(const char *password);
+const char *ftp_get_session_welcome_msg(void);
+int ftp_set_session_welcome_msg(const char *welcome_msg);
+int ftp_session_force_quit(void);
+
+int ftp_force_restart(void);
+int ftp_get_port(void);
+int ftp_set_port(int port);
+int ftp_init(rt_uint32_t stack_size, rt_uint8_t priority, rt_uint32_t tick);
+
+#endif

libraries/ftp_lib/inc/ftp_session.h

@@ -0,0 +1,32 @@
+#ifndef __FTP_SESSION_H
+#define __FTP_SESSION_H
+#include <rtthread.h>
+#include <rtdevice.h>
+#include <rthw.h>
+
+enum ftp_session_state
+{
+    FTP_SESSION_STATE_USER = 0,
+    FTP_SESSION_STATE_PASSWD,
+    FTP_SESSION_STATE_PROCESS
+};
+
+struct ftp_session
+{
+    int fd;
+    int port_pasv_fd;
+    int is_anonymous;
+    int offset;
+    struct sockaddr_in remote;
+    enum ftp_session_state state;
+    char currentdir[256];
+    rt_uint8_t force_quit;
+    rt_tick_t tick_timeout;
+    rt_slist_t slist;
+};
+
+
+int ftp_session_create(int fd, struct sockaddr_in *addr, socklen_t addr_len);
+int ftp_session_force_quit(void);
+
+#endif

libraries/ftp_lib/inc/ftp_session_cmd.h

@@ -0,0 +1,16 @@
+#ifndef __FTP_SESSION_CMD_H
+#define __FTP_SESSION_CMD_H
+#include <rtthread.h>
+#include <rtdevice.h>
+#include <rthw.h>
+#include "ftp_session.h"
+
+struct ftp_session_cmd
+{
+    char *cmd;
+    int (*cmd_fn)(struct ftp_session *session, char *cmd, char *cmd_param);
+};
+
+int ftp_session_cmd_process(struct ftp_session *session, char *cmd, char *cmd_param);
+
+#endif