初学者
10 分钟

使用TLC5925和PIC18F57Q43让项目更加互动且具有视觉吸引力

橙色LED环用于直观显示旋钮的位置

Rotary O 2 Click with Curiosity Nano with PIC18F57Q43

已发布 6月 24, 2024

点击板

Rotary O 2 Click

开发板

Curiosity Nano with PIC18F57Q43

编译器

NECTO Studio

微控制器单元

PIC18F57Q43

通过添加一个视觉吸引力强且信息丰富的LED环,为您的项目增添风格和功能。

A

A

硬件概览

它是如何工作的?

Rotary O 2 Click 基于 TLC5925,这是一款来自德州仪器的低功耗16通道恒流LED电流驱动器,结合来自ALPS的高质量旋转编码器EC12D1564402,允许您在设计中添加精密输入旋钮。EC12D1564402增量旋转编码器被16个橙色LED环绕,每次旋转被分为15个离散步骤(与电位器不同,旋转编码器可以连续旋转)。驱动器可以单独控制每个LED,允许编程各种照明效果。编码器通过两个mikroBUS™线路输出A和B信号(彼此相位相反),以及旋钮按下功能,通过中断

线输出。EC12D1564402是一个15脉冲增量旋转编码器,带有按钮开关。该编码器具有独特的机械规格(其内部开关的去抖时间可低至2毫秒),并且可以承受高达30,000次的切换周期。支持的去抖电路允许接触在输出完全触发前稳定下来。Rotary O 2 Click使用TLC5925 LED驱动器的标准4线SPI串行接口与主机MCU通信,支持高达30MHz的时钟频率。旋转编码器时,它通过mikroBUS™插座的ENA和ENB引脚在两个mikroBUS™线上输出A和B信号(彼此相位相反),以及通

过mikroBUS™插座的SW引脚(中断线)输出的按钮接触信号。两个来自德州仪器的SN74LVC1T45单比特总线收发器用于逻辑电平转换。此Click board™可以通过VCC SEL跳线选择3.3V或5V逻辑电压级别进行操作。这样,具有3.3V和5V功能的MCU都可以正确使用通信线。另外,此Click board™配有包含易于使用功能和示例代码的库,可作为进一步开发的参考。

Rotary O 2 Click hardware overview image

功能概述

开发板

PIC18F57Q43 Curiosity Nano 评估套件是一款尖端的硬件平台,旨在评估 PIC18-Q43 系列内的微控制器。其设计的核心是包含了功能强大的 PIC18F57Q43 微控制器(MCU),提供先进的功能和稳健的性能。这个评估套件的关键特点包括一个黄 色用户 LED 和一个响应灵敏的机械用户开关,提供无

缝的交互和测试。为一个 32.768kHz 水晶振荡器足迹提供支持,确保精准的定时能力。套件内置的调试器拥有一个绿色电源和状态 LED,使编程和调试变得直观高效。此外,增强其实用性的还有虚拟串行端口 (CDC)和一个调试 GPIO 通道(DGI GPIO),提供广泛的连接选项。该套件通过 USB 供电,拥有由

 MIC5353 LDO 调节器提供支持的可调目标电压功能,确保在 1.8V 至 5.1V 的输出电压范围内稳定运行,最大输出电流为 500mA,受环境温度和电压限制。

PIC18F57Q43 Curiosity Nano double side image

微控制器概述 

MCU卡片 / MCU

default

建筑

PIC

MCU 内存 (KB)

128

硅供应商

Microchip

引脚数

48

RAM (字节)

8196

你完善了我!

配件

Curiosity Nano Base for Click boards 是一款多功能硬件扩展平台,专为简化 Curiosity Nano 套件与扩展板之间的集成而设计,特别针对符合 mikroBUS™ 标准的 Click 板和 Xplained Pro 扩展板。这款创新的基板(屏蔽板)提供了无缝的连接和扩展可能性,简化了实验和开发过程。主要特点包括从 Curiosity Nano 套件提供 USB 电源兼容性,以及为增强灵活性而提供的另一种外部电源输入选项。板载锂离子/锂聚合物充电器和管理电路确保电池供电应用的平稳运行,简化了使用和管理。此外,基板内置了一个固定的 3.3V 电源供应单元,专用于目标和 mikroBUS™ 电源轨,以及一个固定的 5.0V 升压转换器,专供 mikroBUS™ 插座的 5V 电源轨,为各种连接设备提供稳定的电力供应。

Curiosity Nano Base for Click boards accessories 1 image

使用的MCU引脚

mikroBUS™映射器

Encoder Output B
PA0
AN
ID SEL
PA7
RST
SPI Select / ID COMM
PD4
CS
SPI Clock
PC6
SCK
SPI Data OUT
PC5
MISO
SPI Data IN
PC4
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Encoder Output A
PB0
PWM
Output Switch
PA6
INT
NC
NC
TX
NC
NC
RX
NC
NC
SCL
NC
NC
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

Rotary O 2 Click Schematic schematic

一步一步来

项目组装

Curiosity Nano Base for Click boards front image hardware assembly

从选择您的开发板和Click板™开始。以Curiosity Nano with PIC18F57Q43作为您的开发板开始。

Curiosity Nano Base for Click boards front image hardware assembly
Charger 27 Click front image hardware assembly
PIC18F47Q10 Curiosity Nano front image hardware assembly
Prog-cut hardware assembly
Charger 27 Click complete accessories setup image hardware assembly
Curiosity Nano with PICXXX Access MB 1 - upright/background hardware assembly
Necto image step 2 hardware assembly
Necto image step 3 hardware assembly
Necto image step 4 hardware assembly
Necto image step 5 hardware assembly
Necto image step 6 hardware assembly
PIC18F57Q43 Curiosity MCU Step hardware assembly
Necto No Display image step 8 hardware assembly
Necto image step 9 hardware assembly
Necto image step 10 hardware assembly
Debug Image Necto Step hardware assembly

实时跟踪您的结果

应用程序输出

1. 应用程序输出 - 在调试模式下,“应用程序输出”窗口支持实时数据监控,直接提供执行结果的可视化。请按照提供的教程正确配置环境,以确保数据正确显示。

2. UART 终端 - 使用UART Terminal通过USB to UART converter监视数据传输,实现Click board™与开发系统之间的直接通信。请根据项目需求配置波特率和其他串行设置,以确保正常运行。有关分步设置说明,请参考提供的教程

3. Plot 输出 - Plot功能提供了一种强大的方式来可视化实时传感器数据,使趋势分析、调试和多个数据点的对比变得更加直观。要正确设置,请按照提供的教程,其中包含使用Plot功能显示Click board™读数的分步示例。在代码中使用Plot功能时,请使用以下函数:plot(insert_graph_name, variable_name);。这是一个通用格式,用户需要将“insert_graph_name”替换为实际图表名称,并将“variable_name”替换为要显示的参数。

软件支持

库描述

该库包含 Rotary O 2 Click 驱动程序的 API。

关键功能:

  • rotaryo2_set_led_pos - 此功能打开所选 LED 位置的 LED。

  • rotaryo2_set_led_data - 此功能使用 SPI 串行接口写入所需的 16 位数据。

  • rotaryo2_get_state_switch - 此功能返回旋转编码器开关信号,即 SW(INT) 的状态。

开源

代码示例

完整的应用程序代码和一个现成的项目可以通过NECTO Studio包管理器直接安装到NECTO Studio 应用程序代码也可以在MIKROE的GitHub账户中找到。

/*!
 * @file main.c
 * @brief Rotary O 2 Click example
 *
 * # Description
 * This library contains the API for the Rotary O 2 Click driver 
 * to control LEDs states and a rotary encoder position readings.
 *
 * The demo application is composed of two sections :
 *
 * ## Application Init
 * Initialization of SPI module and log UART.
 * After the driver init, the app executes a default configuration and turn off all LEDs.
 *
 * ## Application Task
 * This example demonstrates the use of the Rotary O 2 Click board?.
 * The demo example shows the functionality of a rotary encoder used to control LEDs.
 *
 * @author Nenad Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "rotaryo2.h"

#define ROTARYO2_ONE_LED          ROTARYO2_SET_LED_DATA_1
#define ROTARYO2_TWO_LED          ROTARYO2_SET_LED_DATA_1  | ROTARYO2_SET_LED_DATA_9
#define ROTARYO2_FOUR_LED         ROTARYO2_SET_LED_DATA_1  | ROTARYO2_SET_LED_DATA_5  | \
                                  ROTARYO2_SET_LED_DATA_9  | ROTARYO2_SET_LED_DATA_13 
#define ROTARYO2_EIGHT_LED        ROTARYO2_SET_LED_DATA_1  | ROTARYO2_SET_LED_DATA_3  | \
                                  ROTARYO2_SET_LED_DATA_5  | ROTARYO2_SET_LED_DATA_7  | \
                                  ROTARYO2_SET_LED_DATA_9  | ROTARYO2_SET_LED_DATA_11 | \
                                  ROTARYO2_SET_LED_DATA_13 | ROTARYO2_SET_LED_DATA_15
#define ROTARYO2_EIGHT_LED_INV    ROTARYO2_SET_LED_DATA_2  | ROTARYO2_SET_LED_DATA_4  | \
                                  ROTARYO2_SET_LED_DATA_6  | ROTARYO2_SET_LED_DATA_8  | \
                                  ROTARYO2_SET_LED_DATA_10 | ROTARYO2_SET_LED_DATA_12 | \
                                  ROTARYO2_SET_LED_DATA_14 | ROTARYO2_SET_LED_DATA_16

static rotaryo2_t rotaryo2;
static log_t logger;

static uint8_t start_rot_status = 0;
static uint8_t led_demo_state = 0;
static uint8_t old_state = 0;
static uint8_t new_state = 1;
static uint8_t old_rot_state = 0;
static uint8_t new_rot_state = 1;
static uint16_t led_data = 1;

/**
 * @brief Rotary O 2 select LED demo data function.
 * @details This function selects one of the four LED demo data 
 * based on the current state of the LED demo.
 * @return LED demo data:
 *         @li @c 0x0001 (ROTARYO2_ONE_LED)   - Turn ON LED[1],
 *         @li @c 0x0101 (ROTARYO2_TWO_LED)   - Turn ON LED[1,9],
 *         @li @c 0x0101 (ROTARYO2_FOUR_LED)  - Turn ON LED[1,5,9,13],
 *         @li @c 0x5555 (ROTARYO2_EIGHT_LED) - Turn ON LED[1,3,5,7,9,11,13,15].
 */
static uint16_t rotaryo2_sel_led_demo_data ( uint8_t led_demo_state );

/**
 * @brief Rotary O 2 switch detection function.
 * @details This function is used for the switch state detection.
 * @return Nothing.
 */
static void rotaryo2_switch_detection ( void );

/**
 * @brief Rotary O 2 encoder mechanism function.
 * @details This function is used to control the state of the LEDs 
 * by detecting the rotation direction of the rotary encoder.
 * @return Nothing.
 */
static void rotaryo2_encoder_mechanism ( void );

void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    rotaryo2_cfg_t rotaryo2_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.
    rotaryo2_cfg_setup( &rotaryo2_cfg );
    ROTARYO2_MAP_MIKROBUS( rotaryo2_cfg, MIKROBUS_1 );
    if ( SPI_MASTER_ERROR == rotaryo2_init( &rotaryo2, &rotaryo2_cfg ) )
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }
    
    if ( ROTARYO2_ERROR == rotaryo2_default_cfg ( &rotaryo2 ) )
    {
        log_error( &logger, " Default configuration." );
        for ( ; ; );
    }
    
    log_info( &logger, " Application Task " );
}

void application_task ( void )
{
    if ( ROTARYO2_OK == rotaryo2_set_led_data( &rotaryo2, led_data ) )
    {
        rotaryo2_switch_detection( );
        rotaryo2_encoder_mechanism( );
    }
}

void main ( void )
{
    application_init( );

    for ( ; ; )
    {
        application_task( );
    }
}

static uint16_t rotaryo2_sel_led_demo_data ( uint8_t led_demo_state ) 
{
    switch ( led_demo_state ) 
    {
        case 0: 
        {
            return ROTARYO2_ONE_LED;
            break;
        }
        case 1: 
        {
            return ROTARYO2_TWO_LED;
            break;
        }
        case 2: 
        {
            return ROTARYO2_FOUR_LED;
            break;
        }
        case 3: 
        {
            return ROTARYO2_EIGHT_LED;
            break;
        }
        default: 
        {
            return ROTARYO2_ONE_LED;
            break;
        }
    }
}

static void rotaryo2_switch_detection ( void )
{
    if ( rotaryo2_get_state_switch( &rotaryo2 ) ) 
    {
        new_state = 1;
        if ( (  1 == new_state ) && ( 0 == old_state ) ) 
        {
            old_state = 1;
            led_demo_state = ( led_demo_state + 1 ) % 5;
            if ( 4 == led_demo_state ) 
            {
                for ( uint8_t n_cnt = 0; n_cnt < 10; n_cnt++ )
                {
                    rotaryo2_set_led_data( &rotaryo2, ROTARYO2_EIGHT_LED_INV );
                    Delay_ms( 100 );
                    rotaryo2_set_led_data( &rotaryo2, ROTARYO2_EIGHT_LED );
                    Delay_ms( 100 );
                }
                
                for ( uint8_t led_p = ROTARYO2_SET_LED_POS_1; led_p <= ROTARYO2_SET_LED_POS_16; led_p++ ) 
                {
                    rotaryo2_set_led_pos( &rotaryo2, led_p );
                    Delay_ms( 100 );
                }
                
                led_demo_state = 0;
                led_data = rotaryo2_sel_led_demo_data( led_demo_state );
            }
            else 
            {
                led_data = rotaryo2_sel_led_demo_data( led_demo_state );
            }
        }
    }
    else 
    {
        old_state = 0;
    }
}

static void rotaryo2_encoder_mechanism ( void )
{
    if ( rotaryo2_get_state_ena( &rotaryo2 ) == rotaryo2_get_state_enb( &rotaryo2 ) ) 
    {
        old_rot_state = 0;
        start_rot_status = rotaryo2_get_state_ena( &rotaryo2 ) && rotaryo2_get_state_enb( &rotaryo2 );
    }
    else 
    {
        new_rot_state = 1;
        if ( new_rot_state != old_rot_state ) 
        {
            old_rot_state = 1;
            if ( start_rot_status != rotaryo2_get_state_ena( &rotaryo2 ) ) 
            {
                led_data = ( led_data << 1 ) | ( led_data >> 15 );
            }
            else 
            {
                led_data = ( led_data >> 1 ) | ( led_data << 15 );
            }
        }
    }
}

// ------------------------------------------------------------------------ END

额外支持

资源

喜欢这个项目吗?

'购买此套件' 按钮会直接带您进入购物车,您可以在购物车中轻松添加或移除产品。