Comments - Viết tài liệu tham khảo trong khi viết code Arduino

Giới thiệu

Bạn rất khó ghi nhớ từng dòng code một trong một chương trình thật là dài, với những thuật toán phức tạp, vì vậy Arduino đã làm cho bạn một cú pháp để giải quyết vấn đề này, đó là Comments. Comments sẽ giúp bạn ghi chú cho từng dòng code hoặc trình bày nhiệm vụ của nó để bạn hoặc những người khác có thể hiểu được chương trình này làm được những gì. Và comments sẽ không được Arduino biên dịch nên cho dù bạn viết nó dài đến đâu thì cũng không ảnh hưởng đến bộ nhớ flash của vi điều khiển. Để comments trong Arduino, bạn có 2 cách.

Ví dụ

 x = 5;  // Đây là kiểu "single line comment", để làm được điều này, bạn gõ "//"
         // nó sẽ ghi chú tất cả những chữ (text, câu lệnh,... everything) nằm sau dấu // cho đến khi hết dòng

/* Còn đây là "multiline comment" - Bạn bắt đầu ghi chú với ký tự kia.
Nó sẽ "ghi chú" tất cả những gì nằm trong cặp dấu "/ *" và "* /" ( không có dấu cách nhé)
if (gwb == 0){   // ngoài ra bạn có thể dùng single line trong này.
x = 3;           /* nhưng dùng một multiline comment khác thì sẽ bị lỗi cú pháp ngay */
}
// và đừng bao giờ quên ký tự đóng "* /" (ko có dấu cách) nhé!
*/

Gợi ý

Bạn sẽ dùng "single line comment" khi bạn cần ghi chú một đoạn code, ví dụ như ghi cách hiểu nó, nó trả về cái gì,..

Bạn sẽ dùng "multiline comment" để debug. Khi bạn thêm một đoạn code mới vô và cô tình làm cho chương trình hoạt động lỗi thì bạn hãy thử dùng multiline comment để đánh dấu là ghi chú những dòng đó (chương trình dịch sẽ bỏ qua). Sau đó, bạn xem thử chương trình có chạy đúng hay không, nếu có lỗi thì mở rộng single line comment lên những dòng code trước đó nữa, còn nếu không thì bạn thu hẹp multiline comment lại và tiếp tục thực hiện những gì tôi vừa ghi!

Reference Tags: 
lên
11 thành viên đã đánh giá bài viết này hữu ích.
Các bài viết cùng tác giả

Bài 2: Download Arduino IDE dành cho mạch Intel Galileo

Ở bài viết này, tớ sẽ hướng dẫn bạn tải về phiên bản Arduino được Intel phát triển để lập trình mạch Intel Galileo. Bản Arduino hơi nặng một tí nhưng đã được chỉnh sửa phù hợp cho việc lập trình mạch Intel Galileo. Tớ sẽ hướng dẫn chi tiết từng bước. Từ đó, các bạn sẽ cài đặt được ngay thôi!

lên
2 thành viên đã đánh giá bài viết này hữu ích.

Kết nối điều khiển từ xa sử dụng ESP8266 và Arduino với hệ thống firmware iNut Cảm biến CloudMQTT - 1000 firmware miễn phí

Chuyện kể rằng, có 02 sinh viên Việt Nam, trong lúc làm đồ án đại học kết nối điều khiển từ xa qua Internet. Một người thì chọn phương án truyền thống sử dụng máy tính làm máy chủ và demo các tính năng theo yêu cầu đồ án. Người còn lại biết đến iNut Sensor và tìm cách tối ưu hóa phần mềm và phần cứng nhằm chau chuốt cho đồ án của mình trở nên "xịn" và "nhiều tính năng bá đạo". Đến lúc bảo vệ đồ án, cậu sinh viên 01 cảm thấy choáng ván với muôn vàn vấn đề từ việc nơi trình bày đồ án không có wifi, mạng chập chờn, máy tính mở không lên, đứt cáp biển,... Cuối cùng cũng bảo vệ được với điểm số không ưng ý lắm dù tốn rất nhiều thời gian và công sức. Cậu còn lại nhờ vào việc chau chuốt phần mềm, tối ưu hóa và comment kĩ từng lệnh trong dòng code, viết báo cáo bài bản chuẩn bị slide như ý, dùng điện thoại cài wifi, quét mã QRcode để chia sẻ quyền truy cập đến phần mềm rất chuyên nghiệp, mọi thứ cậu chủ động hoàn toàn mà không bị các vấn đề "học tài thi phận" bủa vây mà kết quả hết sức mĩ mãn, điểm số mĩ miều, kiến thức IoT được chuẩn hóa. Thực vậy, các dự án, đồ án sử dụng nền tảng iNut Platform bên dưới cho phép các bạn sinh viên làm các dự án hết sức hoàn hảo: từ xe điều khiển, bãi giữ xe thông minh, hệ thống máy lạnh, máy bơm, điều hòa thông minh,... do chinh các bạn tự làm nên đã đạt được những điểm số tốt và tuyệt đối. Cũng chính vì thế, iNut JSC (công ty chủ quản của iNut Platform) đã kết hợp với Khu Công nghệ phần mềm - ĐHQGHCM để tổ chức những khóa đào tạo ngắn hạn cho sinh viên Việt Nam sử dụng nền tảng IoT do iNut JSC phát triển. Và để mở con đường tri thức tiếp cận IoT trong nháy mắt, iNut JSC đã tạo ra một phiên bản firmware trị giá 50.000 đồng sử dụng clouding của CloudMQTT và tài trợ 1000 firmware cho tất cả các bạn học sinh, sinh viên Việt Nam có thể tiếp cận IoT một cách dễ dàng và nhanh chóng nhất!

lên
14 thành viên đã đánh giá bài viết này hữu ích.