ตั้งค่าสภาพแวดล้อมของบิลด์

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ดูแหล่งที่มาใน GitHub

หากต้องการโปรโมตการพัฒนาแบบฟรีและแบบเปิด OpenThread จะใช้ CMake ในเครื่องมือสร้างบิลด์ ปัจจุบันจําเป็นต้องใช้ชุดเครื่องมือนี้สําหรับพอร์ต OpenThread ไปยังแพลตฟอร์มฮาร์ดแวร์ใหม่

เครือเครื่องมือสร้างอื่นๆ อาจรองรับในอนาคต แต่ไม่อยู่ในขอบเขตของคู่มือการย้ายนี้

สร้างที่เก็บใหม่

ขั้นตอนแรกคือการตั้งค่าบ้านใหม่สําหรับแพลตฟอร์มฮาร์ดแวร์ ในคู่มือนี้ เราจะสร้างที่เก็บใหม่ชื่อ ot-efr32 ซึ่งมีเลเยอร์นามธรรมของแพลตฟอร์ม, SDK ของแพลตฟอร์มฮาร์ดแวร์ และสคริปต์ที่มีประโยชน์ 2-3 ตัว

ในตัวอย่างนี้ เราได้สร้างที่เก็บ SiliconLabs/ot-efr32 ใน GitHub และโคลนไปที่ ~/repos/ot-efr32

mkdir -p ~/repos
cd ~/repos
git clone git@github.com:SiliconLabs/ot-efr32.git
Cloning into 'ot-efr32'...
remote: Enumerating objects: 99, done.
remote: Counting objects: 100% (99/99), done.
remote: Compressing objects: 100% (60/60), done.
remote: Total 333 (delta 65), reused 39 (delta 39), pack-reused 234
Receiving objects: 100% (333/333), 170.78 KiB | 5.69 MiB/s, done.
Resolving deltas: 100% (194/194), done.
git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

โครงสร้างที่เก็บ

เพื่อความสอดคล้องกับที่เก็บข้อมูลของแพลตฟอร์มที่มีอยู่ในองค์กร OpenThread GitHub คุณอาจต้องกําหนดโครงสร้างที่เก็บข้อมูลดังนี้

tree -F -L 1 --dirsfirst
.
├── examples/
├── openthread/
├── script/
├── src/
├── third_party/
├── CMakeLists.txt
├── LICENSE
└── README.md
โฟลเดอร์ คำอธิบาย
examples ไม่บังคับตัวอย่างแอปพลิเคชัน
openthread ที่เก็บ openthread เป็นโมดูลย่อย
script สคริปต์สําหรับสร้าง ทดสอบ เรียกใช้
src การใช้งานเลเยอร์นามธรรมของแพลตฟอร์ม
third_party ตําแหน่งสําหรับแหล่งที่มาของบุคคลที่สาม

เพิ่มโมดูลย่อย

ขั้นตอนถัดไปคือการเพิ่ม openthread และที่เก็บอื่นๆ ที่จําเป็นเป็นโมดูลย่อย

git submodule add git@github.com:openthread/openthread.git
Cloning into '/home/user/repos/ot-efr32/openthread'...
remote: Enumerating objects: 78281, done.
remote: Counting objects: 100% (1056/1056), done.
remote: Compressing objects: 100% (488/488), done.
remote: Total 78281 (delta 639), reused 864 (delta 556), pack-reused 77225
Receiving objects: 100% (78281/78281), 76.62 MiB | 35.24 MiB/s, done.
Resolving deltas: 100% (61292/61292), done.

สําหรับตัวอย่างนี้ เราจะเพิ่มเวอร์ชันหลักจาก Silicon Labs Gecko SDK เป็นโมดูลย่อยใน third_party

cd third_party
git submodule add git@github.com:SiliconLabs/sdk_support.git
Cloning into '/home/user/repos/ot-efr32/third_party/sdk_support'...
remote: Enumerating objects: 32867, done.
remote: Counting objects: 100% (8181/8181), done.
remote: Compressing objects: 100% (3098/3098), done.
remote: Total 32867 (delta 4945), reused 7469 (delta 4732), pack-reused 24686
Receiving objects: 100% (32867/32867), 128.83 MiB | 30.91 MiB/s, done.
Resolving deltas: 100% (19797/19797), done.

สคริปต์

หากต้องการทํางานทั่วไปได้ง่ายขึ้น คุณอาจต้องสร้างสคริปต์ในโฟลเดอร์ script ซึ่งอาจรวมถึงสคริปต์สําหรับงานต่างๆ เช่น การบูต การสร้าง การเรียกใช้โค้ด Linux และสคริปต์การทดสอบสําหรับการตรวจสอบ GitHub CI

ด้านล่างคือตัวอย่างสคริปต์ที่เป็นมาตรฐานสําหรับที่เก็บแพลตฟอร์มส่วนใหญ่

bootstrap

สคริปต์นี้ควรติดตั้งเครื่องมือและแพ็กเกจทั้งหมดที่จําเป็นสําหรับแพลตฟอร์มฮาร์ดแวร์ของคุณ นอกจากนี้ควรเรียกใช้สคริปต์ Bootsrap ของ openthread&#39 เพื่อให้แน่ใจว่าผู้ใช้มีทุกสิ่งที่จําเป็นในการสร้างสแต็ก OpenThread

ดูตัวอย่างจากสคริปต์รองเท้าบู๊ตใน ot-efr32

build

สคริปต์บิลด์ CMake ควรอนุญาตให้ผู้ใช้สร้างสแต็ก OpenThread สําหรับแพลตฟอร์มของคุณได้ หากที่เก็บของคุณกําหนดแอปพลิเคชันตัวอย่าง สคริปต์นี้ควรสร้างแอปพลิเคชันเหล่านั้นด้วย สคริปต์นี้ควรมีตัวเลือกการกําหนดค่าระบบพื้นฐาน รวมถึงคําจํากัดความมาโครที่เฉพาะเจาะจงของแพลตฟอร์ม

ดูตัวอย่างได้ที่สร้างสคริปต์ใน ot-efr32

test

สคริปต์การทดสอบอาจเป็นประโยชน์สําหรับผู้ใช้ในการทดสอบการเปลี่ยนแปลงโดยใช้การทดสอบที่คุณกําหนดขึ้น ซึ่งอาจเป็นอะไรง่ายๆ ก็ได้ เช่น การเรียกใช้การตรวจสอบความถูกต้อง หรือความซับซ้อนเหมือนการเปิดตัวชุดทดสอบหน่วย

ใน ot-efr32 สคริปต์จะเรียกใช้สคริปต์ build สําหรับกระดานที่รองรับทั้งหมดในแต่ละแพลตฟอร์ม efr32

ดูตัวอย่างได้ที่สคริปต์การทดสอบใน ot-efr32

make-pretty

สคริปต์นี้ควรจัดรูปแบบโค้ด สคริปต์ และไฟล์มาร์กดาวน์เพื่อให้การจัดรูปแบบสอดคล้องกัน

คุณจะกําหนดสคริปต์นี้ด้วยตนเองได้ แต่การใช้สคริปต์ make-pretty ที่พื้นที่เก็บข้อมูลแพลตฟอร์มที่มีอยู่กําลังใช้ที่ง่ายที่สุดอาจเป็นวิธีที่ง่ายที่สุด สคริปต์นี้จะเรียกใช้สคริปต์รูปแบบ openthread' ซึ่งช่วยให้แน่ใจว่าจะมีรูปแบบที่สอดคล้องกันในที่เก็บข้อมูล OpenThread ทั้งหมด

การกําหนดค่าสคริปต์ Linker

สคริปต์ GNU Linker อธิบายวิธีจับคู่ทุกส่วนในไฟล์อินพุต (.o "Object" ไฟล์ที่สร้างโดย GNU Compiler Collection (GCC)) กับไฟล์เอาต์พุตสุดท้าย (เช่น .elf) และยังกําหนดตําแหน่งที่เก็บข้อมูลของแต่ละส่วนที่ดําเนินการได้ รวมถึงที่อยู่ที่ป้อน สคริปต์ Linker เฉพาะแพลตฟอร์มมักจะมาพร้อมกับ BSP ของแพลตฟอร์ม

กําหนดค่าเครื่องมือ ld ให้ชี้ไปยังสคริปต์ Linker ที่เจาะจงแพลตฟอร์มโดยใช้ target_link_libraries บนเป้าหมาย CMake ของแพลตฟอร์มใน src/CMakeLists.txt ดังนี้

set(LD_FILE "${CMAKE_CURRENT_SOURCE_DIR}/efr32mg12.ld")

target_link_libraries(openthread-efr32mg12
    PRIVATE
        ot-config
    PUBLIC
        -T${LD_FILE}
        -Wl,--gc-sections -Wl,-Map=$.map
)

โค้ดเริ่มต้นใช้งานเครื่องมือเชน

โค้ดเริ่มต้นใช้งานของเครื่องมือในเชนมักจะมาพร้อมกับ BSP ของแพลตฟอร์ม โดยทั่วไปโค้ดนี้จะมีลักษณะดังนี้

  1. ใช้ฟังก์ชันรายการบันทึก (Reset_Handler) ของโปรแกรมปฏิบัติการ
  2. กําหนดตารางเวกเตอร์ที่รบกวน
  3. เริ่มต้นฮีปและสแต็ก
  4. คัดลอกส่วน .data จากหน่วยความจําที่ไม่มีการเปลี่ยนแปลงไปยัง RAM
  5. ข้ามไปยังฟังก์ชันหลักของแอปพลิเคชันเพื่อเรียกใช้ตรรกะของแอปพลิเคชัน

ต้องใส่โค้ดเริ่มต้น (C หรือซอร์สโค้ดของ Assembly) ในไลบรารี openthread-platform-name ของแพลตฟอร์ม มิฉะนั้นคุณอาจคัดลอกตัวแปรที่สําคัญบางอย่างในสคริปต์ Linker อย่างไม่ถูกต้องได้

  • src/CMakeLists.txt

ตัวอย่าง: startup-gcc.c ใน ot-cc2538 - src/CMakeLists.txt

add_library(openthread-cc2538
    alarm.c
...
    startup-gcc.c
...
    system.c
    logging.c
    uart.c
    $
)