Iot 기기용 휴대용 C 코드를 작성하는 방법

전형적인 HAL 구현 패턴은 다음과 같습니다 :

// hal_gpio.h (common)
typedef uint8_t gpio_pin_t;
typedef uint8_t gpio_port_t;
void hal_gpio_set_output(gpio_port_t port, gpio_pin_t pin);
void hal_gpio_set_high(gpio_port_t port, gpio_pin_t pin);
void hal_gpio_set_low(gpio_port_t port, gpio_pin_t pin);

플랫폼 별 파일 (예 :, ])은 실제 등록 쓰기를 포함합니다. 새로운 MCU로 이동할 때, 낮은 수준 HAL 소스는 다시 쓰기 필요하며, 모든 높은 층은 비터치가 남아 있습니다.

표준 Libraries 채택

C 표준 라이브러리는 많은 일반적인 작업을 위한 휴대용 기반을 제공합니다. ], ], 문자열 유틸리티 및 수학 기능은 C 컴파일러에 따라 사용할 수 있습니다. 라이브러리 내부에 대한 가정을 피하는 것은 중요한 것은 - 당신이 컴파일러의 구현이 충분하다는 것을 확인하지 않는 한 성능에 대한 를 다시 작성합니다.

제한된 메모리를 가진 IoT 시스템을 위해 표준 라이브러리의 하위 세트를 사용 고려하십시오 (예 : [[FLT :0]] newlib‐nano] GCC 생태계에서]) 오히려 자신의 문자열 루틴을 구하는 것보다. 마찬가지로, ] 매크로와 는 보편적으로 사용할 수 있습니다. 링크 : [FLT : 2]]GNU C 라이브러리 문서[FLT : 3]는 휴대용 이해에 대한 탁월한 참조입니다.

Fixed-Width Data Types 사용

항상 과 ]에서 명시된 폭과 정수 변수를 선언하기 위해 ], , , ], 등 ]], , 또는 ], 어떤 크기로 알려진. 루프와 작은 실행을 위해 ], ], ]], ]], ]]].

바이트 중심의 운송에 걸쳐 직렬 데이터가 필요할 때, 명시된 바이트-order 변환 기능 (], , 또는 휴대용 동등물)과 고정 폭 유형과 결합합니다. 단순히 ]을 ]로 캐스팅하고 네트워크에 전송합니다.

관능적 인

Preprocessor 지시어는 플랫폼별 코드에 대한 합법적인 도구이지만, 그들은 배심적으로 사용되어야 합니다. 단일 중앙 헤더에 있는 구성 매크로의 작은 세트를 정의합니다 (예: ]). 모든 파일을 통해 ]를 흩어지게 합니다. 예:

// platform_config.h
#if defined(STM32L4)
 #define PLATFORM_STM32L4
#elif defined(EFM32GG)
 #define PLATFORM_EFM32GG
#else
 #error "Unsupported platform"
#endif

그런 다음 코드에서, 일반 ]을 절대적으로 필요한 경우. 과도한 것을 유지 을 읽고 유지하기 위해 코드를 하드. 가능한 상태 컴파일에 Prefer HAL 요약.

최소화 외장

모든 타사 라이브러리는 잠재적 인 휴대성 위험입니다. 의존성을 추가하기 전에 모든 대상 아키텍처를 지원하고 비 ‐portable 가정에서 끌어지지 않는 것을 확인합니다. Libraries는 휴대용 C (예 :, [[FLT : 0]]FatFS[[FLT :1]] 또는 [[FLT :2]FreeRTOS[FLT :3]])에서 완전히 작성된 라이브러리는 그보다 더 안전합니다. 그 후, 당신은 더 얇은 조각을 만들 수 있으므로, 더 얇은 조각을 만들 수 있습니다.

링크: Embedded.com 실제 C 코드]에 대한 기사는 의존성을 관리에 대한 추가적인 관점을 제공합니다.

Portability 향상을 위한 실용적인 팁

모듈 번호 쓰기

펌웨어를 독립적으로 잘 정의된 인터페이스로 끊기십시오. 각 모듈은 헤더 파일로 기능을 노출하고 내부 세부 사항을 숨기도록해야합니다. 이러한 분리는 새로운 플랫폼에 포트 할 때 휴대용 버전으로 모듈을 교체하는 것이 쉽습니다. 예를 들어 모터 제어 모듈은 타이머 주변 레지스터에 직접 PWM 출력에 대한 HAL에 대해 이야기해야합니다.

문서 하드웨어 의존성

특정 하드웨어 동작을 가정하는 코드가 분명히 주목합니다. 특정 비 허용 접근이 선택되었는지 설명하는 의견, 어떤 플랫폼에서 작동하고, 다른 대상을 변경해야 할 것입니다. 이 문서는 원래 개발자가 사용할 수 없을 때 비유할 수 있으며 새로운 엔지니어는 코드를 포트해야합니다.

Cross-Platform Build Tools를 사용하여

CMake 또는 ]Meson]은 단일 프로젝트 구조에서 여러 대상 구성을 관리할 수 있습니다. CMake, 예를 들어, 각 플랫폼에 대한 툴체인 파일을 지정하고 대상에 따라 컴파일 정의를 설정할 수 있습니다. 이 방법은 수동으로 IAR, Keil 및 GCC에 대한 별도의 프로젝트 파일을 유지하는 데 필요한 것을 제거합니다. 링크: ]:5]]]:5]]]:2]]]:0]

#define BIT_SET(reg, bit) ((reg) |= (1u << (bit)))
#define BIT_CLEAR(reg, bit) ((reg) &= ~(1u << (bit)))