사서함:소개 및 기본 서비스

0이 아닌 값을 선택하는 것은 사서함에 대한 "마스터 활성화"입니다. 그 결과 일부 데이터 구조가 그에 따라 정의되고 크기가 조정되며 이에 대한 자세한 내용은 다음 기사에서 설명합니다. API 활성화 설정도 활성화합니다.

API 사용

Nucleus SE의 모든 API 기능(서비스 호출)에는 활성화된 #define이 있습니다. nuse_config.h의 기호 . 사서함의 경우:

NUSE_MAILBOX_SEND
NUSE_MAILBOX_RECEIVE
NUSE_MAILBOX_RESET
NUSE_MAILBOX_INFORMATION
NUSE_MAILBOX_COUNT

기본적으로 모두 FALSE로 설정되어 있습니다. , 따라서 각 서비스 호출을 비활성화하고 구현 코드의 포함을 금지합니다. 애플리케이션의 사서함을 구성하려면 사용하려는 API 호출을 선택하고 활성화 기호를 TRUE로 설정해야 합니다. .

다음은 기본 nuse_config.h에서 발췌한 것입니다. 파일.

/* 의 사서함 수 시스템 - 0-16 */ #define NUSE_MAILBOX_NUMBER 0  /* 서비스 호출 인에이블러:*/ #define NUSE_MAILBOX_SEND FALSE  #define NUSE_MAILBOX_RECEIVE FALSE  #define NUSE_MAILBOX_RESET FALSE  #define NUSE_MAILBOX_INFORMATION FALSE  #define NUSE_MAILBOX_COUNT FALSE  

사서함 API 기능이 활성화되어 있고 사서함이 구성되어 있지 않으면 컴파일 시간 오류가 발생합니다(NUSE_Mailbox_Count() 제외). 항상 허용됨). 코드가 활성화되지 않은 API 호출을 사용하는 경우 애플리케이션에 구현 코드가 포함되지 않았기 때문에 링크 시간 오류가 발생합니다.

사서함 서비스 호출

Nucleus RTOS는 다음 기능을 제공하는 사서함과 관련된 9개의 서비스 호출을 지원합니다.

• 사서함으로 메시지를 보냅니다. NUSE_Mailbox_Send()에 의해 구현됨 Nucleus SE에서.

• 사서함에서 메시지를 받습니다. NUSE_Mailbox_Receive()에 의해 구현됨 Nucleus SE에서.

• 일시 중단(재설정)하지 않고 사서함을 사용하지 않은 상태로 복원합니다. NUSE_Mailbox_Reset()에 의해 구현됨 Nucleus SE에서.

• 지정된 사서함에 대한 정보를 제공합니다. NUSE_Mailbox_Information()에 의해 구현됨 Nucleus SE에서.

• 응용 프로그램에 대해 (현재) 구성된 사서함 수를 반환합니다. NUSE_Mailbox_Count()에 의해 구현됨 Nucleus SE에서.

• 애플리케이션에 새 편지함을 추가합니다(만들기). Nucleus SE에서는 구현되지 않습니다.

• 응용 프로그램에서 사서함을 제거합니다(삭제). Nucleus SE에서는 구현되지 않습니다.

• 응용 프로그램의 모든 사서함(현재)에 대한 포인터를 반환합니다. Nucleus SE에서는 구현되지 않습니다.

• 메일함(브로드캐스트)에서 일시 중단된 모든 작업에 메시지를 보냅니다. Nucleus SE에서는 구현되지 않습니다.

이러한 각 서비스 호출의 구현을 자세히 조사합니다.

사서함 쓰기 및 읽기 서비스

사서함에서 수행할 수 있는 기본 작업은 사서함에 데이터를 쓰는 것입니다. 이를 보내기라고도 합니다. 또는 게시 – 데이터 읽기 – 수신이라고도 함 . Nucleus RTOS와 Nucleus SE는 각각 이러한 작업에 대해 두 가지 기본 API 호출을 제공하며 여기에서 설명합니다.

사서함에 쓰기

사서함에 쓰기 위한 Nucleus RTOS API 호출은 매우 유연하여 작업을 즉시 완료할 수 없는 경우 무기한 또는 시간 초과로 일시 중단할 수 있습니다. 즉, 전체 사서함에 쓰려고 합니다. Nucleus SE는 작업 일시 중단이 선택 사항이고 타임아웃이 구현되지 않는다는 점을 제외하고는 동일한 서비스를 제공합니다.

Nucleus RTOS는 사서함으로 브로드캐스트하는 기능도 제공하지만 Nucleus SE에서는 지원하지 않습니다. 구현되지 않은 API 아래에 설명되어 있습니다. 다음 기사에서.

사서함으로 보내기 위한 Nucleus RTOS API 호출

서비스 요청 프로토타입:

STATUS NU_Send_To_Mailbox(NU_MAILBOX *사서함, VOID *메시지, 서명되지 않은 정지),

매개변수:

사서함 – 사용할 사서함에 대한 포인터

메시지 – 4개의 서명되지 않은 메시지에 대한 포인터 요소

일시중지 – 작업 일시 중단에 대한 사양 NU_NO_SUSPEND일 수 있음 또는 NU_SUSPEND 또는 시간 초과 값

반품:

NU_SUCCESS – 통화가 성공적으로 완료되었습니다.

NU_INVALID_MAILBOX – 사서함 포인터가 잘못되었습니다.

NU_INVALID_POINTER – 메시지 포인터가 NULL입니다.

NU_INVALID_SUSPEND – 작업이 아닌 스레드에서 일시 중단을 시도했습니다.

NU_MAILBOX_FULL – 사서함이 가득 차서 일시 중단이 지정되지 않았습니다.

NU_TIMEOUT – 지정된 기간 동안 일시 중단된 후에도 메일함이 가득 찼습니다.

NU_MAILBOX_DELETED – 작업이 일시 중단된 동안 사서함이 삭제되었습니다.

NU_MAILBOX_WAS_RESET – 작업이 일시 중단된 동안 사서함이 재설정되었습니다.

사서함으로 보내기 위한 Nucleus SE API 호출

이 API 호출은 Nucleus RTOS API의 주요 기능을 지원합니다.

서비스 요청 프로토타입:

STATUS NUSE_Mailbox_Send(NUSE_MAILBOX 편지함, ADDR *메시지, U8 정지);

매개변수:

사서함 – 활용할 사서함의 인덱스(ID)

메시지 – ADDR 유형의 단일 변수인 보낼 메시지에 대한 포인터

일시중지 – 작업 일시 중단에 대한 사양 NUSE_NO_SUSPEND일 수 있습니다. 또는 NUSE_SUSPEND

반품:

NUSE_SUCCESS – 통화가 성공적으로 완료되었습니다.

NUSE_INVALID_MAILBOX – 사서함 인덱스가 잘못되었습니다.

NUSE_INVALID_POINTER – 메시지 포인터가 NULL입니다.

NUSE_INVALID_SUSPEND – 작업이 아닌 스레드에서 또는 차단 API 호출이 활성화되지 않은 경우 일시 중단이 시도되었습니다.

NUSE_MAILBOX_FULL – 사서함이 가득 차서 일시 중단이 지정되지 않았습니다.

NUSE_MAILBOX_WAS_RESET – 작업이 일시 중단된 동안 사서함이 재설정되었습니다.

Nucleus SE의 Mailbox Send 구현

NUSE_Mailbox_Send() 코드의 대부분 매개변수 확인 후 API 기능은 API 호출 차단(작업 일시 중단) 지원이 활성화되었는지 여부에 따라 조건부 컴파일에 의해 선택됩니다. 여기에서 두 가지 변형을 개별적으로 살펴보겠습니다.

차단이 활성화되지 않은 경우 이 API 호출에 대한 논리는 매우 간단하고 코드에는 설명이 거의 필요하지 않습니다.

if (NUSE_Mailbox_Status[mailbox]) /* 편지함 가득 참 */{ return_value =NUSE_MAILBOX_FULL;}else /* 편지함 비어 있음 */{ NUSE_Mailbox_Data[mailbox] =*message; NUSE_Mailbox_Status[사서함] =TRUE; return_value =NUSE_SUCCESS;}

메시지는 NUSE_Mailbox_Data[]의 적절한 요소에 저장됩니다. 사용 중인 것으로 표시된 사서함.

차단이 활성화되면 코드가 더 복잡해집니다.

do{ if (!NUSE_Mailbox_Status[mailbox]) /* 편지함 비어 있음 */ { NUSE_Mailbox_Data[mailbox] =*message; NUSE_Mailbox_Status[사서함] =TRUE; if (NUSE_Mailbox_Blocking_Count[mailbox] !=0) { U8 인덱스; /* 작업이 차단되었는지 확인 */ /* 이 편지함에서 */ NUSE_Mailbox_Blocking_Count[mailbox]--; for (index=0; index 

 다음과 같은 설명이 유용할 수 있습니다.
 

 코드는 do...while로 묶여 있습니다. 매개변수가 suspend인 동안 계속되는 루프 값이 NUSE_SUSPEND입니다. .
 

 편지함이 비어 있으면 제공된 메시지가 저장되고 편지함이 가득 찼음을 나타내도록 편지함 상태가 변경됩니다. 사서함에서 일시 중단된(수신 대기 중) 작업이 있는지 확인합니다. 대기 중인 작업이 있으면 첫 번째 작업이 깨어납니다. 일시중지 변수가 NUSE_NO_SUSPEND로 설정됨 API 호출은 NUSE_SUCCESS로 종료됩니다. .
 

 편지함이 가득 차서 일시중지한 경우 NUSE_NO_SUSPEND로 설정됨 , API 호출은 NUSE_MAILBOX_FULL로 종료됩니다. . 일시중지하는 경우 NUSE_SUSPEND(으)로 설정되었습니다. , 작업이 일시 중단됩니다. 반환 시(즉, 작업이 깨어났을 때) 반환 값이 NUSE_SUCCESS인 경우 , 메시지를 읽었기 때문에 작업이 깨어났음을 나타냅니다(사서함 재설정과 반대). 코드가 맨 위로 루프백됩니다.
 

            


            

               ARMv8 기반 펌웨어 시스템의 아키텍처        
                세마포어:유틸리티 서비스 및 데이터 구조