TÀI LIỆU ĐƯỢC HỖ TRỢ BỞI AI
Bạn muốn biết điều gì?
Kết Nối với Tulip
Tulip là một nền tảng no-code dành cho các ứng dụng vận hành tuyến đầu. Hướng dẫn này kết nối OV80i với Tulip bằng một bộ công cụ có sẵn, để trạm vận hành trong Tulip có thể:
- Kích hoạt một lần kiểm tra và gửi kèm số serial của bộ phận (hoặc bất kỳ trường nào khác).
- Đọc kết quả: pass/fail, recipe, capture ID, thời gian và hình ảnh đã chụp.
- Chuyển đổi recipe khi sản phẩm thay đổi.
- Bật và tắt chế độ live (production).
- Ghi lại mọi kết quả vào Tulip Table và hiển thị trên dashboard.
Bạn không phải tự xây dựng bất kỳ phần nào. Tải xuống hai tệp bên dưới, import chúng, trỏ chúng đến camera của bạn, và bạn đã sẵn sàng vận hành.
Tải xuống bộ công cụ
| Tệp | Nội dung | Import vào |
|---|---|---|
| ov-tulip-node-red-flow.json | Flow Node-RED cho camera. Thêm các HTTP endpoint cho trigger, result, recipe switch, live mode và status, cùng với MQTT tùy chọn. Có README tích hợp sẵn. | Trình chỉnh sửa Node-RED của camera |
| overview-camera-station-tulip-app.tar.gz | Bản export Tulip của ứng dụng Overview Camera Station, HTTP connector của nó (6 hàm) và bảng kết quả. | Tulip, Apps |

Cách thức kết hợp
Tulip app (operator station) OV80i camera
┌──────────────────────────┐ ┌───────────────────────────────┐
│ Trigger / Get result / │ HTTP │ Node-RED "Tulip integration" │
│ Switch recipe / Live │ ─────────────▶ │ tab: /node-red/tulip/... │
│ mode buttons │ ◀───────────── │ Trigger node, Capture │
│ │ JSON result │ Metadata, All Block Outputs │
└──────────────────────────┘ └───────────────────────────────┘
▲ │
│ runs through a Tulip Edge device or │ optional MQTT:
│ On-Premise Connector Host on the ▼ ov/<serial>/result
│ camera's network plant MQTT broker
Tulip gọi camera thông qua một HTTP connector. Flow Node-RED trên camera trả lời những lệnh gọi đó, kích hoạt các lần kiểm tra và chuyển kết quả của camera thành JSON phẳng, đơn giản mà Tulip có thể ánh xạ trực tiếp vào các biến.
Trước khi bắt đầu
Một connector chạy trên Cloud Connector Host của Tulip sẽ từ chối các địa chỉ private như 10.x.x.x hoặc 192.168.x.x. Kiểm tra kết nối sẽ thất bại với thông báo "Address 10.250.0.100 resolved to 10.250.0.100, which is forbidden", và các nút trong app hiển thị "Connector function failed to connect to its target server".
Để truy cập camera trên mạng nhà máy, bạn cần một trong các thiết bị sau trên cùng mạng với camera:
- một Tulip Edge device (Edge IO, Edge MC), hoặc
- một On-Premise Connector Host.
Sau đó, đặt Running on của connector thành host đó. Hãy hỏi quản trị viên Tulip của bạn nếu không chắc chắn bạn có loại nào.

Bạn cũng cần:
- Một OV80i mà bạn có thể truy cập bằng trình duyệt, và địa chỉ IP của nó.
- Recipe bạn muốn điều khiển từ Tulip, với trigger được đặt thành Node-RED. Nếu recipe sử dụng chế độ trigger khác, node Trigger của flow sẽ không làm gì.
- Một tài khoản Tulip có thể tạo apps và connectors.
Bước 1: Nhập luồng Node-RED trên camera
-
Mở giao diện camera và kích hoạt recipe bạn muốn sử dụng.
-
Vào Node-RED.
-
Mở menu (góc trên bên phải) và chọn Import.
-
Nhấp vào select a file to import, chọn
ov-tulip-node-red-flow.json, chọn new flow, sau đó Import.
-
Nhấp Deploy.
Một tab mới có tên Tulip integration sẽ xuất hiện. Nó được bố trí thành năm phần được đánh số, mỗi phần cho một job:

File README của tab (chọn tab, sau đó mở thanh bên info) liệt kê mọi endpoint, để bất kỳ ai mở luồng sau này đều biết nó làm gì:

Mỗi recipe có luồng Node-RED riêng. Khi một recipe được kích hoạt, camera sẽ tải lại Node-RED với luồng của recipe đó. Nếu bạn chuyển từ Tulip sang một recipe không có tab Tulip integration, camera sẽ ngừng phản hồi Tulip cho đến khi bạn chuyển lại. Nhập và deploy luồng trong mỗi recipe mà bạn dự định chuyển đổi.
Để thêm luồng vào một recipe khác, hãy kích hoạt recipe đó trước, sau đó mở lại Node-RED.
Kiểm tra hoạt động
Từ bất kỳ máy tính nào trên mạng của camera, chạy:
curl -X POST http://CAMERA_IP/node-red/tulip/trigger \
-H "Content-Type: application/json" \
-d '{"serial":"SN-24-118734","operator":"line-2"}'
# about 1.5 seconds later
curl http://CAMERA_IP/node-red/tulip/result
Trigger trả về 202 ngay lập tức. Kết quả trông như thế này, và cùng một object sẽ hiển thị trong thanh bên debug của Node-RED:
{
"pass": false,
"judgment": "fail",
"capture_id": 1923,
"inspection_id": 12,
"recipe_id": 5,
"recipe_name": "Recipe 1 (copy)",
"inspection_time": "2026-11-09T05:45:02.710681Z",
"image_data": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
"image_url": "http://CAMERA_IP/edge/v2/files/library_captures/1794203102931.jpg",
"trigger_data": { "serial": "SN-24-118734", "operator": "line-2" },
"metadata": { }
}

Các endpoint mà luồng thêm vào
Tất cả các đường dẫn đều nằm trên camera, dưới http://CAMERA_IP/node-red/tulip.
| Lệnh gọi | Body | Chức năng |
|---|---|---|
POST /trigger | JSON phẳng tùy chọn, ví dụ {"serial":"SN-1","operator":"line-2"} | Kích hoạt một lần kiểm tra. Các trường chuỗi và số được lưu cùng với ảnh chụp dưới dạng Capture Metadata. Trả lời 202 với {accepted, at, result_url} ngay lập tức. |
GET /result | Kết quả mới nhất, được làm phẳng cho Tulip (các trường bên dưới). 404 cho đến lần kiểm tra đầu tiên. | |
POST /recipe | {"id": 5} | Chuyển đổi recipe. Trả lời 202 trước, sau đó chuyển đổi. Xác nhận bằng GET /status (khoảng 2,5 giây). |
POST /production | {"enabled": true} | Bật hoặc tắt chế độ live (production) và trả về trạng thái mới. |
GET /status | {production_mode, active_recipe_id, active_recipe_name, last_result} | |
GET /raw | Mọi thứ mà camera đã báo cáo cho lần kiểm tra cuối cùng. Sử dụng nó để tìm các trường bổ sung cần thêm. |
Các trường kết quả
| Trường | Loại | Ghi chú |
|---|---|---|
pass | boolean | Phán quyết cuối cùng của camera. |
judgment | text | "pass" hoặc "fail". |
capture_id | integer | Tìm hình ảnh trong Library của camera bằng ID này. |
inspection_id | integer | |
recipe_id, recipe_name | integer, text | Recipe đã chạy. |
inspection_time | text | Thời gian ISO 8601 từ camera. |
image_data | text | Một ảnh JPEG 640 px của lần capture bên trong kết quả, dưới dạng giá trị data:image/jpeg;base64,... (khoảng 13 KB). Đây là những gì ứng dụng Tulip hiển thị: không cần kết nối thêm đến camera và hoạt động trên các trang https của Tulip. |
image_url | text | Liên kết đến hình ảnh kích thước đầy đủ trên camera, được xây dựng từ địa chỉ bạn đã gọi. Chỉ dùng http thuần, vì vậy chỉ mở được trên thiết bị nằm trong mạng của camera, và không mở được bên trong Tulip (xem Limitations). |
trigger_data | object | Các trường bạn đã gửi kèm trigger, ví dụ serial. |
metadata | object | Toàn bộ Capture Metadata trên hình ảnh, bao gồm bất kỳ thứ gì mà recipe thêm vào. |
trigger_data tách biệt với metadataNếu flow của chính recipe cũng ghi Capture Metadata, lần ghi cuối cùng sẽ thắng và số serial của bạn có thể không hiển thị trong Library. trigger_data luôn giữ chính xác những gì Tulip đã gửi, vì vậy hãy đọc số serial từ đó.
Mở All Recipes và chọn recipe. ID là số trong thanh địa chỉ, ví dụ /recipes/5/....
Bước 2: Import ứng dụng Tulip
-
Trong Tulip, vào Apps và mở thư mục nơi bạn muốn đặt ứng dụng.
-
Mở menu ... của thư mục và chọn Import.
-
Nhấp vào Import a file và chọn
overview-camera-station-tulip-app.tar.gz, sau đó nhấn Import.
Việc import sẽ tạo ra:
- ứng dụng Overview Camera Station,
- connector HTTP OV Camera (Node-RED template) với sáu hàm,
- bảng Overview AI Inspection Results.
Tulip chỉ import file vào một instance có phiên bản phù hợp. Nếu việc import bị từ chối, hãy xây dựng connector thủ công bằng bảng ở Bước 3 và các ảnh chụp màn hình bên dưới; bố cục ứng dụng được hiển thị ở đầu trang này.
Bước 3: Trỏ connector đến camera của bạn
Các bản export không bao giờ mang theo host hoặc credentials, vì vậy connector cần địa chỉ camera của bạn.
-
Vào Apps → Connectors và mở OV Camera (Node-RED template).
-
Mở Edit environments (hoặc cài đặt kết nối của connector) và thiết lập:
Cài đặt Giá trị Running on Tulip Edge device hoặc On-Premise Connector Host của bạn Server address Địa chỉ IP camera của bạn, ví dụ 192.168.0.100Port 80TLS No Base path /node-red/tulip
-
Nhấp vào Test connection, sau đó lưu lại.
Connector đã có sẵn các hàm sau:

| Hàm | Method và path | Đầu vào | Đầu ra |
|---|---|---|---|
| Trigger inspection | POST /trigger | serial (text) | accepted |
| Get result | GET /result | pass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial | |
| Get result image | GET /result | image (Image URL từ image_data, cho một Image widget) | |
| Switch recipe | POST /recipe | id (integer) | switching_to |
| Set live mode | POST /production | enabled (boolean) | production_mode, active_recipe_id, active_recipe_name |
| Get status | GET /status | production_mode, active_recipe_id, active_recipe_name |
Ví dụ, Trigger inspection gửi số serial trong một JSON body và đọc lại accepted:

Get result ánh xạ từng trường của kết quả đến một đầu ra:

Để truyền work order, operator hoặc station với mỗi trigger, hãy thêm nhiều đầu vào vào Trigger inspection và thêm chúng vào JSON body. Bất kỳ trường string hoặc number nào cũng được lưu cùng với hình ảnh và trả về trong trigger_data.
Bước 4: Chạy station
Mở Overview Camera Station và nhấp Run (hoặc Test để thử trong trình chỉnh sửa).

| Điều khiển | Chức năng |
|---|---|
| Trường Serial Number | Số serial của bộ phận. Trigger inspection gửi nó cùng với trigger. |
| Trigger inspection | Kích hoạt một lần kiểm tra. |
| Get result | Đọc kết quả mới nhất và một ảnh 640 px của lần chụp vào bảng bên trái. Bảng cũng tự làm mới mỗi 30 giây. Đây là hình ảnh được chụp cuối cùng, không phải video trực tiếp. |
| Log camera result | Ghi kết quả của camera (serial, result, station, operator, cycle time) vào bảng results, để nó xuất hiện dưới Recent Inspections. |
| Recipe ID + Switch recipe | Kích hoạt recipe với ID đó. |
| Live mode on / off | Bật hoặc tắt chế độ production. |
| Refresh status | Hiển thị liệu live mode có đang bật và recipe nào đang hoạt động. |
| PASS / FAIL | Các nút thủ công gốc, để ghi kết quả bằng tay. |
Camera ghi pass / fail; các nút thủ công ghi PASS / FAIL. Nếu bạn đếm hoặc lọc trên cột Result, hãy tính đến cả hai, hoặc thay đổi các nút cho khớp.
Tulip không cho phép timer ngắn hơn 30 giây, vì vậy việc làm mới tự động có thể bị trễ. Nhấn Get result sau một trigger để có kết quả ngay lập tức, hoặc sử dụng MQTT (bên dưới), sẽ đẩy mỗi kết quả ngay khi sẵn sàng.
Thêm dashboard
Để theo dõi chất lượng qua một ca làm việc, hãy xây dựng một dashboard Tulip trên bảng results. Ví dụ:
- Pass vs Fail: Donut, nhóm theo Result, phép toán Count of Records.
- Results by station: Bar, nhóm theo Station / Camera và Result, Count of Records.
- Inspections per hour: Line, nhóm theo thời gian tạo của record, Count of Records.
Ví dụ bên dưới được xây dựng theo cách tương tự trên một bảng results với cột pass kiểu boolean, cũng cho phép hiển thị một giá trị đơn Pass rate (Percent Where True).

Tùy chọn: Sử dụng MQTT thay vì polling
MQTT cho độ trễ thấp hơn so với HTTP polling: mỗi kết quả được publish khoảng 1.3 giây sau trigger, không cần polling. Phần 5 của flow xử lý việc này. Nó bị tắt theo mặc định.
| Topic | Hướng | Nội dung |
|---|---|---|
ov/<serial>/result | camera → broker | JSON giống như GET /result, cho mỗi lần kiểm tra (QoS 1). |
ov/<serial>/status | camera → broker | {production_mode, active_recipe_id, active_recipe_name, at}, retained. Được publish khi flow khởi động, vì vậy cũng được publish sau mỗi lần chuyển recipe. |
ov/<serial>/cmd | broker → camera | {"action":"trigger","serial":"SN-1"}, {"action":"recipe","id":5} hoặc {"action":"production","enabled":true} |
<serial> là số serial của camera hiển thị trên thanh trên cùng của giao diện camera. Các lệnh gửi đến một serial khác sẽ bị bỏ qua, vì vậy nhiều camera có thể chia sẻ chung một broker.
Bật MQTT trên camera
-
Trong tab Tulip integration, nhấp đúp vào Publish, sau đó nhấp vào biểu tượng bút chì bên cạnh Server.
-
Thiết lập địa chỉ broker, port, TLS và thông tin đăng nhập (template sử dụng
broker.example.local:1883). Nhấp Update, sau đó nhấp Done.
-
Chọn các node Publish và Commands rồi nhấn Ctrl+E (Cmd+E trên Mac) để kích hoạt chúng.
-
Nhấp Deploy. Cả hai node sẽ hiển thị connected khi broker có thể truy cập được.
Camera chạy MQTT broker riêng của nó trên port 1883. Đặt server thành 127.0.0.1 để thử flow trước khi plant broker của bạn sẵn sàng. Không sử dụng cho production.
Phía Tulip
-
Tạo một connector MQTT với địa chỉ và port của broker, QoS 1, chạy trên cùng thiết bị Edge hoặc On-Premise Connector Host.

-
Để gửi lệnh, thêm các hàm write với topic
ov/$camera_serial$/cmdvà một message JSON, ví dụ{"action":"trigger","serial":"$part_serial$"}.
-
Để nhận kết quả, thêm broker làm nguồn dữ liệu Machine đăng ký vào
ov/+/resultvàov/+/status, và sử dụng trigger Machines & devices trong ứng dụng của bạn.
Một hàm connector MQTT của Tulip có thể gửi message nhưng không thể đọc chúng. Kết quả và trạng thái được nhận thông qua nguồn dữ liệu Machine.
Hạn Chế
Hãy nắm rõ những điều này trước khi triển khai bộ công cụ lên dây chuyền:
- Không có video trực tiếp trong Tulip. Panel hiển thị hình ảnh được chụp cuối cùng (hình 640 px), được làm mới khi người vận hành nhấn Get result và theo bộ đếm 30 giây. Chế độ xem trực tiếp của camera là luồng H.264 được hiển thị trong trang web của camera, không có MJPEG hoặc URL snapshot nào mà widget Image của Tulip có thể hiển thị. Việc nhúng trang
http://CAMERA_IP/live-feedcủa camera cần widget Web Page của Tulip (được kích hoạt bởi bộ phận hỗ trợ của Tulip) và địa chỉ https cho camera, vì các trang Tulip là https và camera chỉ phục vụ http thuần túy. - Hình ảnh kích thước đầy đủ không mở được bên trong Tulip.
image_urllà một liên kếthttpthuần đến camera. Trình duyệt chặn hoặc làm hỏng hình ảnhhttptrên các trang https của Tulip, và iPad Player từ chối chúng. Sử dụng nó từ một thiết bị trên mạng của camera, hoặc đặt một reverse proxy https phía trước camera. - Tulip cần đường dẫn đến camera. Các connector trên Cloud Connector Host của Tulip không thể truy cập các địa chỉ riêng tư. Sử dụng thiết bị Tulip Edge hoặc On-Premise Connector Host trên mạng của camera.
- Tốc độ làm mới. Các bộ đếm của Tulip chạy nhanh nhất là mỗi 30 giây. Để có kết quả ngay khi sẵn sàng, nhấn Get result sau một trigger hoặc sử dụng MQTT.
- Một flow cho mỗi recipe. Flow phải được import vào mọi recipe mà Tulip chuyển sang, nếu không các endpoint sẽ biến mất sau khi chuyển.
- Kích thước kết quả. Hình ảnh nhúng thêm khoảng 13 KB vào mỗi kết quả, bao gồm cả các message MQTT. Điều này phù hợp với các biến của Tulip và các broker có giới hạn mặc định.
- Đã thử nghiệm trên. Firmware OV80i
dev-20261013với Tulip r393. Các endpoint và tên node có thể khác nhau trên các model camera và firmware khác.
Khắc Phục Sự Cố
| Triệu chứng | Nguyên nhân và cách khắc phục |
|---|---|
| Kiểm tra connector thất bại với thông báo "... which is forbidden" | Connector đang chạy trên Cloud Connector Host. Đặt Running on thành thiết bị Tulip Edge hoặc On-Premise Connector Host của bạn. |
| Ứng dụng hiển thị "Connector function failed to connect to its target server" | Giống như trên, hoặc camera đã tắt hoặc không thể truy cập được từ connector host. Kiểm tra IP camera và thử lệnh curl từ mạng đó. |
Trigger trả về 202 nhưng không có kết quả mới | Trigger của recipe không được đặt thành Node-RED, hoặc recipe chưa được tải. Kiểm tra thanh trên cùng của camera và cài đặt trigger của recipe, sau đó trigger lại. |
Endpoints trả về 404 sau khi chuyển recipe | Recipe bạn đã chuyển sang không có tab Tulip integration. Import flow vào recipe đó. |
GET /result trả về 404 | Chưa có inspection nào chạy kể từ khi flow được deploy. Hãy trigger một lần. |
| Serial number bị thiếu trong Library | Capture Metadata của chính recipe đã ghi đè lên nó. Hãy đọc từ trigger_data trong kết quả thay thế. |
| Hình ảnh không hiển thị trong Tulip | Hình ảnh đến từ image_data, được điền sau mỗi lần inspection. Kiểm tra rằng Get result image trả về một giá trị bắt đầu bằng data:image/jpeg;base64. Nếu nó trống, hãy re-import flow (các phiên bản cũ hơn chỉ trả về image_url, mà các trang https của Tulip không thể tải từ camera). |
| Các node MQTT hiển thị disconnected | Sai địa chỉ broker, port, TLS hoặc thông tin đăng nhập, hoặc broker không thể truy cập được từ camera. |

Bước tiếp theo
- Environment Variables: giữ các cài đặt dành riêng cho deployment nằm ngoài flow.
- Setting Up Outputs: cách Node-RED tích hợp vào flow pass/fail, và các output PLC song song với Tulip.