使用8800 Retro Click和STM32G431RB探索计算的根源

回到过去：体验Altair 8800的传承

8800 Retro Click with Nucleo 64 with STM32G431RB MCU

已发布 11月 08, 2024

点击板

8800 Retro Click

开发板

Nucleo 64 with STM32G431RB MCU

编译器

NECTO Studio

微控制器单元

STM32G431RB

发现早期计算机的简单和魅力，与8800 Retro Click一起，这是对传奇的Altair 8800的创新致敬。

硬件概览

它是如何工作的？

8800 Retro Click基于AMS-AG的紧凑型点阵8x8 LED驱动器AS1115。它包括每个段的4位PWM和仅一个用于LED电流调节（LED亮度）的电阻。AS1115包含一个集成的BCD码-B/HEX解码器，多路复用扫描电路，分段和显示驱动器以及64位存储器。内部存储器存储了移位寄存器的设置，消除了持续设备重新编程的需求。该板适用于七段数码管或点阵用户界面显示以及其他家用电器或个人电子应用。LED列具有共阴极，

连接到数码驱动线，其中每个64个LED可以单独寻址。在初始上电时，AS1115寄存器被重置为默认值，显示被清空，并且设备进入关闭模式。此时，所有寄存器应该被编程为正常操作。AS1115具有通常为200nA的低关闭电流和通常为350μA的操作电流。8800 Retro Click使用标准I2C 2-Wire接口与MCU进行通信，在Fast Mode Plus中的时钟频率可高达1MHz。此外，AS1115可以读取16个按钮，并提供详细的短路/断路

LED错误诊断。因此，为了获得按钮的有效回读，建议在触发mikroBUS™插座上的INT引脚上的IRQ中断引脚后立即读取键扫描寄存器。除了数字-数字编程之外，此Click board™还可以通过软件进行复位。此Click board™只能使用3.3V逻辑电压电平运行。在使用具有不同逻辑电平的MCU之前，板子必须执行适当的逻辑电压电平转换。此外，它配备了一个包含函数和示例代码的库，可用作进一步开发的参考。

功能概述

开发板

Nucleo-64 搭载 STM32G431RB MCU 提供了一种经济高效且灵活的平台，供开发者探索新想法并原型设计他们的项目。该板利用 STM32 微控制器的多功能性，使用户能够为他们的项目选择最佳的性能与功耗平衡。它配备了 LQFP64 封装的 STM32 微控制器，并包含了如用户 LED（同时作为 ARDUINO® 信号）、用户和复位按钮，以及 32.768kHz 晶体振荡器用于精确的计时操作等基本组件。Nucleo-64 板设计考虑到扩展性和灵活性，它特有的 ARDUINO® Uno

V3 扩展连接器和 ST morpho 扩展引脚头，提供了对 STM32 I/O 的完全访问，以实现全面的项目整合。电源供应选项灵活，支持 ST-LINK USB VBUS 或外部电源，确保在各种开发环境中的适应性。该板还配备了一个具有 USB 重枚举功能的板载 ST-LINK 调试器/编程器，简化了编程和调试过程。此外，该板设计旨在简化高级开发，它的外部 SMPS 为 Vcore 逻辑供电提供高效支持，支持 USB 设备全速或 USB SNK/UFP 全速，并内置加密功能，提升了项目的功效

和安全性。通过外部 SMPS 实验的专用连接器、用于 ST-LINK 的 USB 连接器以及 MIPI® 调试连接器，提供了更多的硬件接口和实验可能性。开发者将通过 STM32Cube MCU Package 提供的全面免费软件库和示例得到广泛支持。这些，加上与多种集成开发环境（IDE）的兼容性，包括 IAR Embedded Workbench®、MDK-ARM 和 STM32CubeIDE，确保了流畅且高效的开发体验，使用户能够充分利用 Nucleo-64 板在他们的项目中的能力。

Nucleo 64 with STM32G431RB MCU double side image

微控制器概述

MCU卡片 / MCU

建筑

ARM Cortex-M4

MCU 内存 (KB)

128

硅供应商

STMicroelectronics

引脚数

RAM (字节)

32k

你完善了我！

配件

Click Shield for Nucleo-64 配备了两个专有的 mikroBUS™ 插座，使得所有的 Click board™ 设备都可以轻松地与 STM32 Nucleo-64 开发板连接。这样，Mikroe 允许其用户从不断增长的 Click boards™ 范围中添加任何功能，如 WiFi、GSM、GPS、蓝牙、ZigBee、环境传感器、LED、语音识别、电机控制、运动传感器等。您可以使用超过 1537 个 Click boards™，这些 Click boards™ 可以堆叠和集成。STM32 Nucleo-64 开发板基于 64 引脚封装的微控制器，采用 32 位 MCU，配备 ARM Cortex M4 处理器，运行速度为 84MHz，具有 512Kb Flash 和 96KB SRAM，分为两个区域，顶部区域代表 ST-Link/V2 调试器和编程器，而底部区域是一个实际的开发板。通过 USB 连接方便地控制和供电这些板子，以便直接对 Nucleo-64 开发板进行编程和高效调试，其中还需要额外的 USB 线连接到板子上的 USB 迷你接口。大多数 STM32 微控制器引脚都连接到了板子左右边缘的 IO 引脚上，然后连接到两个现有的 mikroBUS™ 插座上。该 Click Shield 还有几个开关，用于选择 mikroBUS™ 插座上模拟信号的逻辑电平和 mikroBUS™ 插座本身的逻辑电压电平。此外，用户还可以通过现有的双向电平转换器，使用任何 Click board™，无论 Click board™ 是否在 3.3V 或 5V 逻辑电压电平下运行。一旦将 STM32 Nucleo-64 开发板与我们的 Click Shield for Nucleo-64 连接，您就可以访问数百个工作于 3.3V 或 5V 逻辑电压电平的 Click boards™。

Click Shield for Nucleo-64 accessories 1 image

使用的MCU引脚

mikroBUS™映射器

RST

SCK

MISO

MOSI

Power Supply

3.3V

Ground

GND

PWM

Interrupt

PC14

INT

I2C Clock

PB8

SCL

I2C Data

PB9

SDA

Ground

GND

“仔细看看！”

Click board™ 原理图

一步一步来

项目组装

Click Shield for Nucleo-64 accessories 1 image hardware assembly

从选择您的开发板和Click板™开始。以Nucleo 64 with STM32G431RB MCU作为您的开发板开始。

Nucleo 64 with STM32G474RE MCU front image hardware assembly

BarGraph 5 Click front image hardware assembly

Nucleo-64 with STM32GXXX MCU MB 1 Micro B Conn - upright/background hardware assembly

Clicker 4 for STM32F4 HA MCU Step hardware assembly

Necto No Display image step 8 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”替换为要显示的参数。

软件支持

库描述

该库包含 8800 Retro Click 驱动程序的 API。

关键功能:

c8800retro_display_char - 此函数显示预定义字符集（IBM BIOS 8x8字体数组）中的单个字符
c8800retro_get_keypad - 此函数读取KEYA和KEYB寄存器，并将寄存器的反转值存储到键盘变量中
c8800retro_display_string - 此函数在LED上滚动所需的字符串

开源

代码示例

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

/*!
 * @file main.c
 * @brief 8800Retro Click example
 *
 * # Description
 * This example demonstrates the use of 8800 Retro click board.
 *
 * The demo application is composed of two sections :
 *
 * ## Application Init
 * Initializes the driver and issues the click default configuration, 
 * then asks the user to select the demo example using the on-board KeyPad.
 *
 * ## Application Task
 * There are 4 different demo examples: KeyPad 4x4, Full charset, Text, and Image.
 * This function will run the previously selected demo example in the loop. 
 * The user can always switch the example by pressing the button D4 three times in a row. 
 * In order to run the demo examples successfully, please follow the instructions logged
 * on the USB UART.
 * 
 * @author Stefan Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "c8800retro.h"

/**
 * @brief 8800 Retro Click demo example values.
 * @details Enum values for demo examples selection.
 */
typedef enum
{
    DEMO_KEYPAD4x4,
    DEMO_FULL_CHARSET,
    DEMO_TEXT,
    DEMO_IMAGE,

} c8800retro_demo_example_t;

static c8800retro_t c8800retro;
static log_t logger;

static c8800retro_demo_example_t demo_example = DEMO_KEYPAD4x4;
uint8_t c8800retro_demo_string[ 9 ] = { ' ', 'M', 'i', 'k', 'r', 'o', 'E', ' ', 0 };
uint8_t c8800retro_demo_logo_mikroe[ 8 ] = { 0x7F, 0xFF, 0xC0, 0xFF, 0xFF, 0xC0, 0xFF, 0x7F };

/**
 * @brief 8800 Retro select demo example function.
 * @details This function asks the user to select the demo example via desired buttons.
 * @param[in] ctx : Click context object.
 * See #c8800retro_t object definition for detailed explanation.
 * @return @li @c  0 - Success,
 *         @li @c -1 - Error.
 *
 * See #err_t definition for detailed explanation.
 * @note Follow the procedure written on the USB UART to select the desired demo example.
 */
static err_t c8800retro_select_demo_example( c8800retro_t *ctx );

/**
 * @brief 8800 Retro demo KeyPad 4x4 example function.
 * @details This function executes the KeyPad 4x4 demo example.
 * @param[in] ctx : Click context object.
 * See #c8800retro_t object definition for detailed explanation.
 * @return @li @c  0 - Success,
 *         @li @c -1 - Error.
 *
 * See #err_t definition for detailed explanation.
 * @note Follow the procedure written on the USB UART to jump out the function.
 */
static err_t c8800retro_demo_keypad4x4( c8800retro_t *ctx );

/**
 * @brief 8800 Retro demo Full charset example function.
 * @details This function executes the Full charset demo example.
 * @param[in] ctx : Click context object.
 * See #c8800retro_t object definition for detailed explanation.
 * @return @li @c  0 - Success,
 *         @li @c -1 - Error.
 *
 * See #err_t definition for detailed explanation.
 * @note Follow the procedure written on the USB UART to jump out the function.
 */
static err_t c8800retro_demo_full_charset( c8800retro_t *ctx );

/**
 * @brief 8800 Retro demo text example function.
 * @details This function executes the Text demo example.
 * @param[in] ctx : Click context object.
 * See #c8800retro_t object definition for detailed explanation.
 * @param[in] scroll_mode : @li @c 0 - Horizontal left.
 *                          @li @c 1 - Horizontal right.
 *                          @li @c 2 - Vertical up.
 *                          @li @c 3 - Vertical down.
 * @param[in] scroll_speed_ms : Scroll speed in miliseconds.
 * @param[in] text : Text string (up to 32 characters).
 * @return @li @c  0 - Success,
 *         @li @c -1 - Error.
 *
 * See #err_t definition for detailed explanation.
 * @note Follow the procedure written on the USB UART to jump out the function.
 */
static err_t c8800retro_demo_text( c8800retro_t *ctx, uint8_t scroll_mode, uint16_t scroll_speed_ms, uint8_t *text );

/**
 * @brief 8800 Retro demo image example function.
 * @details This function executes the Image demo example.
 * @param[in] ctx : Click context object.
 * See #c8800retro_t object definition for detailed explanation.
 * @param[in] p_image : Pointer to image buffer (array of 8 bytes).
 * @return @li @c  0 - Success,
 *         @li @c -1 - Error.
 *
 * See #err_t definition for detailed explanation.
 * @note Follow the procedure written on the USB UART to jump out the function.
 */
static err_t c8800retro_demo_image( c8800retro_t *ctx, uint8_t *p_image );

void application_init ( void ) 
{
    log_cfg_t log_cfg;                /**< Logger config object. */
    c8800retro_cfg_t c8800retro_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.
    c8800retro_cfg_setup( &c8800retro_cfg );
    C8800RETRO_MAP_MIKROBUS( c8800retro_cfg, MIKROBUS_1 );
    err_t init_flag = c8800retro_init( &c8800retro, &c8800retro_cfg );
    if ( I2C_MASTER_ERROR == init_flag ) 
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );

        for ( ; ; );
    }

    c8800retro_default_cfg( &c8800retro );
    c8800retro_select_demo_example( &c8800retro );
}

void application_task ( void ) 
{
    switch ( demo_example )
    {
        case DEMO_KEYPAD4x4:
        {
            c8800retro_demo_keypad4x4 ( &c8800retro );
            break;
        }
        case DEMO_FULL_CHARSET:
        {
            c8800retro_demo_full_charset ( &c8800retro );
            break;
        }
        case DEMO_TEXT:
        {
            c8800retro_demo_text ( &c8800retro, C8800RETRO_SCROLL_HORIZONTAL_LEFT, 
                                                C8800RETRO_SCROLL_SPEED_MEDIUM, 
                                                c8800retro_demo_string );
            break;
        }
        case DEMO_IMAGE:
        {
            c8800retro_demo_image ( &c8800retro, c8800retro_demo_logo_mikroe );
            break;
        }
        default:
        {
            break;
        }
    }
}

void main ( void ) 
{
    application_init( );

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

static err_t c8800retro_select_demo_example( c8800retro_t *ctx )
{
    err_t error_flag = c8800retro_clear_display( ctx );
    error_flag |= c8800retro_clear_interrupt( ctx );
    
    for ( ; ; )
    {
        uint16_t keypad = C8800RETRO_KEY_NONE;
        
        log_printf( &logger, "\r\n Press one of the following buttons to select the demo example: \r\n" );
        log_printf( &logger, " A1: KeyPad 4x4 \r\n" );
        log_printf( &logger, " A2: Full charset \r\n" );
        log_printf( &logger, " A3: Text \r\n" );
        log_printf( &logger, " A4: Image \r\n" );
        
        // Pressed button
        while( c8800retro_get_int_pin( ctx ) );
        error_flag |= c8800retro_get_keypad( ctx, &keypad );
        while( !c8800retro_get_int_pin( ctx ) );
        
        // Released button
        while( c8800retro_get_int_pin( ctx ) );
        error_flag |= c8800retro_clear_interrupt( ctx );
        while( !c8800retro_get_int_pin( ctx ) );
        
        switch ( keypad )
        {
            case C8800RETRO_KEY_A1:
            {
                demo_example = DEMO_KEYPAD4x4;
                return error_flag;
            }
            case C8800RETRO_KEY_A2:
            {
                demo_example = DEMO_FULL_CHARSET;
                return error_flag;
            }
            case C8800RETRO_KEY_A3:
            {
                demo_example = DEMO_TEXT;
                return error_flag;
            }
            case C8800RETRO_KEY_A4:
            {
                demo_example = DEMO_IMAGE;
                return error_flag;
            }
            default:
            {
                log_printf( &logger, " Wrong button! \r\n" );
                break;
            }
        }
    }
}

static err_t c8800retro_demo_keypad4x4( c8800retro_t *ctx )
{
    log_printf( &logger, "\r\n ---- KeyPad 4x4 demo example ---- \r\n" );
    log_printf( &logger, " Keypad layout: \r\n" );
    log_printf( &logger, " 1  2  3  A \r\n" );
    log_printf( &logger, " 4  5  6  B \r\n" );
    log_printf( &logger, " 7  8  9  C \r\n" );
    log_printf( &logger, " *  0  #  D \r\n" );
    log_printf( &logger, " Press the button D4 three times to switch the example \r\n " );
    uint8_t d4_cnt = 0;
    
    err_t error_flag = c8800retro_clear_display( ctx );
    error_flag |= c8800retro_clear_interrupt( ctx );
    
    for ( ; ; )
    {
        uint16_t keypad = C8800RETRO_KEY_NONE;
        
        // Pressed button
        while( c8800retro_get_int_pin( ctx ) );
        error_flag |= c8800retro_get_keypad( ctx, &keypad );
        while( !c8800retro_get_int_pin( ctx ) );
        
        // Released button
        while( c8800retro_get_int_pin( ctx ) );
        error_flag |= c8800retro_clear_interrupt( ctx );
        while( !c8800retro_get_int_pin( ctx ) );
        
        if ( keypad & C8800RETRO_KEY_D4 )
        {
            d4_cnt++;
        }
        else
        {
            d4_cnt = 0;
        }
        switch ( keypad )
        {
            case C8800RETRO_KEY_A1:
            {
                error_flag |= c8800retro_display_char( ctx, '1' );
                log_printf( &logger, "1" );
                break;
            }
            case C8800RETRO_KEY_A2:
            {
                error_flag |= c8800retro_display_char( ctx, '2' );
                log_printf( &logger, "2" );
                break;
            }
            case C8800RETRO_KEY_A3:
            {
                error_flag |= c8800retro_display_char( ctx, '3' );
                log_printf( &logger, "3" );
                break;
            }
            case C8800RETRO_KEY_A4:
            {
                error_flag |= c8800retro_display_char( ctx, 'A' );
                log_printf( &logger, "A" );
                break;
            }
            case C8800RETRO_KEY_B1:
            {
                error_flag |= c8800retro_display_char( ctx, '4' );
                log_printf( &logger, "4" );
                break;
            }
            case C8800RETRO_KEY_B2:
            {
                error_flag |= c8800retro_display_char( ctx, '5' );
                log_printf( &logger, "5" );
                break;
            }
            case C8800RETRO_KEY_B3:
            {
                error_flag |= c8800retro_display_char( ctx, '6' );
                log_printf( &logger, "6" );
                break;
            }
            case C8800RETRO_KEY_B4:
            {
                error_flag |= c8800retro_display_char( ctx, 'B' );
                log_printf( &logger, "B" );
                break;
            }
            case C8800RETRO_KEY_C1:
            {
                error_flag |= c8800retro_display_char( ctx, '7' );
                log_printf( &logger, "7" );
                break;
            }
            case C8800RETRO_KEY_C2:
            {
                error_flag |= c8800retro_display_char( ctx, '8' );
                log_printf( &logger, "8" );
                break;
            }
            case C8800RETRO_KEY_C3:
            {
                error_flag |= c8800retro_display_char( ctx, '9' );
                log_printf( &logger, "9" );
                break;
            }
            case C8800RETRO_KEY_C4:
            {
                error_flag |= c8800retro_display_char( ctx, 'C' );
                log_printf( &logger, "C" );
                break;
            }
            case C8800RETRO_KEY_D1:
            {
                error_flag |= c8800retro_display_char( ctx, '*' );
                log_printf( &logger, "*" );
                break;
            }
            case C8800RETRO_KEY_D2:
            {
                error_flag |= c8800retro_display_char( ctx, '0' );
                log_printf( &logger, "0" );
                break;
            }
            case C8800RETRO_KEY_D3:
            {
                error_flag |= c8800retro_display_char( ctx, '#' );
                log_printf( &logger, "#" );
                break;
            }
            case C8800RETRO_KEY_D4:
            {
                error_flag |= c8800retro_display_char( ctx, 'D' );
                log_printf( &logger, "D" );
                break;
            }
            default:
            {
                break;
            }
        }
        
        if ( d4_cnt == 3 )
        {
            error_flag |= c8800retro_select_demo_example( ctx );
            return error_flag;
        }
    }
    
    return error_flag;
}

static err_t c8800retro_demo_full_charset( c8800retro_t *ctx )
{
    log_printf( &logger, "\r\n ---- Full charset demo example ---- \r\n" );
    log_printf( &logger, " Press the button D4 three times to switch the example \r\n" );
    
    err_t error_flag = c8800retro_clear_display( ctx );
    error_flag |= c8800retro_clear_interrupt( ctx );
    
    for ( ; ; )
    {
        for ( uint8_t cnt = 0; cnt <= 255; cnt++ )
        {
            if ( cnt == 128 )
            {
                cnt = 160;
            }
            error_flag |= c8800retro_display_char( ctx, cnt );
            
            Delay_ms( 200 );
            if ( !c8800retro_get_int_pin( ctx ) )
            {
                uint16_t keypad = C8800RETRO_KEY_NONE;
                uint8_t d4_cnt = 0;
                while ( d4_cnt < 3 )
                {
                    // Pressed button
                    while( c8800retro_get_int_pin( ctx ) );
                    error_flag |= c8800retro_get_keypad( ctx, &keypad );
                    while( !c8800retro_get_int_pin( ctx ) );
                    
                    // Released button
                    while( c8800retro_get_int_pin( ctx ) );
                    error_flag |= c8800retro_clear_interrupt( ctx );
                    while( !c8800retro_get_int_pin( ctx ) );
                    
                    if ( ( keypad & C8800RETRO_KEY_D4 ) != C8800RETRO_KEY_D4 )
                    {
                        break;
                    }
                    d4_cnt++;
                }
                if ( d4_cnt == 3 )
                {
                    error_flag |= c8800retro_select_demo_example( ctx );
                    return error_flag;
                }
            }
            if ( C8800RETRO_ERROR == error_flag )
            {
                log_printf( &logger, "\r\n Error occured. \r\n" );
                return error_flag;
            }
        }
    }
}

static err_t c8800retro_demo_text( c8800retro_t *ctx, uint8_t scroll_mode, uint16_t scroll_speed_ms, uint8_t *text )
{
    log_printf( &logger, "\r\n ---- Text demo example ---- \r\n" );
    log_printf( &logger, " Once it finish scrolling, press the button D4 three times in the next" );
    log_printf( &logger, " 3 seconds to switch the example \r\n" );
    
    err_t error_flag = c8800retro_clear_display( ctx );
    error_flag |= c8800retro_clear_interrupt( ctx );
    
    for ( ; ; )
    {
        uint16_t timeout = 3000;
        
        log_printf( &logger, "\r\n Text scrolling has started. \r\n" );
        error_flag |= c8800retro_display_string( ctx, scroll_mode, scroll_speed_ms, text );
        
        error_flag |= c8800retro_clear_interrupt( ctx );
        
        log_printf( &logger, "\r\n Text scrolling has finished. Press the button D4 three times in the next" );
        log_printf( &logger, " 3 seconds to switch the example. Otherwise, scrolling will start over. \r\n" );
        
        while ( timeout-- > 0 )
        {
            if ( !c8800retro_get_int_pin( ctx ) )
            {
                uint16_t keypad = C8800RETRO_KEY_NONE;
                uint8_t d4_cnt = 0;
                while ( d4_cnt < 3 )
                {
                    // Pressed button
                    while( c8800retro_get_int_pin( ctx ) );
                    error_flag |= c8800retro_get_keypad( ctx, &keypad );
                    while( !c8800retro_get_int_pin( ctx ) );
                    
                    // Released button
                    while( c8800retro_get_int_pin( ctx ) );
                    error_flag |= c8800retro_clear_interrupt( ctx );
                    while( !c8800retro_get_int_pin( ctx ) );
                    
                    if ( ( keypad & C8800RETRO_KEY_D4 ) != C8800RETRO_KEY_D4 )
                    {
                        break;
                    }
                    d4_cnt++;
                }
                if ( d4_cnt == 3 )
                {
                    error_flag |= c8800retro_select_demo_example( ctx );
                    return error_flag;
                }
            }
            Delay_ms ( 1 );
        }
        
        if ( C8800RETRO_ERROR == error_flag )
        {
            log_printf( &logger, "\r\n Error occured. \r\n" );
            return error_flag;
        }
    }
}

static err_t c8800retro_demo_image( c8800retro_t *ctx, uint8_t *p_image )
{
    log_printf( &logger, "\r\n ---- Image demo example ---- \r\n" );
    log_printf( &logger, " Press the button D4 three times to switch the example \r\n" );
    
    err_t error_flag = c8800retro_clear_display( ctx );
    error_flag |= c8800retro_clear_interrupt( ctx );
    
    error_flag |= c8800retro_display_image( ctx, p_image );
            
    for ( ; ; )
    {
        if ( !c8800retro_get_int_pin( ctx ) )
        {
            uint16_t keypad = C8800RETRO_KEY_NONE;
            uint8_t d4_cnt = 0;
            while ( d4_cnt < 3 )
            {
                // Pressed button
                while( c8800retro_get_int_pin( ctx ) );
                error_flag |= c8800retro_get_keypad( ctx, &keypad );
                while( !c8800retro_get_int_pin( ctx ) );
                
                // Released button
                while( c8800retro_get_int_pin( ctx ) );
                error_flag |= c8800retro_clear_interrupt( ctx );
                while( !c8800retro_get_int_pin( ctx ) );
                
                if ( ( keypad & C8800RETRO_KEY_D4 ) != C8800RETRO_KEY_D4 )
                {
                    break;
                }
                d4_cnt++;
            }
            if ( d4_cnt == 3 )
            {
                error_flag |= c8800retro_select_demo_example( ctx );
                return error_flag;
            }
        }
        if ( C8800RETRO_ERROR == error_flag )
        {
            log_printf( &logger, "\r\n Error occured. \r\n" );
            return error_flag;
        }
    }
}

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