Drivers

드라이버

Zenith Aerospace가 개발 한 저수준 드라이버를위한 중앙 저장소

목표 • 환경 • 드라이버 사용 방법 • 드라이버 추가

목적

개발 된 운전자를 저장하고 관리합니다.

드라이버를 사용하는 방법

각 드라이버는 자체 폴더로 구성되며 .c/.h 쌍이 있습니다. 예를 들어 STM32CUBEIDE 프로젝트에서 파일을 프로젝트에 추가하기 만하면 .c 파일을 Core/Src 폴더에, .h 를 Core/Inc 에 추가하십시오. 그러나 모든 드라이버는 platform "프레임 워크"를 사용하므로 전체 platform 폴더를 프로젝트에 복사해야합니다. STM32Cubeide에서는 Core/Inc 폴더에 추가합니다. 모든 드라이버에는 사용 방법의 예가 있어야합니다.

플랫폼

플랫폼 프레임 워크는 플랫폼 특정 기능 대신 운전자가 사용하는 매크로 및 헤더 전용 라이브러리 세트입니다. 예를 들어, STM32 프로젝트의 I2C 트랜잭션은 ST HAL 라이브러리를 호출하므로 드라이버는 STM32 마이크로 컨트롤러에서만 사용할 수 있음을 의미합니다. 플랫폼의 임무는 어떤 마이크로 컨트롤러가 컴파일되는지 감지 한 다음 적절한 라이브러리를 선택하여 플랫폼으로 개발 된 드라이버를 다른 마이크로 컨트롤러/프로세서에서 사용할 수 있도록하는 것입니다.

어떻게 작동합니까?

먼저 platform.h 파일은 드라이버, 공통 structs 및 기능 서명에 대한 공통 인터페이스를 설정합니다. 그런 다음 많은 사전 처리기 지시문이 어떤 유형의 프로젝트인지 추측하고 arch 폴더에 올바른 플랫폼 구현 (헤더 전용 라이브러리)을 포함 시키려고합니다.

FYI, 플랫폼에서 구현을 찾을 수없는 경우 STDOUT에 인쇄하는 구현이 사용되는 PC 디버그 모드로 기본값을 얻습니다.

환경

현실적으로, 우리는 대부분의 프로젝트가 해당 플랫폼을 기반으로하는 STM32Cubeide를 주로 사용합니다. 그러나 플랫폼 프레임 워크를 사용하면 C 컴파일러 만 있으면됩니다.

드라이버 추가

운전자를위한 지침 :

• 달리 필요하지 않는 한 C를 사용해야합니다
  • 이유 : 호환성을 극대화하려면 (예, 여전히 C 만 사용할 수있는 UC가 있습니다)
• 예제와 함께 문서를 추가해야합니다
  • 이유 : 대부분의 사용자는 올바른 코드를 복사하여 붙여 넣기를 원합니다.
• 필요하지 않은 한 플랫폼 기능을 사용하여 하드웨어 리소스에 액세스해야합니다.
  • 이유 : 호환성을 극대화하지만 플랫폼이 모든 것을 다루는 것은 아니므로 지금은 플랫폼별로 드라이버를 추가 할 수 있습니다.

목록의 단계 :

1. 이 저장소를 복제하십시오
2. 드라이버 이름이있는 폴더를 만듭니다
3. .c 와 .h 를 추가하십시오
4. 드라이버 폴더에 README.md 파일을 추가하십시오
   1. readme에서 라이브러리의 저자, ​​날짜 및 목적을 추가하십시오.
   2. 문서 추가 : 각 함수의 매개 변수 및 목적
   3. IC의 추가 정보에 대한 메모 섹션 추가
5. (선택 사항) Docs 라는 폴더를 추가하십시오
   1. 데이터 시트, 응용 프로그램 노트 및 등록지도를 포함한 외부 문서 추가
6. 드라이버에 대한 GitHub 문제가있는 경우 메시지를 추가하거나 닫습니다.

---

[email protected]