Trình soạn thảo

Trình gỡ lỗi

Dừng một bo mạch ngay trên một dòng code của chính bạn, xem nó đang làm gì, rồi đi từng bước qua code trong khi mạch vẫn giữ nguyên đúng như lúc dừng.

Nó dùng để làm gì

Một LED nhấp nháy cho bạn biết bo mạch còn sống. Nhưng nó không cho bạn biết count là bao nhiêu khi đèn tắt, hay nhánh code bạn vừa viết có được chạy không. Trình gỡ lỗi làm được điều đó: nhấn Chạy, dừng bo mạch tại một dòng, và đọc thanh ghi cùng chính các biến của bạn tại khoảnh khắc đó.

Khi bo mạch dừng lại, mọi thứ khác cũng dừng theo. LED giữ nguyên độ sáng nó đang có, servo giữ nguyên góc, bộ định thời của chip dừng ngay chỗ đó. Nên khi bạn nhấn Tiếp tục, millis() tiếp tục từ lệnh bạn đang xem chứ không nhảy tới theo thời gian bạn dành để đọc.

Đặt một breakpoint

Nhấn vào rãnh hẹp bên trái của số dòng. Một chấm đỏ xuất hiện, và bo mạch sẽ dừng trước khi dòng đó chạy: những gì bạn thấy trên màn hình vẫn chưa xảy ra.

Nhấn Chạy. Một bo mạch có breakpoint luôn được biên dịch từ các tệp trước mặt bạn, kể cả khi phần Firmware của bo mạch ghi tên một chương trình tích hợp sẵn. Breakpoint nằm trên một dòng của chính code này, còn các chương trình tích hợp sẵn không kèm thông tin cho biết dòng tương ứng với lệnh nào.

Nhấn lại vào chấm để gỡ nó. Gỡ hết trong thẻ Gỡ lỗi gỡ mọi breakpoint trên bo mạch đó cùng lúc.

Một thẻ assembly có cùng rãnh và hoạt động giống hệt. Một breakpoint trên một dòng của tệp .S dừng ngay tại dòng đó, vì số dòng mà bản biên dịch ghi lại là của chính thẻ đó chứ không phải của bản đã tiền xử lý.

Chấm rỗng

Chấm rỗng nghĩa là breakpoint vẫn ở chỗ bạn đặt và không làm gì: trình biên dịch không tạo lệnh nào cho dòng đó. Dòng trống, chú thích, khai báo không có code và dòng bị bộ tối ưu gộp đi đều trông như thế này. Hãy chuyển nó sang dòng kế tiếp có làm việc gì đó.

Thanh công cụ bên cạnh Chạy

Tạm dừng dừng bo mạch ở bất kỳ đâu. Nó trở thành Tiếp tục, cho bo mạch chạy tiếp.

Bước qua chạy đúng một dòng source, bao gồm cả lời gọi: một dòng gọi delay(500) tốn 500 ms thời gian mô phỏng và phần còn lại của mạch sống qua toàn bộ thời gian đó, vì đó là điều thực sự xảy ra.

Bước vào chạy đến dòng kế tiếp mà bo mạch đến, là dòng đầu tiên của một hàm mà dòng hiện tại gọi.

Một bước có thể bị cắt ngắn bởi một breakpoint ở phía sau, nó sẽ dừng ở đó và báo cho bạn biết. Breakpoint duy nhất không bao giờ cắt ngắn một bước là cái mà bước xuất phát từ đó: một ngắt xảy ra ngay lúc đó (một bộ định thời, một chân, cái tick mà millis() đếm) sẽ chạy trình xử lý của nó rồi trao bo mạch lại cho đúng dòng bạn đang đứng, và dừng ở đó có nghĩa là lần nhấn chẳng làm gì cả.

Bước ra bị mờ, và tooltip của nó giải thích lý do: nó phải tính ra hàm hiện tại quay về đâu, mà trình gỡ lỗi không đọc call stack. Thay vào đó, hãy đặt breakpoint ở dòng ngay sau lời gọi.

Bước theo lệnh, trong phần Disassembly của thẻ Gỡ lỗi, chạy đúng một lệnh máy thay vì cả một dòng.

Trên điện thoại, thanh này chuyển vào thẻ Gỡ lỗi, nơi có đủ chỗ cho nó.

Thẻ Gỡ lỗi

Bên cạnh Serial Monitor ở dưới cùng cửa sổ (thẻ riêng trên trang tính ở điện thoại), với năm thứ bên trong.

Nơi nó dừng, trong một dòng: tệp và dòng, địa chỉ, và lý do dừng: một breakpoint, một bước, hoặc Tạm dừng. Khi bảng dòng không phủ địa chỉ đó, nó hiện địa chỉ và nói rõ, thay vì đoán một dòng không chắc chắn. "Bên trong sketch.ino:14" nghĩa là bo mạch đang ở giữa dòng đó chứ không phải đầu dòng, và vùng đánh dấu trong khung code được vẽ mờ hơn cho khớp.

Thanh ghi, dưới đúng tên mà lõi dùng: a0 và sp trên ESP32-C3, r24 và sreg trên Uno. Chúng được đọc từ lõi tại thời điểm dừng, nên là giá trị hiện tại chứ không phải của lần trước. pc đứng đầu tiên, và là lệnh sẽ chạy tiếp theo.

Thanh ghi trạng thái cũng được viết rõ nghĩa bên cạnh giá trị số, vì tám bit không phải một giá trị. Trên AVR, sreg hiện các cờ của nó là ITHSVNZC, với dấu chấm thay cho mỗi cờ bằng 0, nên ngay sau một lệnh cp, bạn nhìn một cái là biết nhánh có được chạy không. Trên bo mạch ARM, xpsr hiện N Z C V Q theo cách tương tự.

Disassembly là mã máy quanh chỗ dừng. Mỗi dòng là một lệnh: địa chỉ, các byte, bản thân lệnh theo cách viết của llvm-objdump, và dòng source mà lệnh bắt đầu, là một nút đưa bạn đến dòng đó trong khung code. Lệnh sắp chạy được đánh dấu. Bước theo lệnh, ở đầu phần này, chạy đúng lệnh đó rồi vẽ lại danh sách.

Đây là khung hiển thị nên mở trên một thẻ .S: dòng bạn viết nằm cạnh các byte mà nó dịch ra. Nó cũng dùng tốt cho một sketch, nơi nó cho thấy trình biên dịch đã làm gì với một dòng C++. Một bo mạch chưa được biên dịch từ tệp của nó sẽ báo như vậy, vì chưa có chương trình nào để đọc cho tới khi bạn nhấn Chạy.

Watch nhận tên của một biến toàn cục. Gõ vài ký tự là nó gợi ý những biến có trong chương trình. Mỗi dòng hiện kiểu như trình biên dịch đã ghi và kiểu đó chiếm bao nhiêu byte, rồi giá trị, được đọc từ bộ nhớ bo mạch ở mỗi lần dừng. Một tên không có trong chương trình sẽ báo rõ thay vì hiện số không. Một struct hoặc một mảng hiện các byte của nó, địa chỉ thấp trước, vì đó là các byte chứ không phải một số duy nhất.

Breakpoints liệt kê mọi breakpoint trên bo mạch này cùng địa chỉ mà nó đã giải ra. Nhấn vào một cái để nhảy tới đó trong code.

Serial Monitor đang làm gì trong lúc đó

Không có gì thay đổi. Mọi thứ bo mạch đã in trước khi dừng vẫn còn đó, và những gì nó in sau khi bạn tiếp tục sẽ nối ngay bên dưới. Dừng một bo mạch không có nghĩa là dừng cả lần chạy.

Hai bo mạch

Mỗi bo mạch có breakpoint riêng, danh sách theo dõi riêng và trạng thái dừng riêng. Trình gỡ lỗi tác động lên bo mạch mà khung code đang hiển thị, tức là bo mạch được chọn trong ô chọn phía trên các tab.

Những bo mạch nào được hỗ trợ

Tất cả. Mọi bo mạch mà Mokxi có đều đáp ứng trình gỡ lỗi: ESP32-C3 và ESP32-C6, ESP32 và ESP8266, Arduino Uno, Nano, Mega, Leonardo và Uno R4 Minima, ATtiny85, Raspberry Pi Pico và Pico W, STM32 Black Pill và Blue Pill, BBC micro:bit và Seeed XIAO SAMD21.

Các thanh ghi là những thanh ghi mà core của bo mạch có, theo đúng tên trong tài liệu của nó: a0 và sp trên ESP32-C3, r24 và sreg trên AVR, r0, lr và xpsr trên bất kỳ bo mạch nào có chip ARM, a0 đến a15 trên các bo mạch Xtensa (ESP32, ESP32-S3 và ESP8266). Vì vậy, những gì bạn đọc trong bảng chính là những gì bạn sẽ đọc được trên linh kiện thật.

Bước ra bị mờ trên mọi bo mạch, vì lý do mà chú thích của nó nêu ra.

Thanh công cụ vẫn có thể tự mờ đi, vì một lý do hoàn toàn không liên quan đến việc đó là bo mạch nào: chưa có gì đang chạy, hoặc linh kiện mà khung code đang hiển thị không chạy chương trình nào cả (một điện trở thì không thể dừng được). Một bo mạch mà trình gỡ lỗi thực sự không hỗ trợ sẽ tự xưng danh ("Trình gỡ lỗi chưa hỗ trợ mega1."), và giờ không còn bo mạch nào như vậy. Một bo mạch được hỗ trợ thì không bao giờ bị mờ vì thiếu breakpoint: Tạm dừng hoạt động ngay khi bo mạch đang chạy, có breakpoint hay không.