双轴按键摇杆模块 | 立创开发板技术文档中心

双轴按键游戏摇杆模块,采用 PS2游戏手柄上金属按键摇杆电位器。模块特设二路模拟输出和一路数字输出接口、输出值分别对应（X、Y）双轴偏移量、其类型为模拟量、按键表示用户是否在Z轴上按下、其类型为数字开关量、用其可以轻松控制物体,在二维空间运动、因此可以通控制器编程、传感器扩展板插接、完成具有创意性遥控互动作品。

一、模块来源

采购链接：

双轴按键摇杆传感器游戏摇杆控制杆模块电子积木

二、规格参数

驱动电压：3.3V~5V

控制方式：ADC+GPIO

以上信息见厂家资料文件

三、移植过程

我们的目标是将例程移植至开发板上【能够控制电机旋转速度的功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。

1、查看资料

输出信号:模块特设二路模拟输出(VRX，VRY)和一路数字输出接口(SW)，二路模拟输出值分别对应(X,Y)双轴偏移量，其类型为模拟量；按键表示用户是否在Z轴上按下，其类型为数字开关量。

十字摇杆为一个双向的10K电阻器,随着摇杆方向不同，抽头的阻值随着变化。本模块如果使用5V供电，原始状态下X，Y读出电压为2.5V左右，当随箭头方向按下，读出电压值减少，限小为0V。

2、引脚选择

模块	开发板
GND	GND
+5V	3V3
VRX	P000
VRY	P001
SW	P408

3、图形化配置

打开图形化界面：

设置 Pin:

设置 ADC：

Ctrl + S 保存！
点击右上角 Generate Project Content 生成代码。

4、代码编写

新建两个文件 bsp_rock.c 和 bsp_rock.h，并且将头文件路径添加到编译器中。

新建文件以及添加头文件路径到编译器，在 DHT11章节 已经讲过了，可以移步进行查看。

DHT11章节跳转 : （点击跳转🚀）

在文件 bsp_rock.c 和 bsp_rock.h 中，编写如下代码。

bsp_rock.hbsp_rock.c

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#ifndef BSP_CODE_BSP_ROCK_H_
#define BSP_CODE_BSP_ROCK_H_

#include "hal_data.h"
#include <stdio.h>

#ifndef delay_ms
#define delay_ms(x)   R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_1ms
#define delay_1ms(x)  R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_us
#define delay_us(x)   R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif
#ifndef delay_1us
#define delay_1us(x)  R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif

#ifndef u8
#define u8  uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef u32
#define u32 uint32_t
#endif

#define BSP_ADC_X_CHANNEL     ADC_CHANNEL_0
#define BSP_ADC_Y_CHANNEL     ADC_CHANNEL_1

/* SW 引脚 */
#define BSP_SW_GPIO_PIN       BSP_IO_PORT_04_PIN_08

/* 读取按键状态 */
static inline bsp_io_level_t GET_SW(void) {
    bsp_io_level_t p_pin_value;
    fsp_err_t err = R_IOPORT_PinRead(&g_ioport_ctrl, BSP_SW_GPIO_PIN, &p_pin_value);
    if(err != FSP_SUCCESS)
    {
        printf("GPIO Input Read Failed!!\r\n");
    }
    return p_pin_value;
}


// 采样次数
#define SAMPLES   5

void Joystick_Init(void);
int Get_Joystick_Percentage_value(uint8_t dir);
uint8_t Get_SW_state(void);

#endif /* BSP_CODE_BSP_ROCK_H_ */

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#include "bsp_rock.h"
#include "stdio.h"

// ADC Scan complete flag
volatile bool adc_flag = false;

/* ADC callback */
void adc_callback(adc_callback_args_t *p_args)
{
    FSP_PARAMETER_NOT_USED(p_args);
    adc_flag = true;
}

/**********************************************************
 * 函 数 名 称：ADC_GET
 * 函 数 功 能：读取一次ADC数据
 * 传 入 参 数：CHx:读取通道是X还是Y
 * 函 数 返 回：无
 * 作       者：LCKFB
 * 备       注：LP
**********************************************************/
static int ADC_GET(uint8_t CHx)
{
    int gAdcResult = 0;
    int timeOut = 1000;
    fsp_err_t err = FSP_SUCCESS;

    // 启动ADC扫描
    err = R_ADC_ScanStart(&g_adc0_ctrl);
    if (FSP_SUCCESS != err) {
        printf("ADC扫描启动失败! \n");
        return 9999;  // 返回错误值
    }

    // 等待ADC总线处理完成
    while(!adc_flag && timeOut--) { delay_us(1); }

    // 清除ADC采样完成标志位
    adc_flag = false;

    if(!timeOut) {
        printf("ADC_GET Failed!!!\r\n");
        return 0;
    }

    if(CHx == 0){ // x通道

        // 读取ADC数据
        err = R_ADC_Read(&g_adc0_ctrl, BSP_ADC_X_CHANNEL, (uint16_t *)&gAdcResult);

    }else if(CHx == 1){ // y通道

        // 读取ADC数据
        err = R_ADC_Read(&g_adc0_ctrl, BSP_ADC_Y_CHANNEL, (uint16_t *)&gAdcResult);

    }else{

        printf("\r\nCHx Error!!\r\n");
        return 1;
    }

    if (FSP_SUCCESS != err) {
        printf("ADC Read Failed!\n");
        return 9999;  // 返回错误值
    }

    // printf("gAdcResult = %d\r\n",gAdcResult);

    return gAdcResult;
}


/******************************************************************
 * 函 数 名 称：Get_Adc_Joystick_Value
 * 函 数 说 明：对保存的数据进行平均值计算后输出
 * 函 数 形 参：CHx 那个通道值
 * 函 数 返 回：对应扫描的ADC值
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
int Get_Adc_Joystick_Value(uint8_t CHx)
{
    int Data = 0;
    int i;

    for(i = 0; i < SAMPLES; i++)
    {
        Data += ADC_GET(CHx);

        delay_ms(10);
    }

    Data = Data / SAMPLES;

    return Data;
}

/******************************************************************
 * 函 数 名 称：Get_MQ2_Percentage_value
 * 函 数 说 明：读取摇杆值，并且返回百分比
 * 函 数 形 参：0=读取摇杆左右值，1=读取摇杆上下值
 * 函 数 返 回：返回百分比
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
int Get_Joystick_Percentage_value(uint8_t dir)
{
    int adc_new = 0;
    int Percentage_value = 0;

    if( dir == 0 )
    {
        adc_new = Get_Adc_Joystick_Value(0); // 通道0：X的值
    }
    else if( dir == 1 )
    {
        adc_new = Get_Adc_Joystick_Value(1); // 通道1：Y的值
    }
    else
    {
        printf("\nCH Error!!\r\n");
    }

    Percentage_value = (uint16_t)(((float)adc_new/4095.0f) * 100.f);
    return Percentage_value;
}

/******************************************************************
 * 函 数 名 称：Get_SW_state
 * 函 数 说 明：读取摇杆是否有按下
 * 函 数 形 参：无
 * 函 数 返 回：0摇杆被按下   1摇杆没有按下
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
uint8_t Get_SW_state(void)
{
    //如果被按下
    if( GET_SW() == 0 )
    {
        return 0;
    }
    else
    {
        return 1;
    }
}

/******************************************************************
 * 函 数 名 称：Joystick_Init
 * 函 数 说 明：初始化摇杆
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
void Joystick_Init(void)
{
    fsp_err_t err = FSP_SUCCESS;

    // 打开ADC设备
    err = R_ADC_Open(&g_adc0_ctrl, &g_adc0_cfg);
    if (FSP_SUCCESS != err) {
        printf("ADC Open Failed! \n");
        return;
    }

    // 配置ADC扫描
    err = R_ADC_ScanCfg(&g_adc0_ctrl, &g_adc0_channel_cfg);
    if (FSP_SUCCESS != err) {
        printf("ADC Scan Config Failed! \n");
        R_ADC_Close(&g_adc0_ctrl);  // 关闭已打开的ADC
        return;
    }

    delay_1ms(100); // 等待ADC稳定
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187

四、移植验证

在 src\Applay\app.c 中输入代码如下:

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#include "app.h"
#include "stdio.h"

#include "bsp_uart.h"
#include "bsp_rock.h"
/******************************************************************
 * 函 数 名 称：led_blink
 * 函 数 说 明：该函数用于控制LED灯的闪烁效果
 *             运行时，LED灯每隔500毫秒闪烁一次
 *             完整运行此函数需要1s时间
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
static void led_blink(void)
{
    /* Set the pin to low */
    R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_LOW);

    /* Delay for 500 milliseconds */
    R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);

    /* Set the pin to high */
    R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_HIGH);

    /* Delay for another 500 milliseconds */
    R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);
}


/******************************************************************
 * 函 数 名 称：Run
 * 函 数 说 明：该函数是用户自定义的入口函数，等效于 main_app() 函数。
 *             在此函数中可以编写用户的应用逻辑代码。
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Run(void)
{
    /* 初始化调试串口 */
    /* | RX:P100 | TX:P101 | */
    UART0_Debug_Init();

    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");
    printf("\r\n=== Welcome to use the DQX-R7FA6E2BB3CNE development board ====\r\n");
    printf("\r\n======================= www.lckfb.com =========================\r\n");
    printf("\r\n======================= wiki.lckfb.com ========================\r\n");
    printf("\r\n======================= [Debug Uart0] =========================\r\n");
    printf("\r\n=================== | RX:P100 | TX:P101 | =====================\r\n");
    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");

    Joystick_Init();
    printf("\r\nJoystick Init OK!!\r\n");

    while(1)
    {
        if( Get_SW_state() == 0 )
        {
            printf("\r\nKey SW Down!!\r\n");
        }
        printf("\r\n");
        printf("X = [%d]\r\n",Get_Joystick_Percentage_value(0));
        printf("Y = [%d]\r\n",Get_Joystick_Percentage_value(1));
        printf("\r\n");

        delay_1ms(100);
    }
}

编译烧录。

【代码下载】

跳转去下载模块移植代码：【点击跳转🚀】

常见模块移植手册

显示类

传感器类

控制类

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、图形化配置

4、代码编写

四、移植验证

​

一、模块来源 ​

二、规格参数 ​

三、移植过程 ​

1、查看资料 ​

2、引脚选择 ​

3、图形化配置 ​

4、代码编写 ​

四、移植验证 ​

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、图形化配置

4、代码编写

四、移植验证