Bài học và trò chơi học tập

Viết thư viện Arduino của riêng bạn

Viết TinyDigits, driver màn hình TM1637, từ tài liệu kỹ thuật, và đóng gói thành file zip ai cũng cài được.

Cách hoạt động

Viết thư viện Arduino của riêng bạn là một khóa trung cấp về C++ trên Arduino Uno. Mỗi bài chạy trên thiết bị ngày tận thế trong thư viện dự án: một màn hình bốn số TM1637 ở A0 (CLK) và A1 (DIO), ba nút nhấn ở chân 6, 7 và 8, và ba bóng đèn ở chân 2, 3 và 4.

Bài đầu tiên mở một tab. Từ bài thứ hai trở đi, bo mạch mở với ba tab: TinyDigits.h, TinyDigits.cpp và sketch, như một thư viện thật và sketch dùng nó. Bạn chạy, rồi sửa thư viện và chạy lại. Một số bước kiểm tra đọc serial monitor, một số đếm các đoạn sáng của màn hình, nên một bước về vẽ 01:30 chỉ được tính là qua khi 01:30 thật sự hiện trên màn hình.

Các bài học

  1. Header và .cpp: một driver bit-bang từ tài liệu kỹ thuật (start, stop, tám bit LSB trước và một ACK ở xung thứ chín), tách thành một header nói nó làm gì và một .cpp nói nó làm thế nào. Include guard, static cho phần riêng tư, và extern cho quy tắc định nghĩa duy nhất.
  2. Thiết kế class: TinyDigits như một class. Một constructor không chạm vào phần cứng, begin() báo lại xem chip có trả lời hay không, các method từ chối những gì chúng không làm được, một method mới, một đối số mặc định, và một màn hình thứ hai trên các chân chưa nối dây nào.
  3. Ví dụ: một demo "mọi thứ trong một" được thay bằng ba ví dụ, mỗi ví dụ dạy một điều: HelloDigits, một Countdown với nút nhấn và một SelfTest.
  4. Tài liệu và từ khóa: các chú thích tài liệu ghi rõ khoảng giá trị và lỗi, phần trợ giúp in ra từ chính các hằng số của thư viện, một tài liệu hứa -9999 trong khi bốn chữ số dừng ở -999, và keywords.txt cho IDE.
  5. Versioning: MAJOR.MINOR.PATCH as numbers a sketch tests in #if, a patch for a tidy-up that blanked zero, and a breaking change to setBrightness that earns 2.0.0.
  6. Đóng zip và chia sẻ: bố cục thư viện Arduino, library.properties in ra từ file header để phiên bản chỉ nằm ở một nơi, một bước kiểm tra trước khi phát hành từ chối xuất bản, và file zip được cài bằng + Add library trong Mokxi và Add .ZIP Library trong Arduino IDE.

Dự án: đồng hồ nhiệm vụ

Đếm ngược phóng tên lửa trên thư viện hoàn chỉnh, với các nút nhấn START, HOLD và RESET, đèn báo cho đếm ngược, cất cánh và tạm dừng, cùng nhịp millis() không bao giờ lệch. Bạn thêm showText() vào thư viện như một bản phát hành phụ (2.1.0), để đồng hồ hiển thị GO lúc cất cánh, rồi biến nó thành của bạn: đếm phút với dấu hai chấm, ba giây cuối nhấp nháy, hoặc một màn hình thứ hai.

Những điều bo mạch Uno làm khác

  • Một tab sketch được Arduino cho sẵn các tên; một tab .cpp phải bắt đầu bằng #include <Arduino.h>, giống như trong Arduino IDE.
  • TM1637 không dùng I2C, nên driver dùng hai chân thông thường. A0 và A1 hoạt động như chân số 14 và 15.
  • Thư viện dùng chính điện trở kéo của chip (INPUT_PULLUP) để hai đường dây được kéo lên mức cao, nên một chân không nối gì sẽ đọc là mức cao và begin() không thấy ACK.
  • Một int trên Uno có 16 bit, nên showNumber giữ các chữ số của nó trong một unsigned int và khoảng giá trị trong -999 đến 9999.

Trước và sau

C++ cho chương trình thực tế đề cập các class, tham chiếu và file header mà khóa học này dựa trên đó. Thư viện hoàn chỉnh dùng được trong mọi dự án: thêm file zip vào Libraries và include bằng dấu ngoặc nhọn.