最初の独自アプリケーションを作る¶

mkdir -p apps/custom/my_reef_app
cp apps/platform/ipro7ai_reef_demo/Makefile apps/custom/my_reef_app/

# my_reef_app: first application on the IPRO7AI Reef EVK.
CONFIG_IPRO7=y
CONFIG_CHIP="IPRO7"
CONFIG_CPU_ID="intelpro_ipro7"
CONFIG_CROSS_COMPILE="/opt/toolchain/riscv_ipro7/bin/riscv64-unknown-elf-"
CONFIG_IPRO7AI_REEF=y
CONFIG_BOARD="IPRO7AI_REEF"

# Build
CONFIG_LINK_FLASH=y
CONFIG_PARTITION=y
CONFIG_ENABLE_FRAME_POINTER=y
CONFIG_EXCEPTION_DUMP=y

# Memory: Kconfig `select` is not applied, so PSRAM is set explicitly.
CONFIG_USE_PSRAM=y
# CONFIG_AI_SUPPORT is not set

# Console on UART0 (U6), 115200 8N1
CONFIG_PLATFORM_UART_BAUDRATE=115200

# FreeRTOS
CONFIG_FREERTOS_SUPPORT=y
CONFIG_COMPONENTS_FREERTOS_ENABLE=y
CONFIG_FREERTOS=y
CONFIG_IPRO_OSAL=y
CONFIG_FREERTOS_HZ=1000
CONFIG_MAIN_TASK_STACK_SIZE=4096
CONFIG_FREERTOS_TIMER_TASK_STACK_WORDS=1024

# Shell and logging
CONFIG_SHELL=y
CONFIG_SHELL_EXEC_THREAD=y
CONFIG_COMPONENTS_SOFTCRC_ENABLE=y
CONFIG_COMPONENTS_UTILITY_API_ENABLE=y
CONFIG_COMPONENTS_NEW_LIBC_ENABLE=y
CONFIG_IPRO_LOG_ENABLE=y
CONFIG_LOG_BUFFER_SIZE=256
CONFIG_LOG_COLORS=y
CONFIG_LOG_DEFAULT_LEVEL_INFO=y
CONFIG_LOG_DEFAULT_LEVEL=3
CONFIG_LOG_OUTPUT_UART=y
CONFIG_LOG_TIMESTAMP=y
CONFIG_LOG_USE_MUTEX=y

# my_reef_app: first application on the IPRO7AI Reef EVK.

__component_add_include_dirs(.)

__set_main_file(main.c)
setup_project(my_reef_app)

/* my_reef_app: first application on the IPRO7AI Reef EVK. */
#include <stdint.h>

#include <generated/autoconf.h>
#include <FreeRTOS.h>
#include <task.h>

#include "freertos_app_hooks.h"
#include "ipro_log.h"

#define LOG_TAG "MYAPP"

static void app_task(void *param)
{
    uint32_t n = 0;

    (void)param;
    for (;;) {
        IPRO_LOGI(LOG_TAG, "alive %lu", (unsigned long)n++);
        vTaskDelay(pdMS_TO_TICKS(2000));
    }
}

int main(void)
{
    ipro_platform_init();   /* heap, boot2, log, shell */

    IPRO_LOGI(LOG_TAG, "Hello from my_reef_app");

    xTaskCreate(app_task, "my_app", 1024, NULL, 5, NULL);
    vTaskStartScheduler();
    while (1) {
    }
    return 0;
}

make -C apps/custom/my_reef_app

Memory region         Used Size  Region Size  %age Used
           flash:       92080 B         1 MB      8.78%
           psram:        9368 B         8 MB      0.11%
           ocram:       29840 B       256 KB     11.38%
          hbnram:        2460 B         4 KB     60.06%
Generate <SDK>/apps/custom/my_reef_app/build/build_out/my_reef_app_IPRO7.bin

MYAPP: Hello from my_reef_app
MYAPP: alive 0
MYAPP: alive 1
MYAPP: alive 2

# my_reef_app: first application on the IPRO7AI Reef EVK.

__component_add_include_dirs(.)

# Reef board drivers from the out-of-box demo, used in place (not copied).
set(REEF_DEMO_SRC ${CMAKE_SOURCE_DIR}/apps/platform/ipro7ai_reef_demo/src)
__component_add_include_dirs(${REEF_DEMO_SRC})
target_sources(app PRIVATE
    ${REEF_DEMO_SRC}/rgb_led.c
)

__set_main_file(main.c)
setup_project(my_reef_app)

/* my_reef_app: first application on the IPRO7AI Reef EVK. */
#include <stdint.h>
#include <stdbool.h>

#include <generated/autoconf.h>
#include <FreeRTOS.h>
#include <task.h>

#include "freertos_app_hooks.h"
#include "ipro_log.h"
#include "board_config.h"
#include "rgb_led.h"

#define LOG_TAG "MYAPP"

static volatile uint32_t s_rgb      = 0x002800;  /* 0xRRGGBB: dim green */
static volatile uint32_t s_blink_ms = 500;       /* 0 = steady on */

static void led_show(uint32_t rgb)
{
    (void)rgb_led_set((uint8_t)(rgb >> 16), (uint8_t)(rgb >> 8), (uint8_t)rgb);
}

static void app_task(void *param)
{
    bool on = false;

    (void)param;
    if (rgb_led_init() != 0) {
        IPRO_LOGE(LOG_TAG, "RGB LED init failed");
    }
    IPRO_LOGI(LOG_TAG, "blinking the RGB LED on GPIO%d", BOARD_RGB_LED_PIN);

    for (;;) {
        uint32_t period = s_blink_ms;

        on = (period == 0) ? true : !on;
        led_show(on ? s_rgb : 0);
        vTaskDelay(pdMS_TO_TICKS(period ? period : 100));
    }
}

int main(void)
{
    ipro_platform_init();   /* heap, boot2, log, shell */

    IPRO_LOGI(LOG_TAG, "Hello from my_reef_app");

    xTaskCreate(app_task, "my_app", 1024, NULL, 5, NULL);
    vTaskStartScheduler();
    while (1) {
    }
    return 0;
}

target_sources(app PRIVATE
    ${REEF_DEMO_SRC}/rgb_led.c
    ${REEF_DEMO_SRC}/keys.c
)

/* Called from the keys poll task on every debounced press and release. */
static void on_key(key_id_t key, bool pressed, void *ctx)
{
    (void)ctx;
    if (!pressed) {
        return;
    }
    IPRO_LOGI(LOG_TAG, "%s pressed (%lu presses)", keys_name(key),
              (unsigned long)keys_press_count(key));
    switch (key) {
    case KEY_SW3: s_rgb = 0x280000; break;   /* red */
    case KEY_SW4: s_rgb = 0x002800; break;   /* green */
    case KEY_SW5: s_rgb = 0x000028; break;   /* blue */
    default: break;                          /* SW1 (BOOT): log only */
    }
}

    if (keys_init() == 0) {
        keys_set_callback(on_key, NULL);
    } else {
        IPRO_LOGE(LOG_TAG, "keys init failed");
    }

MYAPP: SW3 pressed (1 presses)

/* my_reef_app: state shared between the app task and the shell. */
#ifndef MY_APP_H
#define MY_APP_H

#include <stdint.h>

/* LED colour as 0xRRGGBB; blink half-period in ms (0 = steady on). */
void     my_app_set_color(uint32_t rgb);
uint32_t my_app_get_color(void);
void     my_app_set_blink_ms(uint32_t ms);
uint32_t my_app_get_blink_ms(void);

#endif /* MY_APP_H */

void my_app_set_color(uint32_t rgb)   { s_rgb = rgb & 0xFFFFFFu; }
uint32_t my_app_get_color(void)       { return s_rgb; }
void my_app_set_blink_ms(uint32_t ms) { s_blink_ms = ms; }
uint32_t my_app_get_blink_ms(void)    { return s_blink_ms; }

/* my_reef_app: the `myapp` shell command. */
#include <generated/autoconf.h>

#ifdef CONFIG_SHELL

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include "shell.h"
#include "keys.h"
#include "my_app.h"

static void print_status(void)
{
    uint32_t rgb = my_app_get_color();

    printf("LED (%lu,%lu,%lu), blink %lu ms\n",
           (unsigned long)((rgb >> 16) & 0xFF), (unsigned long)((rgb >> 8) & 0xFF),
           (unsigned long)(rgb & 0xFF), (unsigned long)my_app_get_blink_ms());
    for (int k = 0; k < KEY_COUNT; k++) {
        printf("%s: %s, %lu presses\n", keys_name((key_id_t)k),
               keys_is_pressed((key_id_t)k) ? "down" : "up",
               (unsigned long)keys_press_count((key_id_t)k));
    }
}

static int cmd_myapp(int argc, char **argv)
{
    if (argc < 2 || strcmp(argv[1], "status") == 0) {
        print_status();
    } else if (strcmp(argv[1], "color") == 0 && argc == 5) {
        int r = atoi(argv[2]), g = atoi(argv[3]), b = atoi(argv[4]);

        if (r < 0 || r > 255 || g < 0 || g > 255 || b < 0 || b > 255) {
            printf("values are 0..255\n");
            return -1;
        }
        my_app_set_color(((uint32_t)r << 16) | ((uint32_t)g << 8) | (uint32_t)b);
        printf("LED (%d,%d,%d)\n", r, g, b);
    } else if (strcmp(argv[1], "blink") == 0 && argc == 3) {
        int ms = atoi(argv[2]);

        if (ms < 0 || ms > 5000) {
            printf("blink is 0..5000 ms (0 = steady on)\n");
            return -1;
        }
        my_app_set_blink_ms((uint32_t)ms);
        printf("blink %d ms\n", ms);
    } else {
        printf("myapp [status] | myapp color <r> <g> <b> | myapp blink <ms>\n");
    }
    return 0;
}
SHELL_CMD_EXPORT_ALIAS(cmd_myapp, myapp, my_reef_app LED and keys);

#endif /* CONFIG_SHELL */

# my_reef_app: first application on the IPRO7AI Reef EVK.

__component_add_include_dirs(.)

# Reef board drivers from the out-of-box demo, used in place (not copied).
set(REEF_DEMO_SRC ${CMAKE_SOURCE_DIR}/apps/platform/ipro7ai_reef_demo/src)
__component_add_include_dirs(${REEF_DEMO_SRC})
target_sources(app PRIVATE
    ${REEF_DEMO_SRC}/rgb_led.c
    ${REEF_DEMO_SRC}/keys.c
    app_cli.c
)

# SHELL_CMD_EXPORT_ALIAS casts the handler to the shell's generic type.
target_compile_options(app PRIVATE -Wall -Wextra -Wno-cast-function-type)

# Shell commands are found through their linker section, never called by name,
# so the app archive must be linked whole or the commands are dropped.
set_property(GLOBAL APPEND PROPERTY SDK_LIBS app)
set_property(GLOBAL APPEND PROPERTY SDK_WHOLE_ARCHIVE_LIBS app)

__set_main_file(main.c)
setup_project(my_reef_app)

myapp status

LED (0,40,0), blink 500 ms
BOOT/SW1: up, 0 presses
SW3: up, 0 presses
SW4: up, 0 presses
SW5: up, 0 presses

myapp color 0 0 80
myapp blink 0

LED (0,0,80)
blink 0 ms