将多方向控制集成到您的项目中,使其成为紧凑且高效的用户界面设计的理想选择
A
A
硬件概览
它是如何工作的?
Joystick 4 Click 基于 TE Connectivity 的 ALCOSWITCH 系列 2434804-1 五向触觉开关。该触觉开关具有延伸的顶部执行器,能够实现精确可靠的输入检测。采用不锈钢触点基座和银触点镀层制造,确保耐久性和抗腐蚀性,提供 100,000 次操作周期的使用寿命。其低调设计使得开关能够处理 50mA 的接触电流额定值,并且通常可以在 12VDC 的电压下工作。这些触觉开关由于其高可靠性而成为提供触觉反馈的关键部件,广泛应用于各种设备中,包括便携设备、仪器、安全系统、游戏控制台、遥控器和手持设备。Joystick 4 Click 利用这些特性,提供精确和响应迅速的输入控制,使其成为需要可靠触觉反馈的互动
项目的理想选择。无论是设计游戏控制器还是为便携设备开发用户界面,此板都提供了最便捷集成所需的功能和耐用性。此 Click board™ 采用支持新推出的 MIKROE 功能“Click Snap”的独特格式设计。与标准化版本的 Click boards 不同,此功能使主要传感器区域可以通过折断 PCB 变为可移动,开辟了许多新的实现可能性。由于 Snap 功能,开关可以通过直接访问标记为 1-8 的引脚信号自主运行。此外,Snap 部分包括指定和固定的螺孔位置,使用户能够在所需位置固定 Snap 板。Joystick 4 Click 通过 TCA6408A 端口扩展器使用 I2C 接口与主机 MCU 通信。此端口扩展器使触觉开关及其相关控制信号得以控制,包括用
于检测摇杆移动的专用信号。当触觉开关激活时,它会向主机 MCU 提供中断信号(INT),确保对用户输入的即时响应。除了 I2C 接口引脚外,端口扩展器还使用复位(RST)引脚,并包括一个用于选择 I2C 地址的跳线,标记为 ADDR SEL。此 Click board™ 可以通过 VCC SEL 跳线选择使用 3.3V 或 5V 逻辑电压水平。因此,3.3V 和 5V 兼容的 MCU 都可以正确使用通信线路。此外,这款 Click board™ 配备了包含易用功能的库和示例代码,可作为进一步开发的参考。
功能概述
开发板
Clicker 2 for Kinetis 是一款紧凑型入门开发板,它将 Click 板™的灵活性带给您喜爱的微控制器,使其成为实现您想法的完美入门套件。它配备了一款板载 32 位 ARM Cortex-M4F 微控制器,NXP 半导体公司的 MK64FN1M0VDC12,两个 mikroBUS™ 插槽用于 Click 板™连接,一个 USB 连接器,LED 指示灯,按钮,一个 JTAG 程序员连接器以及两个 26 针头用于与外部电子设备的接口。其紧凑的设计和清晰、易识别的丝网标记让您能够迅速构建具有独特功能和特性
的小工具。Clicker 2 for Kinetis 开发套件的每个部分 都包含了使同一板块运行最高效的必要组件。除了可以选择 Clicker 2 for Kinetis 的编程方式,使用 USB HID mikroBootloader 或外部 mikroProg 连接器进行 Kinetis 编程外,Clicker 2 板还包括一个干净且调节过的开发套件电源供应模块。它提供了两种供电方式;通过 USB Micro-B 电缆,其中板载电压调节器为板上每个组件提供适当的电压水平,或使用锂聚合物 电池通过板载电池连接器供电。所有 mikroBUS™ 本
身支持的通信方法都在这块板上,包括已经建立良好的 mikroBUS™ 插槽、重置按钮和几个用户可配置的按钮及 LED 指示灯。Clicker 2 for Kinetis 是 Mikroe 生态系统的一个组成部分,允许您在几分钟内创建新的应用程序。它由 Mikroe 软件工具原生支持,得益于大量不同的 Click 板™(超过一千块板),其数量每天都在增长,它涵盖了原型制作的许多方面。
微控制器概述
MCU卡片 / MCU
建筑
ARM Cortex-M4
MCU 内存 (KB)
1024
硅供应商
NXP
引脚数
121
RAM (字节)
262144
使用的MCU引脚
mikroBUS™映射器
“仔细看看!”
原理图
一步一步来
项目组装
实时跟踪您的结果
通过调试模式的应用程序输出
1. 一旦代码示例加载完成,按下 "DEBUG" 按钮将启动构建过程,并将其编程到创建的设置上,然后进入调试模式。
2. 编程完成后,IDE 中将出现一个带有各种操作按钮的标题。点击绿色的 "PLAY" 按钮开始读取通过 Click board™ 获得的结果。获得的结果将在 "Application Output" 标签中显示。
软件支持
库描述
该库包含 Joystick 4 Click 驱动程序的 API。
关键功能:
joystick4_get_int_pin
- 此函数返回 INT 引脚的逻辑状态。joystick4_get_pins
- 此函数读取所有输入引脚的逻辑状态。joystick4_get_position
- 此函数返回从输入引脚状态掩码中提取的摇杆位置标志。
开源
代码示例
这个示例可以在 NECTO Studio 中找到。欢迎下载代码,或者您也可以复制下面的代码。
/*!
* @file main.c
* @brief Joystick 4 Click example
*
* # Description
* This example demonstrates the use of the Joystick 4 click board by reading
* and displaying the joystick position.
*
* The demo application is composed of two sections :
*
* ## Application Init
* Initializes the driver and performs the click default configuration.
*
* ## Application Task
* Waits for the input change interrupt, reads the input pins mask, extracts
* the joystick position from those readings, and displays it on the USB UART.
*
* @author Stefan Filipovic
*
*/
#include "board.h"
#include "log.h"
#include "joystick4.h"
static joystick4_t joystick4;
static log_t logger;
void application_init ( void )
{
log_cfg_t log_cfg; /**< Logger config object. */
joystick4_cfg_t joystick4_cfg; /**< Click config object. */
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
joystick4_cfg_setup( &joystick4_cfg );
JOYSTICK4_MAP_MIKROBUS( joystick4_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == joystick4_init( &joystick4, &joystick4_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( JOYSTICK4_ERROR == joystick4_default_cfg ( &joystick4 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
if ( JOYSTICK4_PIN_STATE_HIGH == joystick4_get_int_pin ( &joystick4 ) )
{
log_printf ( &logger, " Joystick position: IDLE\r\n\n" );
}
}
void application_task ( void )
{
uint8_t pin_mask = 0;
if ( JOYSTICK4_PIN_STATE_LOW == joystick4_get_int_pin ( &joystick4 ) )
{
if ( JOYSTICK4_OK == joystick4_get_pins ( &joystick4, &pin_mask ) )
{
log_printf ( &logger, " Joystick position: " );
switch ( joystick4_get_position ( pin_mask ) )
{
case JOYSTICK4_POSITION_IDLE:
{
log_printf ( &logger, "IDLE" );
break;
}
case JOYSTICK4_POSITION_CENTER:
{
log_printf ( &logger, "CENTER" );
break;
}
case JOYSTICK4_POSITION_CENTER_UP:
{
log_printf ( &logger, "CENTER-UP" );
break;
}
case JOYSTICK4_POSITION_CENTER_RIGHT:
{
log_printf ( &logger, "CENTER-RIGHT" );
break;
}
case JOYSTICK4_POSITION_CENTER_DOWN:
{
log_printf ( &logger, "CENTER-DOWN" );
break;
}
case JOYSTICK4_POSITION_CENTER_LEFT:
{
log_printf ( &logger, "CENTER-LEFT" );
break;
}
case JOYSTICK4_POSITION_UP:
{
log_printf ( &logger, "UP" );
break;
}
case JOYSTICK4_POSITION_UPPER_RIGHT:
{
log_printf ( &logger, "UPPER-RIGHT" );
break;
}
case JOYSTICK4_POSITION_RIGHT:
{
log_printf ( &logger, "RIGHT" );
break;
}
case JOYSTICK4_POSITION_LOWER_RIGHT:
{
log_printf ( &logger, "LOWER-RIGHT" );
break;
}
case JOYSTICK4_POSITION_DOWN:
{
log_printf ( &logger, "DOWN" );
break;
}
case JOYSTICK4_POSITION_LOWER_LEFT:
{
log_printf ( &logger, "LOWER-LEFT" );
break;
}
case JOYSTICK4_POSITION_LEFT:
{
log_printf ( &logger, "LEFT" );
break;
}
case JOYSTICK4_POSITION_UPPER_LEFT:
{
log_printf ( &logger, "UPPER-LEFT" );
break;
}
default:
{
log_printf ( &logger, "UNKNOWN" );
break;
}
}
log_printf ( &logger, "\r\n\n" );
}
}
}
int main ( void )
{
/* Do not remove this line or clock might not be set correctly. */
#ifdef PREINIT_SUPPORTED
preinit();
#endif
application_init( );
for ( ; ; )
{
application_task( );
}
return 0;
}
// ------------------------------------------------------------------------ END