Tham chiếu tích hợp RFID
Bộ tài liệu này dành cho đội kỹ thuật nối đầu đọc RFID Nextwaves NRN vào phần mềm của mình: ERP, WMS, hay một màn hình bán hàng chạy trình duyệt. Công cụ là SDK chính thức Nextwaves-Industries/nextwaves-sdk, phiên bản 1.0.0, có cho năm ngôn ngữ.
SDK lo trọn phần nói chuyện với thiết bị: mở kết nối serial, gói mỗi lần đọc thẻ thành một sự kiện gọn giao cho callback của bạn, và có sẵn các lệnh cấu hình đầu đọc. Ứng dụng của bạn chỉ nhận sự kiện và quyết định nghiệp vụ, không phải đụng vào giao thức tầng thấp.
Hành trình tích hợp
Một dự án tích hợp RFID đi qua bốn chặng, và bộ tài liệu xếp đúng theo thứ tự đó:
| Chặng | Việc của bạn | Đọc trang |
|---|---|---|
| Hiểu bài toán | Nắm mô hình dữ liệu RFID khác mã vạch chỗ nào, và kiến trúc tích hợp trông ra sao. Chưa cần thiết bị | Cần biết trước khi triển khai, rồi Tích hợp vào phần mềm của bạn |
| Viết code | Nối đầu đọc, nhận thẻ, chống trùng; tra cứu API khi viết | Bắt đầu nhanh, Đọc thẻ và chống trùng, Tham chiếu SDK |
| Sinh mã cho hàng của bạn | Encode và ghi EPC theo chuẩn GS1, khi dự án tự cấp mã | Mã hóa EPC |
| Ra hiện trường | Chọn ăng-ten, đặt công suất, đo vùng đọc với hàng thật | Hướng dẫn triển khai |
| Nghiệm thu | Rà danh sách cuối trước khi cho ghi số liệu thật | Kiểm tra production |
Toàn bộ luồng nghiệp vụ phát triển và kiểm thử được trước khi có thiết bị thật; đến lúc có đầu đọc thì đấu nối mà không phải sửa mã ứng dụng. Ba trang phụ lục, thuật ngữ, giao thức đầu đọc và tự viết receive loop, để tra khi cần chứ không nằm trên đường đi chính.
Chọn ngôn ngữ
| Package | Hợp với |
|---|---|
| Python | Service tại kho và tích hợp backend; lựa chọn cho hầu hết dự án |
| TypeScript / Web Serial | Màn hình bán hàng và kiosk chạy trong trình duyệt |
| Go, Rust, C++ | Hệ thống đã có sẵn codebase ở các ngôn ngữ này |
Chưa bị ràng buộc bởi codebase nào thì bắt đầu với Python cho service tại kho, hoặc Web Serial cho giao diện trình duyệt: hai bản này có sẵn vòng đọc liên tục, cài xong là nhận thẻ qua callback. Đội Go, Rust hoặc C++ dùng package cùng ngôn ngữ và thêm vòng đọc theo mẫu hoàn chỉnh ở phụ lục receive loop.
Các package
| Ngôn ngữ | Package | Cài đặt |
|---|---|---|
| Python | nrn-sdk | pip install nrn-sdk |
| TypeScript / Web Serial | @nextwaves/nrn-sdk | npm install @nextwaves/nrn-sdk |
| Rust | nrn-sdk | cargo add nrn-sdk |
| Go | github.com/Nextwaves-Industries/nextwaves-sdk/sdk/nation/go | go get github.com/Nextwaves-Industries/nextwaves-sdk/sdk/nation/go@v1.0.0 |
| C++ | sdk/nation/cpp | CMake FetchContent hoặc add_subdirectory() |
Mã nguồn của cả năm package nằm trong sdk/nation/ của repository, ví dụ chạy được nằm trong examples/. Mã trong /sdk/nation/ và /examples/ theo giấy phép MIT; /legacy/ và /driver/ giữ nguồn gốc và giấy phép riêng.
Kiến trúc
Ứng dụng chỉ phụ thuộc NRNReader và cấu trúc tag mà nó trả về; toàn bộ việc giao tiếp thiết bị nằm gọn trong SDK. Cách ghép dòng sự kiện thẻ vào ERP hoặc WMS, bằng những khái niệm dev backend đã quen, nằm ở tích hợp RFID vào phần mềm của bạn.
Driver
Đầu đọc NRN nối qua RS-232 hoặc cầu CP210x USB-to-UART. Repository kèm sẵn driver CP210x cho Windows, Windows CE và macOS trong thư mục driver/. Cài driver trước thì serial port mới hiện ra cho SDK thấy.
Cách đọc bộ tài liệu này
Ba loại nội dung trong bộ, với độ chắc khác nhau, đều được ghi rõ tại chỗ:
- Hành vi của SDK: đã đối chiếu với mã nguồn
1.0.0trongsdk/nation/, cứ thế mà dùng. - Nội dung phụ thuộc firmware: tài liệu là chỗ để bắt đầu, còn firmware trên chính chiếc đầu đọc của bạn mới là căn cứ cuối cùng, nên các trang liên quan đều nhắc bạn đối chiếu.
- Hướng dẫn triển khai: khuyến nghị vận hành, phải thử lại với thẻ, sản phẩm, đầu đọc và quy định vô tuyến tại nơi lắp đặt.
Khi encode EPC, dùng bản hiện hành của GS1 EPC Tag Data Standard và Tag Data Translation Standard.
Hỗ trợ
tech@nextwaves.industries- nextwaves.com