UM3088
คู่มือเริ่มต้นใช้งานชุดเครื่องมือบรรทัดคำสั่ง STM32Cube อย่างย่อ
คู่มือการใช้งาน

การแนะนำ

เอกสารนี้เป็นคำแนะนำโดยย่อสำหรับผู้ใช้ในการเริ่มต้นอย่างรวดเร็วด้วย STM32CubeCLT ซึ่งเป็นชุดเครื่องมือบรรทัดคำสั่งของ STMicroelectronics สำหรับ STM32 MCU
STM32CubeCLT นำเสนอสิ่งอำนวยความสะดวก STM32CubeIDE ทั้งหมดที่จัดทำเป็นแพ็คเกจสำหรับการใช้พรอมต์คำสั่งโดย IDE ของบุคคลที่สาม หรือการรวมอย่างต่อเนื่องและการพัฒนาอย่างต่อเนื่อง (CD/CI)

แพ็คเกจ STM32CubeCLT เดี่ยวที่มีความคล่องตัวประกอบด้วย:

• เครื่องมือ ST เวอร์ชัน CLI (อินเทอร์เฟซบรรทัดคำสั่ง) เช่น toolchain ยูทิลิตีการเชื่อมต่อโพรบ และยูทิลิตีการเขียนโปรแกรมหน่วยความจำแฟลช
• ระบบที่ทันสมัย view คำอธิบาย (SVD) files
• ข้อมูลเมตาอื่น ๆ ที่เกี่ยวข้องกับ IDE STM32CubeCLT อนุญาต:
• สร้างโปรแกรมสำหรับอุปกรณ์ STM32 MCU โดยใช้ GNU toolchain ที่ปรับปรุงแล้วสำหรับ STM32
• การเขียนโปรแกรมหน่วยความจำภายใน STM32 MCU (หน่วยความจำแฟลช, RAM, OTP และอื่นๆ) และหน่วยความจำภายนอก
• การตรวจสอบเนื้อหาการเขียนโปรแกรม (การตรวจสอบความถูกต้อง การตรวจสอบระหว่างและหลังการเขียนโปรแกรม การเปรียบเทียบกับ file)
• การตั้งโปรแกรม STM32 MCU โดยอัตโนมัติ
• การดีบักแอปพลิเคชันผ่านอินเทอร์เฟซของผลิตภัณฑ์ STM32 MCU ซึ่งให้การเข้าถึงทรัพยากรภายใน MCU โดยใช้คุณสมบัติการดีบักพื้นฐาน

ข้อมูลทั่วไป

ชุดเครื่องมือบรรทัดคำสั่ง STM32CubeCLT สำหรับ STM32 MCU มีเครื่องมือสำหรับสร้าง ตั้งโปรแกรม เรียกใช้ และดีบักแอปพลิเคชันที่กำหนดเป้าหมายไปยังไมโครคอนโทรลเลอร์ STM32 ซึ่งใช้โปรเซสเซอร์ Arm® Cortex® ‑M
บันทึก:
Arm เป็นเครื่องหมายการค้าจดทะเบียนของ Arm Limited (หรือบริษัทในเครือ) ในสหรัฐอเมริกาและ/หรือที่อื่นๆ

เอกสารอ้างอิง

• ชุดเครื่องมือบรรทัดคำสั่งสำหรับ STM32 MCU (DB4839), ข้อมูลสรุป STM32CubeCLT
• คู่มือการติดตั้ง STM32CubeCLT (UM3089)
• บันทึกประจำรุ่น STM32CubeCLT (RN0132)

ภาพหน้าจอในเอกสารนี้
ภาพหน้าจอที่ระบุไว้ในส่วนที่ 2 ส่วนที่ 3 และส่วนที่ 4 เป็นเพียงตัวอย่างampไฟล์การใช้งานเครื่องมือจากพรอมต์คำสั่ง
การผสานรวมใน IDE ของบุคคลที่สามหรือการใช้งานในสคริปต์ CD/CI ไม่ได้แสดงไว้ในเอกสารนี้

อาคาร

แพ็คเกจ STM32CubeCLT มีเครื่องมือ GNU สำหรับ STM32 toolchain เพื่อสร้างโปรแกรมสำหรับไมโครคอนโทรลเลอร์ STM32 หน้าต่างคอนโซล Windows® เช่นampไฟล์แสดงในรูปที่ 1

1. เปิดคอนโซลในโฟลเดอร์โครงการ
2. ดำเนินการคำสั่งต่อไปนี้เพื่อสร้างโครงการ: > make -j8 all -C .\Debug

บันทึก: ยูทิลิตี make อาจต้องมีขั้นตอนการติดตั้งแยกต่างหาก

การเขียนโปรแกรมบอร์ด

แพ็คเกจ STM32CubeCLT ประกอบด้วย STM32CubeProgrammer (STM32CubeProg) ซึ่งใช้เพื่อตั้งโปรแกรมบิลด์ที่ได้รับก่อนหน้านี้ในไมโครคอนโทรลเลอร์ STM32 เป้าหมาย

1. ตรวจสอบให้แน่ใจว่าตรวจพบการเชื่อมต่อ ST-LINK
2. เลือกตำแหน่งโฟลเดอร์โครงการในหน้าต่างคอนโซล
3. เลือกลบเนื้อหาหน่วยความจำแฟลชทั้งหมด (ดูรูปที่ 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. อัพโหลดโปรแกรม file ไปยังที่อยู่หน่วยความจำแฟลช 0x08000000 (อ้างอิงจากรูปที่ 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

การแก้จุดบกพร่อง

นอกจากเครื่องมือ GNU สำหรับ STM32 toolchain แล้ว แพ็คเกจ STM32CubeCLT ยังมีเซิร์ฟเวอร์ ST-LINK GDB อีกด้วย จำเป็นต้องใช้ทั้งสองอย่างเพื่อเริ่มเซสชันดีบัก

1. เริ่มเซิร์ฟเวอร์ ST-LINK GDB ในหน้าต่าง Windows® PowerShell® อื่น (อ้างอิงจากรูปที่ 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. ใช้เครื่องมือ GNU สำหรับ STM32 toolchain เพื่อเริ่มไคลเอนต์ GDB ในหน้าต่าง PowerShell®:
   > arm-ไม่มี eabi-gdb.exe
   > (gdb) กำหนดเป้าหมายรีโมต localhost:port (ใช้พอร์ตที่ระบุในการเชื่อมต่อเซิร์ฟเวอร์ GDB ที่เปิดอยู่)
   การเชื่อมต่อถูกสร้างขึ้นและข้อความเซสชันของเซิร์ฟเวอร์ GDB จะแสดงดังแสดงในรูปที่ 5 จากนั้นจึงเป็นไปได้ที่จะเรียกใช้คำสั่ง GDB ในเซสชันการดีบัก เช่น โหลดโปรแกรม .elf ใหม่โดยใช้ GDB: > (gdb) โหลด YOUR_PROGRAM.elf

ประวัติการแก้ไข

ตารางที่ 1 ประวัติการแก้ไขเอกสาร

วันที่	การแก้ไข	การเปลี่ยนแปลง
16 ก.พ. 23	1	การเปิดตัวครั้งแรก

หมายเหตุสำคัญ - โปรดอ่านอย่างละเอียด
STMicroelectronics NV และบริษัทในเครือ (“ST”) ขอสงวนสิทธิ์ในการเปลี่ยนแปลง แก้ไข ปรับปรุง ปรับเปลี่ยน และปรับปรุงผลิตภัณฑ์ ST และ/หรือเอกสารนี้ได้ตลอดเวลาโดยไม่ต้องแจ้งให้ทราบ ผู้ซื้อควรได้รับข้อมูลล่าสุดที่เกี่ยวข้องกับผลิตภัณฑ์ ST ก่อนทำการสั่งซื้อ ผลิตภัณฑ์ ST จะถูกขายตามข้อกำหนดและเงื่อนไขการขายของ ST ที่ใช้ในขณะที่ยืนยันคำสั่งซื้อ
ผู้ซื้อจะต้องรับผิดชอบแต่เพียงผู้เดียวในการเลือก การคัดเลือก และการใช้ผลิตภัณฑ์ ST และ ST จะไม่รับผิดชอบต่อความช่วยเหลือในการใช้งานหรือการออกแบบผลิตภัณฑ์ของผู้ซื้อ
ST ไม่อนุญาตให้มีใบอนุญาตใดๆ ไม่ว่าโดยชัดแจ้งหรือโดยนัยในสิทธิในทรัพย์สินทางปัญญาใดๆ
การขายต่อผลิตภัณฑ์ ST ที่มีข้อกำหนดแตกต่างจากข้อมูลที่กำหนดไว้ในที่นี้ จะทำให้การรับประกันใดๆ ที่ ST ให้ไว้สำหรับผลิตภัณฑ์ดังกล่าวเป็นโมฆะ
ST และโลโก้ ST เป็นเครื่องหมายการค้าของ ST สำหรับข้อมูลเพิ่มเติมเกี่ยวกับเครื่องหมายการค้า ST โปรดดูที่ www.st.com/trademarksชื่อผลิตภัณฑ์หรือบริการอื่น ๆ ทั้งหมดเป็นทรัพย์สินของเจ้าของที่เกี่ยวข้อง
ข้อมูลในเอกสารฉบับนี้แทนที่และเปลี่ยนแทนข้อมูลที่เคยให้ไว้ก่อนหน้านี้ในเอกสารฉบับก่อนหน้าใดๆ

UM3088 – Rev 1 – กุมภาพันธ์ 2023
สำหรับข้อมูลเพิ่มเติม โปรดติดต่อสำนักงานขาย STMicroelectronics ในพื้นที่ของคุณ
www.st.com
© 2023 STMicroelectronics – สงวนลิขสิทธิ์

เอกสาร / แหล่งข้อมูล

	ชุดเครื่องมือบรรทัดคำสั่ง ST STM32Cube [พีดีเอฟ] คู่มือการใช้งาน UM3088, ชุดเครื่องมือบรรทัดคำสั่ง STM32Cube, STM32Cube, ชุดเครื่องมือบรรทัดคำสั่ง, ชุดเครื่องมือ
	ชุดเครื่องมือบรรทัดคำสั่ง ST STM32Cube [พีดีเอฟ] คู่มือเจ้าของ RN0132, ชุดเครื่องมือบรรทัดคำสั่ง STM32Cube, STM32Cube, ชุดเครื่องมือบรรทัดคำสั่ง, ชุดเครื่องมือบรรทัด, ชุดเครื่องมือ

อ้างอิง

• คู่มือการใช้งาน