13.1.2. Tập lệnh, ví dụ và thư mục tài liệu

13.1.2.1. Tệp mới

Tạo một tệp mới và IDE mở một bộ đệm untitled_N.py được nạp sẵn một vòng lặp chụp tối giản -- đặt lại cảm biến, cấu hình định dạng điểm ảnh và kích thước khung hình, sau đó chụp ảnh và in tốc độ khung hình mãi mãi. Tập lệnh khởi đầu được điều chỉnh phù hợp với bo mạch đã kết nối, vì vậy nó chạy được ngay khi tạo. Bộ đệm chỉ tồn tại trong bộ nhớ: bạn có thể chỉnh sửa và chạy nó nhiều lần mà không cần lưu, điều này làm cho tệp mới trở thành cách rẻ nhất để thử nghiệm một ý tưởng. Lưu nó vào đĩa và nó trở thành một tập lệnh thông thường.

13.1.2.2. Menu ví dụ

File → Examples chứa một thư viện tập lệnh ví dụ được phân loại bao gồm hầu như mọi tính năng mà camera có -- một thư mục theo từng chủ đề, từ các ảnh chụp cơ bản qua theo dõi màu sắc, machine learning, và các ngoại vi của bo mạch. Mở một ví dụ sẽ tải nó vào bộ đệm bộ nhớ như tệp mới, vì vậy bạn có thể sửa đổi và chạy nó tự do mà không ảnh hưởng đến bản cài đặt.

Theo mặc định, menu được lọc theo bo mạch và cảm biến đã kết nối: các ví dụ cần phần cứng mà camera của bạn không có sẽ bị ẩn, và menu yêu cầu kết nối trước khi hiển thị bất cứ thứ gì. Tools → Filter examples by board and sensor type tắt bộ lọc khi bạn muốn duyệt toàn bộ bộ sưu tập.

Các ví dụ cũng được điều chỉnh khi mở. Các tập lệnh được viết cho cảm biến màu điển hình, vì vậy khi camera được kết nối khác -- cảm biến nhiệt hoặc sự kiện, một bo mạch có độ phân giải gốc khác -- IDE điều chỉnh các dòng định dạng điểm ảnh và kích thước khung hình thành các giá trị mà phần cứng của bạn hỗ trợ khi tải, và ví dụ chạy được ngay khi mở.

Duyệt qua menu ví dụ là cách nhanh nhất để tìm hiểu camera có thể làm gì; hầu hết các ứng dụng đều bắt đầu từ một ví dụ rồi phát triển thêm.

13.1.2.3. Thư mục tài liệu

Đối với các tập lệnh của riêng bạn, IDE theo dõi thư mục OpenMV bên trong thư mục tài liệu của bạn (Documents/OpenMV). Mọi thứ bạn lưu ở đó đều xuất hiện trong File → Documents Folder, bao gồm các thư mục con, vì vậy bộ sưu tập tập lệnh của bạn chỉ cách một menu. Menu đọc thư mục trực tiếp -- các tệp bạn thêm bên ngoài IDE sẽ xuất hiện vào lần tiếp theo menu mở.

IDE chạy như một phiên bản duy nhất: mở một tệp .py từ trình quản lý tệp của bạn, hoặc kéo thả nó vào cửa sổ IDE, và nó sẽ mở trong cửa sổ đang chạy thay vì khởi chạy một bản sao thứ hai.

13.1.2.4. Biên dịch chéo tập lệnh

Tools → MicroPython Tools → Copy/Convert Python File sao chép một tệp .py đến đích -- ổ đĩa của camera, khi có kết nối -- và cho phép bạn chọn điều gì xảy ra trong quá trình: sao chép nguyên vẹn, loại bỏ khoảng trắng và/hoặc chú thích để thu nhỏ, hoặc biên dịch thành tệp bytecode .mpy với trình biên dịch mpy-cross phù hợp với bo mạch đích. Tệp .mpy được import hoàn toàn giống như tệp .py mà nó xuất phát, tải nhanh hơn, và không đưa kèm mã nguồn -- đây là dạng nên dùng khi phân phối mô-đun thư viện cho hệ thống tệp của camera. Khi camera được kết nối, IDE tự động chọn bo mạch đích; nếu không, hộp thoại hỏi bo mạch nào cần biên dịch. Lựa chọn bo mạch quan trọng vì nó xác định kiến trúc bộ xử lý mà trình biên dịch nhắm đến: tệp .mpy được khớp với camera sẽ chạy nó, và tệp biên dịch cho bo mạch khác không được đảm bảo tải được.

Xem thêm

Công cụ MicroPython để biết về mpy-cross và mpremote như các công cụ dòng lệnh độc lập, và Các tệp .mpy của MicroPython để biết về định dạng tệp .mpy.