UM3088
Hướng dẫn bắt đầu nhanh bộ công cụ dòng lệnh STM32Cube
Hướng dẫn sử dụng

Giới thiệu

Tài liệu này là một hướng dẫn ngắn gọn để người dùng bắt đầu nhanh chóng với STM32CubeCLT, bộ công cụ dòng lệnh của STMicroelectronics dành cho các MCU STM32.
STM32CubeCLT cung cấp tất cả các tiện ích STM32CubeIDE được đóng gói để các IDE bên thứ ba sử dụng theo lệnh nhắc hoặc tích hợp liên tục và phát triển liên tục (CD/CI).

Gói STM32CubeCLT đơn được sắp xếp hợp lý bao gồm:

• Các phiên bản CLI (giao diện dòng lệnh) của các công cụ ST như chuỗi công cụ, tiện ích kết nối đầu dò và tiện ích lập trình bộ nhớ flash
• Hệ thống cập nhật view bộ mô tả (SVD) files
• Bất kỳ siêu dữ liệu liên quan nào khác của IDE STM32CubeCLT đều cho phép:
• Xây dựng chương trình cho các thiết bị STM32 MCU bằng chuỗi công cụ GNU nâng cao cho STM32
• Lập trình bộ nhớ trong STM32 MCU (bộ nhớ flash, RAM, OTP, v.v.) và bộ nhớ ngoài
• Xác minh nội dung lập trình (tổng kiểm tra, xác minh trong và sau khi lập trình, so sánh với file)
• Tự động hóa lập trình STM32 MCU
• Gỡ lỗi các ứng dụng thông qua giao diện của các sản phẩm STM32 MCU, cung cấp quyền truy cập vào tài nguyên nội bộ của MCU bằng các tính năng gỡ lỗi cơ bản

Thông tin chung

Bộ công cụ dòng lệnh STM32CubeCLT dành cho MCU STM32 cung cấp các công cụ để xây dựng, lập trình, chạy và gỡ lỗi các ứng dụng nhắm mục tiêu đến bộ vi điều khiển STM32 dựa trên bộ xử lý Arm® Cortex® ‑M.
Ghi chú:
Arm là thương hiệu đã đăng ký của Arm Limited (hoặc các công ty con của công ty này) tại Hoa Kỳ và / hoặc các nơi khác.

Tài liệu tham khảo

• Bộ công cụ dòng lệnh cho MCU STM32 (DB4839), tóm tắt dữ liệu STM32CubeCLT
• Hướng dẫn cài đặt STM32CubeCLT (UM3089)
• Ghi chú phát hành STM32CubeCLT (RN0132)

Ảnh chụp màn hình trong tài liệu này
Các ảnh chụp màn hình được cung cấp trong Phần 2, Phần 3 và Phần 4 chỉ làampcác tập tin sử dụng công cụ từ dấu nhắc lệnh.
Việc tích hợp trong các IDE của bên thứ ba hoặc việc sử dụng trong các tập lệnh CD/CI không được minh họa trong tài liệu này.

Xây dựng

Gói STM32CubeCLT chứa các công cụ GNU cho chuỗi công cụ STM32 để xây dựng chương trình cho bộ vi điều khiển STM32. Cửa sổ giao diện điều khiển Windows® cũample được thể hiện trong Hình 1.

1. Mở một bảng điều khiển trong thư mục dự án.
2. Thực hiện lệnh sau để xây dựng dự án: > make -j8 all -C .\Debug

Ghi chú: Tiện ích tạo có thể yêu cầu một bước cài đặt riêng.

Lập trình bảng

Gói STM32CubeCLT chứa Trình lập trình STM32Cube (STM32CubeProg), được sử dụng để lập trình bản dựng thu được trước đó vào bộ vi điều khiển STM32 đích.

1. Đảm bảo rằng kết nối ST-LINK được phát hiện
2. Chọn vị trí thư mục dự án trong cửa sổ giao diện điều khiển
3. Tùy chọn, xóa tất cả nội dung bộ nhớ flash (tham khảo Hình 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Tải lên chương trình file đến địa chỉ bộ nhớ flash 0x08000000 (tham khảo Hình 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Gỡ lỗi

Ngoài các công cụ GNU cho chuỗi công cụ STM32, gói STM32CubeCLT cũng chứa máy chủ ST-LINK GDB. Cả hai đều cần thiết để bắt đầu phiên gỡ lỗi.

1. Khởi động máy chủ ST-LINK GDB trong một cửa sổ Windows® PowerShell® khác (tham khảo Hình 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Sử dụng các công cụ GNU cho chuỗi công cụ STM32 để khởi động ứng dụng khách GDB trong cửa sổ PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) nhắm mục tiêu localhost:port từ xa (sử dụng cổng được chỉ định trong kết nối đã mở của máy chủ GDB)
   Kết nối được thiết lập và các thông báo phiên máy chủ GDB được hiển thị như trong Hình 5. Sau đó, có thể chạy các lệnh GDB trong phiên gỡ lỗi, chẳng hạn để tải lại chương trình .elf bằng GDB: > (gdb) load YOUR_PROGRAM.elf

Lịch sử sửa đổi

Bảng 1. Lịch sử sửa đổi tài liệu

Ngày	Ôn tập	Thay đổi
16-23-XNUMX	1	Phiên bản phát hành đầu tiên.

THÔNG BÁO QUAN TRỌNG – ĐỌC KỸ
STMicroelectronics NV và các công ty con (“ST”) có quyền thực hiện các thay đổi, chỉnh sửa, cải tiến, sửa đổi và cải thiện đối với các sản phẩm ST và/hoặc tài liệu này bất kỳ lúc nào mà không cần thông báo. Người mua nên tìm hiểu thông tin mới nhất có liên quan về các sản phẩm ST trước khi đặt hàng. Các sản phẩm ST được bán theo các điều khoản và điều kiện bán hàng của ST có hiệu lực tại thời điểm xác nhận đơn hàng.
Người mua chịu toàn bộ trách nhiệm về việc lựa chọn, cân nhắc và sử dụng các sản phẩm ST và ST không chịu trách nhiệm về việc hỗ trợ ứng dụng hoặc thiết kế các sản phẩm của người mua.
ST không cấp bất kỳ giấy phép nào, dù là rõ ràng hay ngụ ý, cho bất kỳ quyền sở hữu trí tuệ nào ở đây.
Việc bán lại các sản phẩm ST với các điều khoản khác với thông tin được nêu ở đây sẽ làm mất hiệu lực bất kỳ bảo hành nào mà ST cấp cho sản phẩm đó.
ST và logo ST là thương hiệu của ST. Để biết thêm thông tin về thương hiệu ST, hãy tham khảo www.st.com/trademarks. Tất cả tên sản phẩm hoặc dịch vụ khác là tài sản của chủ sở hữu tương ứng.
Thông tin trong tài liệu này thay thế và thay thế thông tin đã cung cấp trước đó trong bất kỳ phiên bản nào trước đây của tài liệu này.

UM3088 - Phiên bản 1 - Tháng 2023 năm XNUMX
Để biết thêm thông tin, hãy liên hệ với văn phòng kinh doanh STMicroelectronics tại địa phương của bạn.
www.st.com
© 2023 STMicroelectronics – Bảo lưu mọi quyền

Tài liệu / Tài nguyên

	Bộ công cụ dòng lệnh ST STM32Cube [tập tin pdf] Hướng dẫn sử dụng UM3088, Bộ công cụ dòng lệnh STM32Cube, STM32Cube, Bộ công cụ dòng lệnh, Bộ công cụ
	Bộ công cụ dòng lệnh ST STM32Cube [tập tin pdf] Hướng dẫn sử dụng RN0132, Bộ công cụ dòng lệnh STM32Cube, STM32Cube, Bộ công cụ dòng lệnh, Bộ công cụ dòng, Bộ công cụ

Tài liệu tham khảo

• Hướng dẫn sử dụng