Linux Userspace rpmsg_char 및 FreeRTOS 간 RPMsg Echo 애플리케이션 구현 매뉴얼

Linux Userspace rpmsg_char 및 FreeRTOS RPMsg Communication 구현 배경

비대칭 멀티프로세싱(AMP) 아키텍처 환경에서는 Linux 마스터 코어의 유저 공간(Userspace)과 Cortex-M 리모트 코어 실시간 OS(FreeRTOS) 간의 데이터 교환이 빈번하게 발생합니다. Linux 커널 내부의 드라이버뿐만 아니라 일반 애플리케이션 레벨(Userspace)에서 하드웨어 제어 컴포넌트에 접근하려면 표준화된 인터페이스가 필수적입니다. Linux의 rpmsg_char 또는 rpmsg_tty 드라이버를 활용하면 유저 공간에서 표준 파일 I/O 연산(open, read, write)을 통해 이기종 코어 간 통신을 간단히 제어할 수 있습니다. 이번 포스팅에서는 rpmsg_char 인터페이스를 매개로 Linux Userspace 애플리케이션과 FreeRTOS 펌웨어 간에 데이터 패킷을 상호 에코(Echo)하는 End-to-End 실전 시스템 구현 방법을 상세히 분석합니다.

Linux Linux Userspace <-> FreeRTOS RPMsg Echo 핵심 요약

• Linux rpmsg_char 디바이스 노드 생성 (Device Node Creation): Linux Userspace에서 /dev/rpmsg_ctrlX 컨트롤러를 통해 특정 엔드포인트(rpmsg-echo-channel)를 위한 /dev/rpmsgX 가상 캐릭터 디바이스 엔드포인트를 생성합니다.
• FreeRTOS rpmsg_create_ept 엔드포인트 바인딩 (Endpoint Binding): Cortex-M 펌웨어는 rpmsg_create_ept() API를 호출하여 고유의 로컬 주소와 원격 주소를 바인딩하고, 수신 인터럽트 처리를 위한 rpmsg_ept_cb 콜백 함수를 등록합니다.
• End-to-End Echo 루프 구동 (Data Echo Loop): Linux가 write() 함수로 메시지를 송신하면, FreeRTOS는 등록된 콜백 내부에서 rpmsg_send()를 호출하여 수신 데이터 버퍼를 가상 링 버퍼(vring)를 통해 즉각 반송(Echo)합니다.

Linux Userspace rpmsg_char 및 FreeRTOS RPMsg Echo 아키텍처 상세 분석

Linux rpmsg_char 가상 드라이버와 FreeRTOS RPMsg 레이어 비교 분석

Linux 유저 공간과 FreeRTOS 커널 간의 에코 통신이 정상 동작하려면 양단 시스템의 데이터 전송 계층과 채널 식별 방식이 상호 매핑되어야 합니다. 다음 표는 Linux의 rpmsg_char 인터페이스 아키텍처와 FreeRTOS의 OpenAMP 구현 요소 간의 매핑 관계를 요약한 데이터입니다.

Linux Userspace Component	FreeRTOS OpenAMP Component	데이터 흐름 및 핵심 기능 (Core Functionality)	관련 API / 디바이스 제어 (Control System)
/dev/rpmsg_ctrlX	Name Service Endpoint	동적 채널 감지 및 로컬 엔드포인트 생성 요청 관리	ioctl(RPMSG_CREATE_EPT_IOCTL) / rpmsg_ns_announce()
/dev/rpmsgX	struct rpmsg_endpoint	고유 포트 주소를 기반으로 데이터 패킷을 송수신하는 가상 통신 엔드포인트	open(), read(), write() / rpmsg_create_ept()
VirtIO vring Buffer	Virtqueue vring	공유 메모리 기반 가상 링 버퍼를 활용한 이기종 코어 간 패킷 버퍼 동기화	copy_from_user() / vring_alloc(), rpmsg_send()

FreeRTOS RPMsg Echo 애플리케이션 구현 및 콜백 등록 소스코드 분석

다음 소스코드는 Cortex-M MCU에서 FreeRTOS 환경을 기반으로 구현된 RPMsg 에코 서버의 핵심 구현부입니다. Linux Userspace로부터 메시지가 전달되면 하드웨어 메일박스 인터럽트 및 OpenAMP 스택을 거쳐 rpmsg_echo_cb가 실행됩니다.

#include "rpmsg_lite.h"
#include "rpmsg_queue.h"
#include "rpmsg_ns.h"

#define ECHO_CHANNEL_NAME "rpmsg-echo-channel"
#define LOCAL_EPT_ADDR    (30)

static struct rpmsg_lite_instance *volatile my_rpmsg_instance = NULL;
static struct rpmsg_lite_endpoint *my_echo_endpoint = NULL;

/* Callback function handling incoming RPMsg messages from Linux Userspace */
static int32_t rpmsg_echo_cb(void *payload, uint32_t payload_len, uint32_t src, void *priv)
{
    int32_t result;

    if (payload == NULL || payload_len == 0)
    {
        return RL_RELEASE;
    }

    /* Echo back the received payload data to the sender (Linux remote address) */
    result = rpmsg_lite_send(my_rpmsg_instance, my_echo_endpoint, src, payload, payload_len, RL_DONT_BLOCK);
    if (result != RL_SUCCESS)
    {
        /* Primary error handle code should be placed here */
    }

    return RL_RELEASE;
}

/* Initialization task running in FreeRTOS environment */
void vRPMsgEchoTask(void *pvParameters)
{
    /* Initialize the RPMsg Lite stack as a Remote component */
    my_rpmsg_instance = rpmsg_lite_remote_init((void *)VDEV0_VRING_BASE, MCU_LINK_ID, RL_NO_FLAGS);
    while (my_rpmsg_instance == NULL)
    {
        vTaskDelay(pdMS_TO_TICKS(1));
    }

    /* Create local endpoint and bind the echo callback function */
    my_echo_endpoint = rpmsg_lite_create_ept(my_rpmsg_instance, LOCAL_EPT_ADDR, rpmsg_echo_cb, NULL);

    /* Announce the presence of the echo channel to Linux Host Name Service */
    (void)rpmsg_ns_announce(my_rpmsg_instance, my_echo_endpoint, ECHO_CHANNEL_NAME, RL_NS_CREATE);

    /* Main task loop processing OpenAMP framework events */
    while (1)
    {
        /* Process dynamic inter-core events triggered by hardware mailbox interrupts */
        (void)rpmsg_lite_wait_for_isr_context(my_rpmsg_instance, RL_BLOCK);
    }
}

Linux Userspace rpmsg_char 애플리케이션 검증 소스코드 분석

다음 소스코드는 Linux OS의 유저 공간에서 /dev/rpmsg_ctrlX를 사용해 엔드포인트를 만들고 FreeRTOS 에코 서버와 데이터를 주고받는 통신 검증 예제입니다.

#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
#include <sys/ioctl.h>
#include <linux/rpmsg.h>

#define RPMSG_CTRL_DEV  "/dev/rpmsg_ctrl0"
#define TEST_MESSAGE    "Hello FreeRTOS AMP Echo"

int main(void)
{
    int ctrl_fd, ept_fd;
    struct rpmsg_endpoint_info ept_info;
    char rx_buffer[256];
    ssize_t bytes_written, bytes_read;

    ctrl_fd = open(RPMSG_CTRL_DEV, O_RDWR);
    if (ctrl_fd < 0)
    {
        perror("Failed to open rpmsg control device");
        return -1;
    }

    /* Setup endpoint configuration matching FreeRTOS settings */
    strcpy(ept_info.name, "rpmsg-echo-channel");
    ept_info.src = RPMSG_ADDR_ANY;
    ept_info.dst = 30;

    /* Request Linux kernel to instantiate dynamic /dev/rpmsg0 endpoint */
    if (ioctl(ctrl_fd, RPMSG_CREATE_EPT_IOCTL, &ept_info) < 0)
    {
        perror("Failed to execute RPMSG_CREATE_EPT_IOCTL");
        close(ctrl_fd);
        return -1;
    }
    close(ctrl_fd);

    /* Open the newly created application-level communication node */
    ept_fd = open("/dev/rpmsg0", O_RDWR);
    if (ept_fd < 0)
    {
        perror("Failed to open target endpoint node /dev/rpmsg0");
        return -1;
    }

    /* Send packet data down to the FreeRTOS side */
    bytes_written = write(ept_fd, TEST_MESSAGE, strlen(TEST_MESSAGE));
    if (bytes_written < 0)
    {
        perror("Failed to write data onto the rpmsg socket");
        close(ept_fd);
        return -1;
    }

    /* Block until FreeRTOS echo architecture returns the exact response packet */
    bytes_read = read(ept_fd, rx_buffer, sizeof(rx_buffer) - 1);
    if (bytes_read > 0)
    {
        rx_buffer[bytes_read] = '\0';
        printf("[Linux Userspace RX] Received from FreeRTOS: %s\n", rx_buffer);
    }

    close(ept_fd);
    return 0;
}

Linux Userspace ↔ FreeRTOS RPMsg 디버깅 및 개발 팁

• Linux sysfs 인터페이스 채널 상태 모니터링: Linux shell 터미널에서 ls /sys/bus/rpmsg/devices/ 명령어를 실행하면 Name Service 공지를 통해 정상적으로 매핑된 RPMsg 채널 리스트를 즉시 검증할 수 있습니다.
• RL_DONT_BLOCK 플래그 활용을 통한 ISR 바인딩 최적화: FreeRTOS 수신 콜백은 하드웨어 인터럽트 컨텍스트 내부 또는 지연 태스크 컨텍스트 내에서 동작합니다. rpmsg_lite_send() 호출 시 전송 차단 조건인 RL_BLOCK을 설정하면 컨텍스트 스위칭 교착상태(Deadlock)를 초래할 수 있으므로, 무조건 비차단 모드 플래그(RL_DONT_BLOCK)를 사용하는 것이 안전합니다.
• Dynamic Payload Allocation을 통한 오버헤드 감소: 고속 대용량 패킷을 전달해야 하는 시스템인 경우 rpmsg_lite_alloc_tx_buffer() API를 활용해 공유 메모리의 vring 버퍼 영역을 유저 태스크 메모리에 직접 할당받아 쓰기 작업을 수행함으로써 딥 카피 오버헤드를 줄일 수 있습니다.

RPMsg Echo 통신 과정에서 발생하는 흔히 하는 실수와 예외 해결책

Device or resource busy 오류로 인한 Linux ioctl 실행 실패

• 발생 원인: Linux Userspace 테스트 실행 시 RPMSG_CREATE_EPT_IOCTL 단계에서 Device or resource busy 또는 Invalid argument 에러 커널 메시지가 출력되는 경우입니다. 이는 FreeRTOS에서 설정한 로컬 주소값(LOCAL_EPT_ADDR) 또는 채널 이름 식별 정보가 Linux 애플리케이션 패킷에 명시된 dst 주소 및 name 필드 정보와 정확히 일치하지 않아 커널 라우팅 가상화가 바인딩을 거부할 때 주로 발생합니다.
• 해결 방법: FreeRTOS 단 소스코드의 포트 정의 값인 30과 ECHO_CHANNEL_NAME 문자열이 Linux 소스코드 내부의 ept_info.dst 값 및 ept_info.name 버퍼 정보와 정확하게 대소문자까지 결합 일치하는지 소스 교차 검증을 처리하십시오.

대용량 데이터 송신 시 FreeRTOS 콜백 응답 누락 현상

• 발생 원인: Linux Userspace에서 write() 연산으로 512바이트 이상의 긴 패킷을 한 번에 전송하려고 할 때 FreeRTOS가 메시지를 받지 못하거나, 송수신 버퍼 데이터 손상(Corrupted)이 발생하여 유실되는 임베디드 예외 케이스입니다. OpenAMP 환경에서 단일 vring 패킷의 기본 최대 크기(RPMSG_BUFFER_SIZE)는 통상적으로 512바이트 혹은 256바이트 세팅으로 제한되어 설정됩니다.
• 해결 방법: 펌웨어 컴파일 단계 시 전역 구성 헤더 영역에서 RPMSG_BUFFER_SIZE 값을 필요한 크기에 맞게 증가시켜 재구성하거나, Linux 측 유저 소프트웨어 애플리케이션 계층에서 전송 패킷을 최대 버퍼 사이즈 규격 미만 단위로 Fragment 파티셔닝 분할 처리하여 순차 송신하도록 통신 규칙을 변경해 주어야 합니다.

이기종 코어 간 표준 RPMsg 통신 토폴로지의 최종 결론

Linux 시스템의 유저 공간 아키텍처와 MCU 기반의 FreeRTOS 커널을 rpmsg_char 드라이버를 통해 유기적으로 바인딩하는 구조는 제어 아키텍처 다변화 관점에서 효용을 가집니다. 파일 서브시스템 추상화 레이어를 통해 Userspace에서 통상적인 스트림 I/O 연산으로 고성능 통신 링크를 직접 핸들링할 수 있어 복잡한 커널 전용 드라이버의 복잡도를 개선해 줍니다. 링 버퍼 규격 일치성과 로컬 엔드포인트 바인딩 parameter를 동기화하고 예외 상황 처리를 보강하면, 상용 등급의 안정성을 만족하는 고효율 이기종 프로세싱 임베디드 제어 파이프라인을 구현할 수 있습니다.