Hướng dẫn kết nối OpenLog

Giới thiệu

Lưu ý! Hướng dẫn này dành cho Open Log cho UART nối tiếp [ DEV-13712 ]. Nếu bạn đang sử dụng Qwiic OpenLog cho IC [ DEV-15164 ], vui lòng tham khảo Hướng dẫn kết nối Qwiic OpenLog.
OpenLog Data Logger là giải pháp mã nguồn mở, dễ sử dụng để ghi dữ liệu tuần tự từ các dự án của bạn. OpenLog cung cấp giao diện tuần tự đơn giản để ghi dữ liệu từ dự án vào thẻ nhớ microSD.SparkFun Mở Nhật Ký
• PHÁT TRIỂN-13712SparkFun OpenLog với Tiêu đề
• PHÁT TRIỂN-13955

không tìm thấy sản phẩm
Vật liệu cần thiết
Để thực hiện đầy đủ hướng dẫn này, bạn sẽ cần các phần sau. Tuy nhiên, bạn có thể không cần tất cả mọi thứ tùy thuộc vào những gì bạn có. Thêm vào giỏ hàng, đọc kỹ hướng dẫn và điều chỉnh giỏ hàng nếu cần.
Hướng dẫn kết nối OpenLog Danh sách mong muốn của SparkFun

	Arduino Pro Mini 328 – 3.3V/8 MHz PHÁT TRIỂN-11114 Nó màu xanh! Nó mỏng! Nó là Arduino Pro Mini! Phương pháp thiết kế tối giản của SparkFun dành cho Arduino. Đây là Arduino 3.3V …
	SparkFun FTDI Cơ bản Breakout – 3.3V PHÁT TRIỂN-09873 Đây là phiên bản mới nhất của [FTDI Basic](http://www.sparkfun.com/commerce/product_info.php?products_id=…
	Cáp USB SparkFun Cerberus – 6ft CAB-12016 Bạn đã dùng sai cáp USB. Không quan trọng bạn dùng loại nào, đó là loại sai. Nhưng nếu bạn có thể…
	SparkFun Mở Nhật Ký PHÁT TRIỂN-13712 SparkFun OpenLog là một trình ghi dữ liệu nguồn mở hoạt động thông qua kết nối nối tiếp đơn giản và hỗ trợ mi…
	Thẻ nhớ microSD kèm bộ chuyển đổi – 16GB (Class 10) COM-13833 Đây là thẻ nhớ microSD 10GB loại 16, hoàn hảo để lưu trữ hệ điều hành cho máy tính bảng đơn…
	Đầu đọc USB microSD COM-13004 Đây là một đầu đọc USB microSD nhỏ tuyệt vời. Chỉ cần trượt thẻ microSD của bạn vào bên trong đầu nối USB, t…
	Tiêu đề nữ PRT-00115 Một hàng 40 lỗ, đầu cái. Có thể cắt theo kích thước bằng một cặp kìm cắt dây. Khoảng cách chuẩn .1″. Chúng tôi sử dụng …
	Dây nhảy cao cấp 6″ M/M Gói 10 PRT-08431 Đây là sản phẩm độc quyền của SparkFun! Đây là dây nhảy dài 155mm có đầu nối đực ở cả hai đầu. Sử dụng chúng để ju…
	Tiêu đề nam tách rời – Góc phải PRT-00553 Một hàng đầu cắm góc vuông – bẻ cho vừa. 40 chân có thể cắt theo bất kỳ kích thước nào. Được sử dụng với PCB tùy chỉnh hoặc gen…

Đọc sách được đề xuất
Nếu bạn không quen thuộc hoặc không thoải mái với các khái niệm sau, chúng tôi khuyên bạn nên đọc qua trước khi tiếp tục với Hướng dẫn kết nối OpenLog.
Cách hàn: Hàn xuyên lỗ
Hướng dẫn này trình bày mọi thông tin bạn cần biết về hàn xuyên lỗ.
Giao diện ngoại vi nối tiếp (SPI)
SPI thường được sử dụng để kết nối vi điều khiển với các thiết bị ngoại vi như cảm biến, thanh ghi dịch chuyển và thẻ SD.
Truyền thông nối tiếp
Khái niệm về truyền thông nối tiếp không đồng bộ: gói tin, mức tín hiệu, tốc độ truyền, UART và nhiều hơn nữa!
Cơ bản về thiết bị đầu cuối nối tiếp
Hướng dẫn này sẽ chỉ cho bạn cách giao tiếp với các thiết bị nối tiếp bằng nhiều ứng dụng giả lập thiết bị đầu cuối.

Phần cứng trênview

Quyền lực
OpenLog chạy ở các cài đặt sau:
Xếp hạng công suất OpenLog

Đầu vào VCC	3.3V-12V (Khuyến nghị 3.3V-5V)
Đầu vào RXI	2.0V-3.8V
Đầu ra TXO	3.3V
Dòng điện nhàn rỗi	~2mA-5mA (không có thẻ nhớ microSD), ~5mA-6mA (có thẻ nhớ microSD)
Viết tích cực Rút tiền hiện tại	~20-23mA (có thẻ nhớ microSD)

Dòng điện tiêu thụ của OpenLog là khoảng 20mA đến 23mA khi ghi vào thẻ nhớ microSD. Tùy thuộc vào kích thước của thẻ nhớ microSD và nhà sản xuất, dòng điện tiêu thụ hoạt động có thể thay đổi khi OpenLog ghi vào thẻ nhớ. Tăng tốc độ truyền cũng sẽ kéo nhiều dòng điện hơn.
vi điều khiển
OpenLog chạy trên ATmega328 tích hợp, chạy ở tần số 16MHz nhờ tinh thể tích hợp. ATmega328 có bộ nạp khởi động Optiboot được tải trên đó, cho phép OpenLog tương thích với cài đặt bo mạch “Arduino Uno” trong Arduino IDE.Giao diện
UART nối tiếp
Giao diện chính với OpenLog là đầu cắm FTDI trên cạnh bo mạch. Đầu cắm này được thiết kế để cắm trực tiếp vào Arduino Pro hoặc Pro Mini, cho phép bộ vi điều khiển gửi dữ liệu qua kết nối nối tiếp đến OpenLog.

Cảnh báo! Do thứ tự chân cắm tương thích với Arduino nên nó không thể cắm trực tiếp vào bo mạch đột phá FTDI. Để biết thêm thông tin, hãy xem phần tiếp theo về Kết nối phần cứng.
SPI
Ngoài ra còn có bốn điểm kiểm tra SPI được tách ra ở đầu đối diện của bảng. Bạn có thể sử dụng chúng để lập trình lại bộ nạp khởi động trên ATmega328.OpenLog mới nhất (DEV-13712) phá vỡ các chân này trên các lỗ nhỏ hơn được mạ xuyên qua. Nếu bạn cần sử dụng ISP để lập trình lại hoặc tải bộ nạp khởi động mới lên OpenLog, bạn có thể sử dụng chân pogo để kết nối với các điểm kiểm tra này.
Giao diện cuối cùng để giao tiếp với OpenLog là chính thẻ microSD. Để giao tiếp, thẻ microSD cần có chân SPI. Đây không chỉ là nơi dữ liệu được lưu trữ bởi OpenLog mà bạn còn có thể cập nhật cấu hình của OpenLog thông qua config.txt file trên thẻ nhớ microSD.
thẻ nhớ microSD
Tất cả dữ liệu được OpenLog ghi lại đều được lưu trữ trên thẻ nhớ microSD. OpenLog hoạt động với thẻ nhớ microSD có các tính năng sau:

• 64MB đến 32GB
• FAT16 hoặc FAT32

Đèn LED trạng thái
Có hai đèn LED trạng thái trên OpenLog để giúp bạn khắc phục sự cố.

• STAT1 – Đèn LED chỉ báo màu xanh này được gắn vào Arduino D5 (ATmega328 PD5) và bật/tắt khi nhận được ký tự mới. Đèn LED này nhấp nháy khi giao tiếp nối tiếp đang hoạt động.
• STAT2 – Đèn LED màu xanh lá cây này được kết nối với Arduino D13 (SPI Serial Clock Line/ ATmega328 PB5). Đèn LED này chỉ nhấp nháy khi giao diện SPI đang hoạt động. Bạn sẽ thấy nó nhấp nháy khi OpenLog ghi 512 byte vào thẻ nhớ microSD.

Kết nối phần cứng

Có hai phương pháp chính để kết nối OpenLog của bạn với mạch điện. Bạn sẽ cần một số đầu cắm hoặc dây để kết nối. Đảm bảo rằng bạn hàn vào bảng mạch để có kết nối an toàn.
Kết nối nối tiếp cơ bản
Mẹo: Nếu bạn có chân cắm cái, OpenLog và chân cắm cái trên FTDI, bạn sẽ cần dây nối M/F để kết nối.

Kết nối phần cứng này được thiết kế để giao tiếp với OpenLog nếu bạn cần lập trình lại bo mạch hoặc ghi dữ liệu qua kết nối nối tiếp cơ bản.
Thực hiện các kết nối sau:
OpenLog → 3.3V FTDI Cơ bản Breakout

• Mặt đất → Mặt đất
• Mặt đất → Mặt đất
• VCC → 3.3V
• TXO → RXI
• RXI → TXO
• DTR → DTR

Lưu ý rằng không có kết nối trực tiếp giữa FTDI và OpenLog – bạn phải chuyển đổi kết nối chân TXO và RXI.
Kết nối của bạn sẽ trông như sau: Sau khi đã kết nối OpenLog và FTDI Basic, hãy cắm bo mạch FTDI vào cáp USB và vào máy tính.
Mở một thiết bị đầu cuối nối tiếp, kết nối với cổng COM của FTDI Basic và bắt đầu sử dụng!

Kết nối phần cứng dự án

Mẹo: Nếu bạn đã hàn các chân cắm cái trên OpenLog, bạn có thể hàn các chân cắm đực vào Arduino Pro Mini để kết nối các bo mạch với nhau mà không cần dây.Trong khi giao tiếp với OpenLog qua kết nối nối tiếp rất quan trọng để lập trình lại hoặc gỡ lỗi, nơi OpenLog tỏa sáng là trong một dự án nhúng. Mạch chung này là cách chúng tôi khuyên bạn nên kết nối OpenLog của mình với một bộ vi điều khiển (trong trường hợp này là Arduino Pro Mini) sẽ ghi dữ liệu nối tiếp ra OpenLog.
Đầu tiên, bạn sẽ cần tải mã lên Pro Mini mà bạn định chạy. Vui lòng kiểm tra Arduino Sketches để biết thêm ví dụampMã bạn có thể sử dụng.
Ghi chú: Nếu bạn không chắc chắn về cách lập trình Pro Mini của mình, vui lòng xem hướng dẫn của chúng tôi tại đây.
Sử dụng Arduino Pro Mini 3.3V
Hướng dẫn này là hướng dẫn của bạn về mọi thứ liên quan đến Arduino Pro Mini. Hướng dẫn giải thích Arduino Pro Mini là gì, không phải là gì và cách bắt đầu sử dụng.
Sau khi lập trình xong Pro Mini, bạn có thể tháo bo mạch FTDI và thay thế bằng OpenLog.
Đảm bảo kết nối các chân có nhãn BLK trên cả Pro Mini và OpenLog (các chân có nhãn GRN trên cả hai cũng sẽ khớp nhau nếu thực hiện đúng).
Nếu bạn không thể cắm OpenLog trực tiếp vào Pro Mini (do chân cắm không khớp hoặc có bo mạch khác cản trở), bạn có thể sử dụng dây nối và thực hiện các kết nối sau.
OpenLog → Arduino Pro/Arduino Pro Mini

• Mặt đất → Mặt đất
• Mặt đất → Mặt đất
• VCC → VCC
• TXO → RXI
• RXI → TXO
• DTR → DTR

Sau khi hoàn tất, kết nối giữa Arduino Pro Mini và Arduino Pro sẽ trông giống như sau.
Sơ đồ Fritzing hiển thị OpenLogs với các tiêu đề được phản chiếu. Nếu bạn lật ổ cắm microSD so với đầu Arduino view, chúng phải khớp với tiêu đề lập trình như FTDI.

Ghi chú rằng kết nối được thực hiện thẳng với OpenLog “lộn ngược” (thẻ nhớ microSD hướng lên trên).
⚡Lưu ý: Vì Vcc và GND giữa OpenLog và Arduino đang được các header chiếm dụng, bạn sẽ cần kết nối nguồn điện với các chân khác có sẵn trên Arduino. Nếu không, bạn có thể hàn dây vào các chân nguồn hở trên cả hai bo mạch.
Khởi động hệ thống và bạn đã sẵn sàng để bắt đầu ghi nhật ký!

Bản phác thảo Arduino

Có sáu ex khác nhauampbao gồm các bản phác thảo mà bạn có thể sử dụng trên Arduino khi kết nối với OpenLog.

• OpenLog_Benchmarking — Ví dụ nàyample được sử dụng để kiểm tra OpenLog. Điều này gửi một lượng dữ liệu rất lớn ở tốc độ 115200bps qua nhiều files.
• OpenLog_CommandTest — Ví dụ nàyample cho thấy cách tạo và thêm một file thông qua điều khiển dòng lệnh thông qua Arduino.
• MởLog_ReadExample — Cái này cũample hướng dẫn cách kiểm soát OpenLog thông qua dòng lệnh.
• MởLog_ReadExample_LớnFile - Bán tạiampcách mở một kho lưu trữ lớn file trên OpenLog và báo cáo qua kết nối Bluetooth cục bộ.
• OpenLog_Test_Sketch — Được sử dụng để kiểm tra OpenLog với nhiều dữ liệu tuần tự.
• OpenLog_Test_Sketch_Binary — Được sử dụng để kiểm tra OpenLog với dữ liệu nhị phân và ký tự thoát.

Phần mềm

OpenLog có hai phần mềm chính: bộ nạp khởi động và chương trình cơ sở.
Bộ nạp khởi động Arduino
Ghi chú: Nếu bạn đang sử dụng OpenLog được mua trước tháng 2012 năm 5, bộ nạp khởi động tích hợp sẽ tương thích với cài đặt “Arduino Pro hoặc Pro Mini 16V/328MHz với ATmegaXNUMX” trong Arduino IDE.
Như đã đề cập trước đó, OpenLog có bộ nạp khởi động nối tiếp Optiboot trên bo mạch. Bạn có thể xử lý OpenLog giống như Arduino Uno khi tải lên exampmã hoặc chương trình cơ sở mới cho bo mạch.
Nếu bạn kết thúc bằng việc làm hỏng OpenLog và cần cài đặt lại bộ nạp khởi động, bạn cũng sẽ muốn tải Optiboot lên bo mạch. Vui lòng xem hướng dẫn của chúng tôi về cách cài đặt Bộ nạp khởi động Arduino để biết thêm thông tin.
Biên dịch và tải chương trình cơ sở vào OpenLog
Ghi chú: Nếu đây là lần đầu tiên bạn sử dụng Arduino, vui lòng xem lạiview hướng dẫn của chúng tôi về cách cài đặt Arduino IDE. Nếu bạn chưa cài đặt thư viện Arduino trước đây, vui lòng xem hướng dẫn cài đặt của chúng tôi để cài đặt thủ công các thư viện.
Nếu vì lý do nào đó bạn cần cập nhật hoặc cài đặt lại chương trình cơ sở trên OpenLog, quy trình sau sẽ giúp bo mạch của bạn hoạt động trở lại.
Trước tiên, vui lòng tải xuống Arduino IDE v1.6.5. Các phiên bản IDE khác có thể hoạt động để biên dịch chương trình cơ sở OpenLog, nhưng chúng tôi đã xác minh đây là phiên bản tốt đã biết.
Tiếp theo, hãy tải xuống chương trình cơ sở OpenLog và gói thư viện cần thiết.

TẢI XUỐNG BỘ PHẦN MỀM OPENLOG (ZIP)
Sau khi bạn đã tải xuống thư viện và chương trình cơ sở, hãy cài đặt thư viện vào Arduino. Nếu bạn không chắc chắn về cách cài đặt thủ công các thư viện trong IDE, vui lòng xem hướng dẫn của chúng tôi: Cài đặt thư viện Arduino: Cài đặt thủ công thư viện.
Ghi chú: Chúng tôi đang sử dụng các phiên bản đã sửa đổi của thư viện SdFat và SerialPort để tùy ý khai báo kích thước của bộ đệm TX và RX. OpenLog yêu cầu bộ đệm TX phải rất nhỏ (0) và bộ đệm RX phải càng lớn càng tốt. Sử dụng hai thư viện đã sửa đổi này cùng nhau cho phép tăng hiệu suất của OpenLog.
Bạn đang tìm phiên bản mới nhất? Nếu bạn muốn có phiên bản mới nhất của thư viện và chương trình cơ sở, bạn có thể tải xuống trực tiếp từ kho lưu trữ GitHub được liên kết bên dưới. Thư viện SdFatLib và Serial Port không hiển thị trong trình quản lý bo mạch Arduino nên bạn sẽ cần phải cài đặt thủ công thư viện.

• GitHub: OpenLog > Phần sụn > OpenLog_Firmware
• Thư viện Arduino của Bill Greiman
  SdFatLib-beta
  Cổng nối tiếp

Tiếp theo, để có lợi thếtage của các thư viện đã sửa đổi, hãy sửa đổi SerialPort.h file được tìm thấy trong thư mục \Arduino\Libraries\SerialPort. Đổi BUFFERED_TX thành 0 và ENABLE_RX_ERROR_CHECKING thành 0. Lưu filevà mở Arduino IDE.
Nếu bạn chưa thực hiện, hãy kết nối OpenLog của bạn với máy tính thông qua bảng FTDI. Vui lòng kiểm tra lại exampmạch nếu bạn không chắc chắn làm thế nào để thực hiện đúng.
Mở bản phác thảo OpenLog mà bạn muốn tải lên trong menu Công cụ>Bảng, chọn “Arduino/Genuino Uno” và chọn cổng COM phù hợp cho bo mạch FTDI của bạn trong Công cụ>Cổng.
Tải mã lên.
Vậy là xong! OpenLog của bạn hiện đã được lập trình bằng chương trình cơ sở mới. Bây giờ bạn có thể mở màn hình tuần tự và tương tác với OpenLog. Khi bật nguồn, bạn sẽ thấy 12> hoặc 12<. 1 biểu thị kết nối tuần tự đã được thiết lập, 2 biểu thị thẻ SD đã khởi tạo thành công, < biểu thị OpenLog đã sẵn sàng để ghi lại bất kỳ dữ liệu tuần tự nào đã nhận và > biểu thị OpenLog đã sẵn sàng để nhận lệnh.
Bản phác thảo phần mềm OpenLog
Có ba bản phác thảo đi kèm mà bạn có thể sử dụng trên OpenLog, tùy thuộc vào ứng dụng cụ thể của bạn.

• OpenLog – Phần mềm này được mặc định vận chuyển trên OpenLog. Gửi lệnh ? sẽ hiển thị phiên bản phần mềm được tải vào một đơn vị.
• OpenLog_Light – Phiên bản phác thảo này loại bỏ chế độ menu và lệnh, cho phép tăng bộ đệm nhận. Đây là một tùy chọn tốt cho việc ghi nhật ký tốc độ cao.
• OpenLog_Minimal – Tốc độ truyền phải được thiết lập trong mã và tải lên. Bản phác thảo này được khuyến nghị cho người dùng có kinh nghiệm nhưng cũng là lựa chọn tốt nhất cho tốc độ ghi nhật ký cao nhất.

Bộ lệnh

Bạn có thể giao tiếp với OpenLog thông qua một thiết bị đầu cuối nối tiếp. Các lệnh sau sẽ giúp bạn đọc, ghi và xóa files, cũng như thay đổi cài đặt của OpenLog. Bạn sẽ cần phải ở Chế độ lệnh để sử dụng các cài đặt sau.
Trong khi OpenLog ở Chế độ lệnh, STAT1 sẽ bật/tắt cho mỗi ký tự nhận được. Đèn LED sẽ sáng cho đến khi nhận được ký tự tiếp theo.

File Thao tác

• mới File – Tạo ra một cái mới file được đặt tên File trong thư mục hiện tại. Chuẩn 8.3 filetên được hỗ trợ.
  Ví dụampVí dụ, “87654321.123” được chấp nhận, trong khi “987654321.123” thì không.
  • Bán tạiample: mới file1.txt
• thêm vào File – Thêm văn bản vào cuối File. Dữ liệu nối tiếp sau đó được đọc từ UART trong một luồng và thêm nó vào file. Nó không được phản hồi qua thiết bị đầu cuối nối tiếp. Nếu File không tồn tại khi hàm này được gọi, file sẽ được tạo ra.
  • Bán tạiample: thêm mớifile.csv
• viết File OFFSET – Viết văn bản vào File từ vị trí OFFSET trong file. Văn bản được đọc từ UART, từng dòng một và phản hồi lại. Để thoát khỏi trạng thái này, hãy gửi một dòng trống.
  • Bán tạiample: ghi logs.txt 516
• rm File – Xóa File từ thư mục hiện tại. Ký tự đại diện được hỗ trợ.
  • Bán tạiample: rm README.txt
• kích cỡ File – Kích thước đầu ra của File theo byte.
  • Bán tạiample: kích thước Log112.csv
  • Đầu ra: 11
• đọc File + START+ LENGTH TYPE – Xuất nội dung của File bắt đầu từ BẮT ĐẦU và kéo dài theo CHIỀU DÀI.
  Nếu START bị bỏ qua, toàn bộ file được báo cáo. Nếu bỏ qua LENGTH, toàn bộ nội dung từ điểm bắt đầu sẽ được báo cáo. Nếu bỏ qua TYPE, OpenLog sẽ mặc định báo cáo bằng ASCII. Có ba TYPE đầu ra:
  • Mã ASCII = 1
  • HEX = 2
  • NGUYÊN = 3
  Bạn có thể bỏ qua một số đối số theo sau. Kiểm tra ví dụ sauampđồng nghiệp.
  Đọc cơ bản + cờ bị bỏ qua:
  • Bán tạiample: đọc LOG00004.txt
  • Đầu ra: Gia tốc kế X=12 Y=215 Z=317
  Đọc từ đầu 0 với độ dài 5:
  • Bán tạiample: đọc LOG00004.txt 0 5
  • Đầu ra: Tăng tốc
  Đọc từ vị trí 1 với độ dài 5 trong HEX:
  • Bán tạiample: đọc LOG00004.txt 1 5 2
  • Đầu ra: 63 63 65 6C
• Đọc từ vị trí 0 với độ dài 50 trong RAW:
• • Bán tạiample: đọc LOG00137.txt 0 50 3
• • Đầu ra: André– -þ Kiểm tra ký tự mở rộng
• con mèo File – Viết nội dung của một file trong hex đến màn hình nối tiếp cho viewing. Điều này đôi khi hữu ích để thấy rằng một file đang ghi âm chính xác mà không cần phải tháo thẻ SD và view cái file Trên một máy tính.
  • Bán tạiample: mèo LOG00004.txt
  • Đầu ra: 00000000: 41 63 65 6c 3a 20 31

Thao tác thư mục

• ls – Liệt kê tất cả nội dung của thư mục hiện tại. Ký tự đại diện được hỗ trợ.
  • Bán tạiampl: ls
  • Đầu ra: \src
• md Subdirectory – Tạo thư mục con trong thư mục hiện tại.
  • Bán tạiample: md Example_Phác thảo
• cd Subdirectory – Chuyển đến thư mục con.
  • Bán tạiample: cd Hello_World
• cd .. – Chuyển đến thư mục thấp hơn trong cây. Lưu ý rằng có một khoảng trắng giữa 'cd' và '..'. Điều này cho phép trình phân tích chuỗi nhìn thấy lệnh cd.
  • Bán tạiampl: cd ..
• rm Subdirectory – Xóa Subdirectory. Thư mục phải trống để lệnh này hoạt động.
  • Bán tạiample: nhiệt độ rm
• rm -rf Directory – Xóa thư mục và bất kỳ fileđược chứa đựng bên trong nó.
  • Bán tạiample: rm -rf Thư viện

Lệnh chức năng cấp thấp

• ? – Lệnh này sẽ mở ra danh sách các lệnh có sẵn trên OpenLog.
• đĩa – Hiển thị ID nhà sản xuất thẻ, số sê-ri, ngày sản xuất và kích thước thẻ. Ví dụampđầu ra là:
  Loại thẻ: SD2
  Mã nhà sản xuất: 3
  Mã số OEM: SD
  Sản phẩm: SU01G
  Phiên bản: 8.0
  Số sê-ri: 39723042
  Ngày sản xuất: 1/2010
  Kích thước thẻ: 965120 KB
• init – Khởi tạo lại hệ thống và mở lại thẻ SD. Điều này hữu ích nếu thẻ SD ngừng phản hồi.
• sync – Đồng bộ hóa nội dung hiện tại của bộ đệm với thẻ SD. Lệnh này hữu ích nếu bạn có ít hơn 512 ký tự trong bộ đệm và muốn ghi những ký tự đó vào thẻ SD.
• reset – Nhảy OpenLog đến vị trí zero, chạy lại bootloader và sau đó init code. Lệnh này hữu ích nếu bạn cần chỉnh sửa cấu hình file, đặt lại OpenLog và bắt đầu sử dụng cấu hình mới. Tắt nguồn liên tục vẫn là phương pháp được ưu tiên để đặt lại bo mạch, nhưng tùy chọn này khả dụng.

Cài đặt hệ thống

Những thiết lập này có thể được cập nhật thủ công hoặc chỉnh sửa trong config.txt file.

• echo STATE – Thay đổi trạng thái của echo hệ thống và được lưu trữ trong bộ nhớ hệ thống. STATE có thể bật hoặc tắt. Khi bật, OpenLog sẽ echo dữ liệu tuần tự đã nhận trên dấu nhắc lệnh. Khi tắt, hệ thống không đọc lại các ký tự đã nhận.
  Ghi chú: Trong quá trình ghi nhật ký bình thường, echo sẽ bị tắt. Nhu cầu tài nguyên hệ thống để echo dữ liệu đã nhận quá cao trong quá trình ghi nhật ký.
• verbose STATE – Thay đổi trạng thái báo cáo lỗi verbose. STATE có thể là bật hoặc tắt. Lệnh này được lưu trữ trong bộ nhớ. Bằng cách tắt lỗi verbose, OpenLog sẽ chỉ phản hồi bằng ! nếu có lỗi chứ không phải lệnh không xác định: COMMAND. Ký tự ! dễ phân tích hơn đối với hệ thống nhúng so với lỗi đầy đủ. Nếu bạn đang sử dụng thiết bị đầu cuối, việc bật verbose sẽ cho phép bạn xem toàn bộ thông báo lỗi.
• baud – Lệnh này sẽ mở ra một menu hệ thống cho phép người dùng nhập tốc độ truyền dữ liệu. Bất kỳ tốc độ truyền dữ liệu nào trong khoảng từ 300bps đến 1Mbps đều được hỗ trợ. Việc lựa chọn tốc độ truyền dữ liệu là ngay lập tức và OpenLog yêu cầu phải có một chu kỳ nguồn để các thiết lập có hiệu lực. Tốc độ truyền dữ liệu được lưu trữ trong EEPROM và được tải mỗi khi OpenLog bật nguồn. Mặc định là 9600 8N1.

Hãy nhớ: Nếu bạn làm cho bo mạch bị kẹt ở tốc độ truyền không xác định, bạn có thể kết nối RX với GND và bật OpenLog. Đèn LED sẽ nhấp nháy qua lại trong 2 giây và sau đó sẽ nhấp nháy đồng loạt. Tắt OpenLog và tháo jumper. OpenLog hiện được đặt lại thành 9600bps với ký tự thoát `CTRL-Z` được nhấn ba lần liên tiếp. Tính năng này có thể được ghi đè bằng cách đặt bit Ghi đè khẩn cấp thành 1.
Xem config.txt để biết thêm thông tin.

• thiết lập – Lệnh này mở một menu hệ thống để chọn chế độ khởi động. Các thiết lập này sẽ xảy ra tại
  • lần bật nguồn tiếp theo và được lưu trữ trong EEPROM không mất dữ liệu. Mới File Ghi nhật ký – Chế độ này tạo ra một file mỗi lần OpenLog bật nguồn. OpenLog sẽ truyền 1 (UART còn hoạt động), 2 (thẻ SD đã được khởi tạo), sau đó < (OpenLog đã sẵn sàng để nhận dữ liệu). Tất cả dữ liệu sẽ được ghi vào LOG#####.txt. Số ##### tăng lên mỗi lần OpenLog bật nguồn (tối đa là 65533 bản ghi). Số được lưu trữ trong EEPROM và có thể được đặt lại từ menu cài đặt.
  Tất cả các ký tự nhận được không được phản hồi. Bạn có thể thoát khỏi chế độ này và vào chế độ lệnh bằng cách gửi CTRL+z (ASCII 26). Tất cả dữ liệu đệm sẽ được lưu trữ.

Ghi chú: Nếu quá nhiều nhật ký được tạo, OpenLog sẽ xuất ra lỗi **Quá nhiều nhật ký**, thoát khỏi chế độ này và chuyển đến Dấu nhắc lệnh. Đầu ra tuần tự sẽ trông giống như `12!Quá nhiều nhật ký!`.

• Thêm vào File Ghi nhật ký – Còn được gọi là chế độ tuần tự, chế độ này tạo ra một file được gọi là SEQLOG.txt nếu nó chưa có ở đó và thêm bất kỳ dữ liệu nào đã nhận vào file. OpenLog sẽ truyền 12< tại thời điểm OpenLog sẵn sàng nhận dữ liệu. Các ký tự không được phản hồi. Bạn có thể thoát khỏi chế độ này và vào chế độ lệnh bằng cách gửi CTRL+z (ASCII 26). Tất cả dữ liệu đệm sẽ được lưu trữ.
• Dấu nhắc lệnh – OpenLog sẽ truyền 12> tại thời điểm hệ thống sẵn sàng nhận lệnh. Lưu ý rằng dấu > cho biết OpenLog đã sẵn sàng nhận lệnh, không phải dữ liệu. Bạn có thể tạo files và thêm dữ liệu vào files, nhưng điều này đòi hỏi một số phân tích tuần tự (để kiểm tra lỗi), vì vậy chúng tôi không đặt chế độ này theo mặc định.
• Đặt lại Mới File Số – Chế độ này sẽ thiết lập lại nhật ký file số vào LOG000.txt. Điều này hữu ích nếu bạn vừa xóa thẻ nhớ microSD và muốn có nhật ký file số để bắt đầu lại.
• Ký tự thoát mới – Tùy chọn này cho phép người dùng nhập một ký tự như CTRL+z hoặc $ và đặt ký tự này làm ký tự thoát mới. Cài đặt này được đặt lại thành CTRL+z trong quá trình đặt lại khẩn cấp.
• Số ký tự thoát – Tùy chọn này cho phép người dùng nhập một ký tự (chẳng hạn như 1, 3 hoặc 17), cập nhật số ký tự thoát mới cần thiết để chuyển sang chế độ lệnh. Ví dụample, nhập 8 sẽ yêu cầu người dùng nhấn CTRL+z tám lần để vào chế độ lệnh. Cài đặt này được đặt lại thành 3 trong quá trình đặt lại khẩn cấp.

Giải thích về ký tự thoát:Lý do OpenLog yêu cầu nhấn `CTRL+z` 3 lần để vào chế độ lệnh là để ngăn bo mạch vô tình bị đặt lại trong quá trình tải mã mới từ Arduino IDE. Có khả năng bo mạch sẽ thấy ký tự `CTRL+z` xuất hiện trong quá trình khởi động (một sự cố mà chúng tôi đã thấy trong các phiên bản đầu của chương trình cơ sở OpenLog), vì vậy mục đích của việc này là ngăn chặn điều đó. Nếu bạn nghi ngờ bo mạch của mình đã bị hỏng do lỗi này, bạn luôn có thể thực hiện đặt lại khẩn cấp bằng cách giữ chân RX xuống đất trong khi bật nguồn.

Cấu hình File

Nếu bạn không muốn sử dụng thiết bị đầu cuối nối tiếp để sửa đổi cài đặt trên OpenLog của mình, bạn cũng có thể cập nhật cài đặt bằng cách sửa đổi CONFIG.TXT file.
Ghi chú: Tính năng này chỉ hoạt động trên phiên bản phần mềm 1.6 hoặc mới hơn. Nếu bạn đã mua OpenLog sau năm 2012, bạn sẽ chạy phiên bản phần mềm 1.6 trở lên
Để thực hiện việc này, bạn sẽ cần một đầu đọc thẻ nhớ microSD và một trình soạn thảo văn bản. Mở file config.txt file (viết hoa của file tên không quan trọng), và cấu hình ngay! Nếu bạn chưa bao giờ bật OpenLog bằng thẻ SD trước đây, bạn cũng có thể tạo thủ công file. Nếu bạn đã bật OpenLog bằng thẻ nhớ microSD trước đó, bạn sẽ thấy thông tin tương tự như sau khi đọc thẻ nhớ microSD.OpenLog tạo ra config.txt và LOG0000.txt file khi bật nguồn lần đầu.
Cấu hình mặc định file có một dòng cài đặt và một dòng định nghĩa.Cấu hình mặc định file được viết bởi OpenLog.
Lưu ý rằng đây là các ký tự hiển thị thông thường (không có giá trị nhị phân hoặc không hiển thị) và mỗi giá trị được phân tách bằng dấu phẩy.
Các thiết lập được xác định như sau:

• baud: Tốc độ truyền thông. 9600bps là mặc định. Các giá trị chấp nhận được tương thích với Arduino IDE là 2400, 4800, 9600, 19200, 38400, 57600 và 115200. Bạn có thể sử dụng các tốc độ truyền khác, nhưng bạn sẽ không thể giao tiếp với OpenLog thông qua màn hình nối tiếp Arduino IDE.
• escape: Giá trị ASCII (ở định dạng thập phân) của ký tự thoát. 26 là CTRL+z và là mặc định. 36 là $ và là ký tự thoát thường dùng.
• esc#: Số ký tự thoát cần thiết. Theo mặc định, là ba, vì vậy bạn phải nhấn ký tự thoát ba lần để chuyển sang chế độ lệnh. Các giá trị chấp nhận được là từ 0 đến 254. Đặt giá trị này thành 0 sẽ vô hiệu hóa hoàn toàn việc kiểm tra ký tự thoát.
• chế độ: Chế độ hệ thống. OpenLog bắt đầu ở chế độ Nhật ký mới (0) theo mặc định. Các giá trị chấp nhận được là 0 = Nhật ký mới, 1 = Nhật ký tuần tự, 2 = Chế độ lệnh.
• động từ: Chế độ chi tiết. Các thông báo lỗi mở rộng (chi tiết) được bật theo mặc định. Đặt thành 1 sẽ bật các thông báo lỗi chi tiết (chẳng hạn như lệnh không xác định: remove ! ). Đặt thành 0 sẽ tắt các lỗi chi tiết nhưng sẽ phản hồi bằng ! nếu có lỗi. Tắt chế độ chi tiết rất tiện lợi nếu bạn đang cố gắng xử lý lỗi từ một hệ thống nhúng.
• echo: Chế độ echo. Khi ở chế độ lệnh, các ký tự được echo theo mặc định. Đặt thành 0 sẽ tắt echo ký tự. Tắt chế độ này rất tiện lợi nếu xử lý lỗi và bạn không muốn các lệnh đã gửi được echo trở lại OpenLog.
• ignoreRX: Ghi đè khẩn cấp. Thông thường, OpenLog sẽ thiết lập lại khẩn cấp khi chân RX được kéo xuống mức thấp trong khi bật nguồn. Đặt thành 1 sẽ vô hiệu hóa việc kiểm tra chân RX trong khi bật nguồn. Điều này có thể hữu ích cho các hệ thống sẽ giữ đường RX ở mức thấp vì nhiều lý do. Nếu Ghi đè khẩn cấp bị vô hiệu hóa, bạn sẽ không thể buộc thiết bị trở lại mức 9600bps và cấu hình file sẽ là cách duy nhất để thay đổi tốc độ truyền.

OpenLog sửa đổi cấu hình như thế nào File
Có năm tình huống khác nhau để OpenLog sửa đổi config.txt file.

• Cấu hình file đã tìm thấy: Trong khi bật nguồn, OpenLog sẽ tìm kiếm config.txt file. Nếu file được tìm thấy, OpenLog sẽ sử dụng các thiết lập có sẵn và ghi đè lên mọi thiết lập hệ thống đã lưu trữ trước đó.
• Không có cấu hình file đã tìm thấy: Nếu OpenLog không tìm thấy config.txt file sau đó OpenLog sẽ tạo config.txt và ghi lại các thiết lập hệ thống hiện đang được lưu trữ vào đó. Điều này có nghĩa là nếu bạn lắp thẻ nhớ microSD mới được định dạng, hệ thống của bạn sẽ duy trì các thiết lập hiện tại.
• Cấu hình bị hỏng file đã tìm thấy: OpenLog sẽ xóa config.txt bị hỏng filevà sẽ viết lại cả cài đặt EEPROM nội bộ và cài đặt config.txt file đến trạng thái tốt đã biết là 9600,26,3,0,1,1,0.
• Giá trị bất hợp lệ trong cấu hình file: Nếu OpenLog phát hiện bất kỳ cài đặt nào chứa giá trị bất hợp pháp, OpenLog sẽ ghi đè các giá trị bị hỏng trong config.txt file với các thiết lập hệ thống EEPROM hiện đang được lưu trữ.
• Thay đổi thông qua dấu nhắc lệnh: Nếu các thiết lập hệ thống được thay đổi thông qua dấu nhắc lệnh (qua kết nối nối tiếp hoặc qua lệnh nối tiếp của vi điều khiển), những thay đổi đó sẽ được ghi vào cả EEPROM hệ thống và config.txt file.
• Đặt lại khẩn cấp: Nếu OpenLog được cấp nguồn tuần hoàn với một cầu nối giữa RX và GND và bit Ghi đè khẩn cấp được đặt thành 0 (cho phép đặt lại khẩn cấp), OpenLog sẽ ghi lại cả cài đặt EEPROM nội bộ và cài đặt config.txt file đến trạng thái tốt đã biết là 9600,26,3,0,1,1,0.

Xử lý sự cố

Có một số tùy chọn khác nhau để kiểm tra xem bạn có gặp sự cố khi kết nối qua màn hình nối tiếp, gặp sự cố với các ký tự bị mất trong nhật ký hay gặp sự cố với OpenLog không.
Kiểm tra hành vi của đèn LED STAT1
Đèn LED STAT1 hiển thị hành vi khác nhau cho hai lỗi phổ biến khác nhau.

• 3 lần nhấp nháy: Thẻ nhớ microSD không khởi tạo được. Bạn có thể cần định dạng thẻ bằng FAT/FAT16 trên máy tính.
• 5 lần nhấp nháy: OpenLog đã thay đổi sang tốc độ truyền dữ liệu mới và cần phải tắt nguồn.

Kiểm tra lại cấu trúc thư mục con
Nếu bạn đang sử dụng OpenLog.ino mặc địnhample, OpenLog sẽ chỉ hỗ trợ hai thư mục con. Bạn sẽ cần thay đổi FOLDER_TRACK_DEPTH từ 2 thành số lượng thư mục con bạn cần hỗ trợ. Sau khi thực hiện xong, hãy biên dịch lại mã và tải lên chương trình cơ sở đã sửa đổi.
Xác minh số lượng Files trong Thư mục gốc
OpenLog sẽ chỉ hỗ trợ tối đa 65,534 bản ghi files trong thư mục gốc. Chúng tôi khuyên bạn nên định dạng lại thẻ nhớ microSD để cải thiện tốc độ ghi nhật ký.
Xác minh kích thước của phần mềm đã sửa đổi của bạn
Nếu bạn đang viết một bản phác thảo tùy chỉnh cho OpenLog, hãy xác minh rằng bản phác thảo của bạn không lớn hơn 32,256. Nếu vậy, nó sẽ cắt vào 500 byte trên cùng của bộ nhớ Flash, được bộ nạp khởi động tuần tự Optiboot sử dụng.
Kiểm tra lại File Tên
Tất cả file tên phải là chữ cái-số. MyLOG1.txt thì được, nhưng Hi !e _.txt có thể không hoạt động.
Sử dụng 9600 Baud
OpenLog chạy trên ATmega328 và có dung lượng RAM hạn chế (2048 byte). Khi bạn gửi các ký tự tuần tự đến OpenLog, các ký tự này sẽ được đệm. SD Group Simplified Specification cho phép thẻ SD mất tới 250ms (phần 4.6.2.2 Write) để ghi một khối dữ liệu vào bộ nhớ flash.
Ở tốc độ 9600bps, tức là 960 byte (10 bit trên một byte) mỗi giây. Tức là 1.04ms trên một byte. OpenLog hiện đang sử dụng bộ đệm nhận 512 byte để có thể đệm khoảng 50ms ký tự. Điều này cho phép OpenLog nhận thành công tất cả các ký tự đến ở tốc độ 9600bps. Khi bạn tăng tốc độ truyền, bộ đệm sẽ tồn tại trong thời gian ngắn hơn.
Thời gian tràn bộ đệm OpenLog

Tốc độ truyền	Thời gian mỗi byte	Thời gian cho đến khi bộ đệm bị tràn
9600bps	1.04ms	532ms
57600bps	0.174ms	88ms
115200bps	0.087ms	44ms

Nhiều thẻ SD có thời gian ghi nhanh hơn 250ms. Điều này có thể bị ảnh hưởng bởi 'lớp' của thẻ và lượng dữ liệu đã được lưu trữ trên thẻ. Giải pháp là sử dụng tốc độ truyền thấp hơn hoặc tăng thời gian giữa các ký tự được gửi ở tốc độ truyền cao hơn.
Định dạng thẻ MicroSD của bạn
Hãy nhớ sử dụng một thẻ có ít hoặc không có files trên đó. Một thẻ nhớ microSD có dung lượng ZIP là 3.1 GB files hoặc MP3 có thời gian phản hồi chậm hơn so với thẻ trống.
Nếu bạn không định dạng thẻ nhớ microSD trên hệ điều hành Windows, hãy định dạng lại thẻ nhớ microSD và tạo DOS filehệ thống trên thẻ SD.
Đổi thẻ MicroSD
Có nhiều loại nhà sản xuất thẻ, thẻ được dán nhãn lại, kích thước thẻ và loại thẻ khác nhau và chúng có thể không hoạt động bình thường. Chúng tôi thường sử dụng thẻ microSD loại 8 4GB, hoạt động tốt ở tốc độ 9600bps. Nếu bạn cần tốc độ truyền dữ liệu cao hơn hoặc không gian lưu trữ lớn hơn, bạn có thể muốn thử thẻ loại 6 trở lên.
Thêm độ trễ giữa các lần ghi ký tự
Bằng cách thêm một độ trễ nhỏ giữa các câu lệnh Serial.print(), bạn có thể cho OpenLog cơ hội ghi lại thông tin hiện tại của nó
bộ đệm.
Ví dụamplê:
Serial.bắt đầu(115200);
đối với (int i = 1; i < 10; i++) {
Serial.print(i, DEC);
Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
}

có thể không ghi nhật ký đúng cách vì có rất nhiều ký tự được gửi ngay cạnh nhau. Chèn độ trễ nhỏ 15ms giữa các lần ghi ký tự lớn sẽ giúp OpenLog ghi mà không làm mất ký tự.
Serial.bắt đầu(115200);
đối với (int i = 1; i < 10; i++) {
Serial.print(i, DEC);
Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
trì hoãn(15);
}

Thêm khả năng tương thích của Arduino Serial Monitor
Nếu bạn đang cố gắng sử dụng OpenLog với thư viện serial tích hợp hoặc thư viện SoftwareSerial, bạn có thể nhận thấy sự cố với chế độ lệnh. Serial.println() gửi cả xuống dòng VÀ trả về đầu dòng. Có hai lệnh thay thế để khắc phục sự cố này.
Đầu tiên là sử dụng lệnh \r (trở về ký tự ASCII):
Serial.print(“TEXT\r”);
Ngoài ra, bạn có thể gửi giá trị 13 (trả về dấu thập phân):
Serial.print(“VĂN BẢN”);
Serial.write(13);

Thiết lập lại khẩn cấp
Hãy nhớ rằng, nếu bạn cần đặt lại OpenLog về trạng thái mặc định, bạn có thể đặt lại bo mạch bằng cách kết nối chân RX với GND, bật nguồn OpenLog, đợi cho đến khi đèn LED bắt đầu nhấp nháy cùng lúc, sau đó tắt nguồn OpenLog và tháo jumper.
Nếu bạn đã thay đổi bit Ghi đè khẩn cấp thành 1, bạn sẽ cần phải sửa đổi cấu hình filevì tính năng Thiết lập lại khẩn cấp sẽ không hoạt động.
Kiểm tra với cộng đồng
Nếu bạn vẫn gặp sự cố với OpenLog, vui lòng kiểm tra các sự cố hiện tại và đã đóng trên kho lưu trữ GitHub của chúng tôi tại đây. Có một cộng đồng lớn đang làm việc với OpenLog, vì vậy có khả năng là ai đó đã tìm ra cách khắc phục sự cố bạn đang gặp phải.

Tài nguyên và tiến xa hơn

Bây giờ bạn đã ghi dữ liệu thành công bằng OpenLog, bạn có thể thiết lập các dự án từ xa và theo dõi tất cả dữ liệu có thể đến. Hãy cân nhắc tạo dự án Khoa học công dân của riêng bạn hoặc thậm chí là một trình theo dõi thú cưng để xem Fluffy làm gì khi ra ngoài!
Hãy tham khảo các tài nguyên bổ sung sau để khắc phục sự cố, tìm trợ giúp hoặc tìm cảm hứng cho dự án tiếp theo của bạn.

• GitHub OpenLog
• Dự án Illumintune
• Kết nối cảm biến ánh sáng LilyPad
• BadgerHack: Tiện ích bổ sung cảm biến đất
• Bắt đầu với OBD-II
• Vernier Photogate

Bạn cần thêm cảm hứng? Hãy xem một số hướng dẫn liên quan sau:
Cảm biến mực nước từ xa Photon
Tìm hiểu cách chế tạo cảm biến mực nước từ xa cho bể chứa nước và cách tự động hóa máy bơm dựa trên các chỉ số đo được!
Cảm biến mực nước từ xa Photon
Tìm hiểu cách chế tạo cảm biến mực nước từ xa cho bể chứa nước và cách tự động hóa máy bơm dựa trên các chỉ số đo được!
Ghi dữ liệu vào Google Trang tính bằng Tessel 2
Dự án này bao gồm cách ghi dữ liệu vào Google Trang tính theo hai cách: sử dụng IFTTT với web kết nối hoặc ổ đĩa USB và “sneakernet” mà không có.
Dữ liệu cảm biến đồ thị với Python và Matplotlib
Sử dụng matplotlib để tạo biểu đồ thời gian thực về dữ liệu nhiệt độ được thu thập từ cảm biến TMP102 được kết nối với Raspberry Pi.
Nếu bạn có bất kỳ phản hồi nào về hướng dẫn, vui lòng truy cập phần bình luận hoặc liên hệ với nhóm hỗ trợ kỹ thuật của chúng tôi tại Hỗ trợ kỹ thuật@sparkfun.com.

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

SparkFun DEV-13712 Bo mạch phát triển SparkFun [tập tin pdf] Hướng dẫn sử dụng DEV-13712, DEV-11114, DEV-09873, CAB-12016, COM-13833, COM-13004, PRT-00115, PRT-08431, DEV-13712 Bo mạch phát triển SparkFun, DEV-13712, Bo mạch phát triển SparkFun, Bo mạch phát triển, Bo mạch

Tài liệu tham khảo

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