deki-sdcard
SD 카드 지원. 카드를 마운트해 에셋 매니저가 런타임에 카드에서 스트리밍할 수 있게 합니다.
저장소: github.com/dekiengine/deki-sdcard · 최신 릴리스: 0.19.0 · 엔진 0.19.0 이상 필요
DekiEditor --packages-add deki-sdcard <project> 또는 패키지 관리자로 설치합니다. 엔진 자체의 컴포넌트와 C++ API는 Deki 문서에 있습니다.
에디터에는 SD Card(으)로 표시됩니다.
컴포넌트
| 컴포넌트 | 카테고리 | 설명 |
|---|---|---|
| SDCardComponent | 시스템 | 부팅 시 SD 카드를 마운트하여 카드에서 에셋을 로드할 수 있게 합니다. |
컴포넌트 레퍼런스
SDCardComponent
부팅 시 SD 카드를 마운트하여 카드에서 에셋을 로드할 수 있게 합니다.
인스펙터 이름: SD 카드 컴포넌트 · 카테고리: 시스템 · 유형: DekiSdCard::SDCardComponent
| 속성 | 유형 | 기본값 | 제약 | 설명 |
|---|---|---|---|---|
| mode | enum | "SPI" | SPI, SDMMC1Bit, SDMMC4Bit | 카드의 배선 방식입니다. SPI는 핀 4개가 필요하며 어떤 보드에서도 동작합니다. SDMMC는 더 빠르지만 전용 핀이 필요하며, 4비트가 1비트보다 빠릅니다. |
| mosiPin | int32 | 23 | 0~48; mode이(가) 허용할 때 표시 | SPI 모드: 보드가 송신에 쓰는 GPIO로, 카드의 DI 또는 CMD 패드에 연결합니다. |
| misoPin | int32 | 19 | 0~48; mode이(가) 허용할 때 표시 | SPI 모드: 보드가 수신에 쓰는 GPIO로, 카드의 DO 또는 DAT0 패드에 연결합니다. |
| csPin | int32 | 5 | 0~48; mode이(가) 허용할 때 표시 | SPI 모드: 칩 셀렉트입니다. 이 카드와 통신하는 동안 Low로 유지되며, 덕분에 다른 장치와 버스를 공유할 수 있습니다. |
| spiHz | int32 | 20000000 | 1~40; mode이(가) 허용할 때 표시 | SPI 클럭 속도입니다. 20 MHz는 대부분의 카드와 짧은 배선에 적합합니다. 마운트는 되지만 읽기가 잘 안 되는 카드는 대개 값을 낮추면 해결됩니다. |
| sdmmcHz | int32 | 20000000 | 1~40; mode이(가) 허용할 때 표시 | SDMMC 클럭 속도입니다. 20 MHz로 시작하는 것이 안전하며, 배선이 짧고 길이가 잘 맞춰진 보드에서는 40 MHz도 동작합니다. |
| cmdPin | int32 | 15 | 0~48; mode이(가) 허용할 때 표시 | SDMMC 모드: 보드가 카드와 통신할 때 쓰는 커맨드 라인입니다. |
| d0Pin | int32 | 2 | 0~48; mode이(가) 허용할 때 표시 | SDMMC 모드: 데이터 라인 0입니다. 1비트 모드에서 사용하는 유일한 데이터 라인입니다. |
| d1Pin | int32 | 4 | 0~48; mode이(가) 허용할 때 표시 | SDMMC 4비트 모드: 데이터 라인 1입니다. 1비트 모드에서는 무시됩니다. |
| d2Pin | int32 | 12 | 0~48; mode이(가) 허용할 때 표시 | SDMMC 4비트 모드: 데이터 라인 2입니다. 1비트 모드에서는 무시됩니다. |
| d3Pin | int32 | 13 | 0~48; mode이(가) 허용할 때 표시 | SDMMC 4비트 모드: 데이터 라인 3입니다. 1비트 모드에서는 무시됩니다. |
| clkPin | int32 | 18 | 0~48 | SDMMC 모드: 카드를 구동하는 클럭 라인입니다. |
| cdPin | int32 | -1 | -1~48 | 카드 감지 핀입니다(소켓에 감지 스위치가 있는 경우). 없으면 -1이며, 이때는 카드가 항상 꽂혀 있다고 간주합니다. |
| required | bool | true | 카드를 마운트하지 못하면 부팅을 멈춥니다. 끄면 카드 없이 부팅을 계속합니다. 화면과 조작은 사용할 수 있지만, 카드에 있는 게임 에셋은 로드되지 않습니다. 측면에 카드 슬롯이 있는 휴대용 기기용입니다. |
변경 내역
변경 내역은 영어로 되어 있습니다.
0.19.0
Changed
- minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.
Added
- Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.
0.18.0
Changed
- minEngine 0.18.0. Reflection ABI 21: the package must be rebuilt.
- Names follow the code style (deki-engine/docs/codestyle): types, functions and enum values are PascalCase, constants kPascalCase, members m_PascalCase, locals and parameters camelCase. The code is formatted with clang-format 22.
- The functions the editor finds by name are PascalCase: DekiSDCardRegisterComponents, DekiSDCardGetAutoComponentCount, DekiSDCardEnsureRegistered and the rest. Built against engine ABI 21; a build of this package from before does not load and is rebuilt.
- SDCardMode values are SDMMC1Bit and SDMMC4Bit. Scenes that saved the old names still load.
Removed
- The former names from before 0.16.0 (bare class names, and deki-gpio's DekiEsp32::ESP32PinSetup). A scene that old is upgraded with 0.17 first.
이전 릴리스: CHANGELOG.md
패키지의 리플렉션 데이터에서 생성했습니다(엔진 0.19.0). 속성 이름은 씬 파일에서 쓰는 키입니다. 이름을 바꿔도 별칭이 유지됩니다(호환성).
