first commit

README.md

@@ -0,0 +1,91 @@
+# FT6236
+
+## 简介
+
+ft6236 软件包提供了使用触摸芯片 ft6236 基本功能，并且本软件包已经对接到了 Touch 框架，通过 Touch 框架，开发者可以快速的将此触摸芯片驱动起来。
+## 支持情况
+
+| **FT6236 触摸芯片** | **支持情况** |
+| :-------: | :--------: |
+| I2C 通讯接口 | √ |
+| 中断的工作模式 |  |
+| 轮询的工作模式 | √ |
+
+## 使用说明
+
+### 软件包依赖
+
+- RT-Thread 4.0.0+
+```
+
+ \ | /
+- RT -     Thread Operating System
+ / | \     4.0.3 build Jul 23 2020
+ 2006 - 2020 Copyright by rt-thread team
+ msh >
+```
+- Touch 组件，在 menuconfig 中开启 Touch 组件的路径如下：
+```
+RT-Thread Components  --->
+    Device Drivers  --->
+        [*] Using Touch device drivers
+```
+- I2C 驱动：ft6236 设备使用 I2C 进行数据通讯，需要系统 I2C 驱动支持，在 menuconfig 中开启 I2C 驱动的路径如下：
+```
+Hardware Drivers Config  --->
+    On-chip Peripheral Drivers  --->
+        [*] Enable I2C1 BUS (software simulation)  --->
+```
+
+### 获取软件包
+
+使用 ft6236 软件包需要在 RT-Thread 的包管理中选中它，具体路径如下：
+
+```
+RT-Thread online packages  --->
+    peripheral libraries and drivers  --->
+        touch drivers  --->
+            FT6236 touch driver package.
+              Version (latest)  --->
+              [ ]   Enable 6236 example (NEW)
+```
+配置完成后，使用 `pkgs --update` 更新软件包。
+
+### 使用软件包
+
+ft6236 软件包初始化函数如下所示：
+
+```c
+int rt_hw_ft6236_init(const char *name, struct rt_touch_config *cfg)
+```
+
+该函数需要由用户调用，函数主要完成的功能有：
+
+- 设备配置和初始化（根据传入的配置信息，配置接口设备）；
+- 注册相应的传感器设备，完成 ft6236 设备的注册；
+
+#### 初始化示例
+
+```c
+
+int rt_hw_6236_init(void)
+{
+    struct rt_touch_config config;
+    config.dev_name = "i2c1";
+    
+    rt_hw_ft5426_init("touch", &config);
+    
+    return 0;
+}
+INIT_ENV_EXPORT(rt_hw_ft6236_init);
+```
+
+## 注意事项
+
+- 该软件包目前仅提供一个触点。
+- 在初始化示例中，需要根据自己板子上的实际连接情况，修改 I2C 的设备名。
+
+## 联系人信息
+
+- 维护人：[liuduanfei](https://github.com/liuduanfei) 
+- 软件包主页：<https://github.com/liuduanfei/ft6236>

SConscript

@@ -0,0 +1,20 @@
+from building import *
+Import('rtconfig')
+
+src   = []
+cwd   = GetCurrentDir()
+
+# add ft6236 src files.
+if GetDepend('PKG_USING_FT6236'):
+    src += Glob('src/ft6236.c')
+
+if GetDepend('PKG_USING_FT6236_SAMPLE'):
+    src += Glob('examples/example_ft6236.c')
+
+# add ft6236 include path.
+path  = [cwd + '/inc']
+
+# add src and include to group.
+group = DefineGroup('ft6236', src, depend = ['PKG_USING_FT6236'], CPPPATH = path)
+
+Return('group')

examples/example_ft6236.c

@@ -0,0 +1,79 @@
+
+/*
+ * Copyright (c) 2006-2020, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2019-10-19     liuduanfei   the first version
+ */
+ 
+#include <rtthread.h>
+#include <rtdevice.h>
+#include "ft6236.h"
+#include "touch.h"
+
+#define DBG_TAG "ft6236_example"
+#define DBG_LVL DBG_LOG
+#include <rtdbg.h>
+
+
+rt_thread_t ft6236_thread;
+rt_device_t touch;
+
+void ft6236_thread_entry(void *parameter)
+{
+    struct rt_touch_data *read_data;
+
+    read_data = (struct rt_touch_data *)rt_calloc(1, sizeof(struct rt_touch_data));
+
+    while(1)
+    {
+        rt_device_read(touch, 0, read_data, 1);
+
+        if (read_data->event == RT_TOUCH_EVENT_DOWN)
+        {
+            rtgui_server_post_touch(read_data->x_coordinate, read_data->y_coordinate, 1);
+        }
+
+        if (read_data->event == RT_TOUCH_EVENT_UP)
+        {
+            rtgui_server_post_touch(read_data->x_coordinate, read_data->y_coordinate, 0);
+        }
+        rt_thread_delay(10);
+    }
+
+}
+
+int ft6236_example(void)
+{
+    struct rt_touch_config cfg;
+
+    cfg.dev_name = "i2c1";
+    rt_hw_ft6236_init("touch", &cfg);
+
+    touch = rt_device_find("touch");
+
+    rt_device_open(touch, RT_DEVICE_FLAG_RDONLY);
+
+    struct rt_touch_info info;
+    rt_device_control(touch, RT_TOUCH_CTRL_GET_INFO, &info);
+    LOG_I("type       :%d", info.type);
+    LOG_I("vendor     :%d", info.vendor);
+    LOG_I("point_num  :%d", info.point_num);
+    LOG_I("range_x    :%d", info.range_x);
+    LOG_I("range_y    :%d", info.range_y);
+
+    ft6236_thread = rt_thread_create("touch", ft6236_thread_entry, RT_NULL, 800, 10, 20);
+    if (ft6236_thread == RT_NULL)
+    {
+        LOG_D("create ft6236 thread err");
+
+        return -RT_ENOMEM;
+    }
+    rt_thread_startup(ft6236_thread);
+
+    return RT_EOK;
+}
+INIT_APP_EXPORT(ft6236_example);

inc/ft236.h

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2006-2020, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2019-10-19     liuduanfei   the first version
+ */
+
+#ifndef _FT6236_H_
+#define _FT6236_H_
+
+#include "touch.h"
+
+int rt_hw_ft6236_init(const char *name, struct rt_touch_config *cfg);
+
+#endif /* _FT6236_H_ */

src/ft6236.c

@@ -0,0 +1,242 @@
+/*
+ * Copyright (c) 2006-2020, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2019-10-19     liuduanfei   the first version
+ */
+
+#include <rtthread.h>
+#include <rtdevice.h>
+#include "touch.h"
+
+
+#define DBG_TAG "ft6236"
+#define DBG_LVL DBG_LOG
+#include <rtdbg.h>
+
+/* FT6236 部分寄存器定义 */
+#define FT_DEVIDE_MODE          0x00        /* FT6236模式控制寄存器 */
+#define FT_REG_NUM_FINGER       0x02        /* 触摸状态寄存器 */
+
+#define FT_TP1_REG              0X03        /* 第一个触摸点数据地址 */
+#define FT_TP2_REG              0X09        /* 第二个触摸点数据地址 */
+#define FT_TP3_REG              0X0F        /* 第三个触摸点数据地址 */
+#define FT_TP4_REG              0X15        /* 第四个触摸点数据地址 */
+#define FT_TP5_REG              0X1B        /* 第五个触摸点数据地址 */
+
+#define FT_ID_G_LIB_VERSION     0xA1        /* 版本 */
+#define FT_ID_G_MODE            0xA4        /* FT6236中断模式控制寄存器 */
+#define FT_ID_G_THGROUP         0x80        /* 触摸有效值设置寄存器 */
+#define FT_ID_G_PERIODACTIVE    0x88        /* 激活状态周期设置寄存器 */
+#define Chip_Vendor_ID          0xA3        /* 芯片ID(0x36) */
+#define ID_G_FT6236ID           0xA8        /* 0x11 */
+
+static void ft6236_write_reg(struct rt_i2c_bus_device *bus, rt_uint8_t reg, rt_uint8_t value)
+{
+    struct rt_i2c_msg msg = {0};
+    rt_uint8_t buf[2];
+    buf[0] = reg;
+    buf[1] = value;
+
+    msg.addr = (0x38);
+    msg.flags = RT_I2C_WR;
+    msg.buf = buf;
+    msg.len = 2;
+   if (rt_i2c_transfer(bus, &msg, 1) != 1)
+   {
+       LOG_D("ft6236 write register error");
+   }
+}
+
+static void ft6236_read_reg(struct rt_i2c_bus_device *bus, rt_uint8_t reg, rt_uint8_t *buf, rt_uint8_t len)
+{
+    struct rt_i2c_msg msg = {0};
+    rt_uint8_t temp_reg;
+
+    temp_reg = reg;
+
+    msg.addr = (0x38);
+    msg.flags = RT_I2C_WR;
+    msg.buf = &temp_reg;
+    msg.len = 1;
+    if (rt_i2c_transfer(bus, &msg, 1) != 1)
+    {
+        LOG_D("ft6236 write register error");
+    }
+
+    msg.addr = (0x70>>1);
+    msg.flags = RT_I2C_RD;
+    msg.buf = buf;
+    msg.len = len;
+    if (rt_i2c_transfer(bus, &msg, 1) != 1)
+    {
+        LOG_D("ft6236 read register error");
+    }
+}
+
+#include <rtthread.h>
+#include <drv_common.h>
+
+#define REST_PIN GET_PIN(D, 3)
+static void ft6236_init(struct rt_i2c_bus_device *bus)
+{
+
+    rt_pin_mode(REST_PIN, PIN_MODE_OUTPUT);
+
+    rt_pin_write(REST_PIN, 0);
+    rt_thread_mdelay(50);
+    rt_pin_write(REST_PIN, 1);
+    rt_thread_mdelay(100);
+
+    ft6236_write_reg(bus, FT_DEVIDE_MODE, 0);
+    ft6236_write_reg(bus, FT_ID_G_THGROUP, 12);
+    ft6236_write_reg(bus, FT_ID_G_PERIODACTIVE, 12);
+}
+
+static rt_size_t ft6236_readpoint(struct rt_touch_device *touch, void *data, rt_size_t touch_num)
+{
+    rt_uint8_t buf[4];
+    struct rt_i2c_bus_device * i2c_bus = RT_NULL;
+
+    static rt_uint8_t s_tp_down = 0;
+    static uint16_t x_save, y_save;
+    static rt_uint8_t s_count = 0;
+
+    struct rt_touch_data *temp_data;
+
+    temp_data = (struct rt_touch_data *)data;
+
+    temp_data->event = RT_TOUCH_EVENT_NONE;
+    temp_data->timestamp = rt_touch_get_ts();
+
+    i2c_bus = rt_i2c_bus_device_find(touch->config.dev_name);
+    if (i2c_bus == RT_NULL)
+    {
+        LOG_D("can not find i2c bus");
+        return -RT_EIO;
+    }
+
+    ft6236_read_reg(i2c_bus, FT_TP1_REG, buf, touch_num * 4);
+
+    temp_data->x_coordinate = ((buf[0]&0X0F)<<8)+buf[1];
+    temp_data->y_coordinate = ((buf[2]&0X0F)<<8)+buf[3];
+
+    temp_data->timestamp = rt_touch_get_ts();
+
+    if ((buf[0]&0XC0)!=0X80)/* no touch */
+    {
+        if (s_tp_down == 1)
+        {
+            if (++s_count > 2)
+            {
+                s_count = 0;
+                s_tp_down = 0;
+                temp_data->event = RT_TOUCH_EVENT_UP;
+                temp_data->timestamp = rt_touch_get_ts();
+                temp_data->x_coordinate = x_save;
+                temp_data->y_coordinate = y_save;
+            }
+        }
+        return RT_EOK;
+    }
+    s_count = 0;
+
+    if (s_tp_down == 0)
+    {
+        s_tp_down = 1;
+        temp_data->event = RT_TOUCH_EVENT_DOWN;
+    }
+    else
+    {
+        temp_data->event = RT_TOUCH_EVENT_MOVE;
+    }
+    x_save = temp_data->x_coordinate;
+    y_save = temp_data->y_coordinate;
+
+    return RT_EOK;
+}
+static rt_err_t ft6236_control(struct rt_touch_device *touch, int cmd, void *arg)
+{
+    struct rt_touch_info *info;
+
+    switch(cmd)
+    {
+    case RT_TOUCH_CTRL_GET_ID:
+        break;
+    case RT_TOUCH_CTRL_GET_INFO:
+        info = (struct rt_touch_info *)arg;
+        info->point_num = touch->info.point_num;
+        info->range_x = touch->info.range_x;
+        info->range_y = touch->info.range_y;
+        info->type = touch->info.type;
+        info->vendor = touch->info.vendor;
+
+        break;
+    case RT_TOUCH_CTRL_SET_MODE:
+        break;
+    case RT_TOUCH_CTRL_SET_X_RANGE:
+        break;
+    case RT_TOUCH_CTRL_SET_Y_RANGE:
+        break;
+    case RT_TOUCH_CTRL_SET_X_TO_Y:
+        break;
+    case RT_TOUCH_CTRL_DISABLE_INT:
+        break;
+    case RT_TOUCH_CTRL_ENABLE_INT:
+        break;
+    default:
+        break;
+    }
+
+    return RT_EOK;
+}
+
+const struct rt_touch_ops ops =
+{
+    ft6236_readpoint,
+    ft6236_control,
+};
+
+struct rt_touch_info info =
+{
+    RT_TOUCH_TYPE_CAPACITANCE,
+    RT_TOUCH_VENDOR_FT,
+    1,
+    320,
+    480,
+};
+
+int rt_hw_ft6236_init(const char *name, struct rt_touch_config *cfg)
+{
+    rt_touch_t touch_device = RT_NULL;
+    struct rt_i2c_bus_device * i2c_bus = RT_NULL;
+
+    touch_device = (rt_touch_t)rt_calloc(1, sizeof(struct rt_touch_device));
+    if (touch_device == RT_NULL)
+    {
+        return -RT_ENOMEM;
+    }
+
+    i2c_bus = rt_i2c_bus_device_find(cfg->dev_name);
+    if (i2c_bus == RT_NULL)
+    {
+        return -RT_EIO;
+    }
+
+    ft6236_init(i2c_bus);
+
+    rt_memcpy(&touch_device->config, cfg, sizeof(struct rt_touch_config));
+
+    touch_device->info = info;
+    touch_device->ops = &ops;
+
+    if (rt_hw_touch_register(touch_device, name, RT_DEVICE_FLAG_RDONLY, RT_NULL) != RT_EOK)
+    {
+        return -RT_EIO;
+    }
+
+    return RT_EOK;
+}