Chuyển đến nội dung chính

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ệpNội dungImport vào
ov-tulip-node-red-flow.jsonFlow 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.gzBả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

Overview Camera Station chạy trong Tulip

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​

Tulip Cloud không thể truy cập trực tiếp đến camera của bạn

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.

Cloud Connector Host từ chối IP camera private

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​

  1. Mở giao diện camera và kích hoạt recipe bạn muốn sử dụng.

  2. Vào Node-RED.

  3. Mở menu (góc trên bên phải) và chọn Import.

  4. 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 luồng vào trình chỉnh sửa Node-RED của camera

  5. 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:

Tab Tulip integration sau khi nhập

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ì:

README tích hợp sẵn trong thanh bên info của Node-RED

Nhập luồng vào mọi recipe mà Tulip sẽ sử dụng

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.

Trình chỉnh sửa Node-RED luôn chỉnh sửa recipe đang hoạt động

Để 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": { }
}

Một kết quả trong thanh bên debug của Node-RED

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ọiBodyChức năng
POST /triggerJSON 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 /resultKế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 /rawMọ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ườngLoạiGhi chú
passbooleanPhán quyết cuối cùng của camera.
judgmenttext"pass" hoặc "fail".
capture_idintegerTìm hình ảnh trong Library của camera bằng ID này.
inspection_idinteger
recipe_id, recipe_nameinteger, textRecipe đã chạy.
inspection_timetextThời gian ISO 8601 từ camera.
image_datatextMộ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_urltextLiê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_dataobjectCác trường bạn đã gửi kèm trigger, ví dụ serial.
metadataobjectToàn bộ Capture Metadata trên hình ảnh, bao gồm bất kỳ thứ gì mà recipe thêm vào.
Tại sao trigger_data tách biệt với metadata

Nế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ừ đó.

Tìm recipe ID

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​

  1. Trong Tulip, vào Apps và mở thư mục nơi bạn muốn đặt ứng dụng.

  2. Mở menu ... của thư mục và chọn Import.

  3. Nhấp vào Import a file và chọn overview-camera-station-tulip-app.tar.gz, sau đó nhấn Import.

    Import ứng dụng từ menu thư mục

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.
Phiên bản Tulip của bạn

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.

  1. Vào Apps → Connectors và mở OV Camera (Node-RED template).

  2. Mở Edit environments (hoặc cài đặt kết nối của connector) và thiết lập:

    Cài đặtGiá trị
    Running onTulip 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.100
    Port80
    TLSNo
    Base path/node-red/tulip

    Cài đặt kết nối của connector

  3. Nhấp vào Test connection, sau đó lưu lại.

Connector đã có sẵn các hàm sau:

Sáu hàm của connector

HàmMethod và pathĐầu vàoĐầu ra
Trigger inspectionPOST /triggerserial (text)accepted
Get resultGET /resultpass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial
Get result imageGET /resultimage (Image URL từ image_data, cho một Image widget)
Switch recipePOST /recipeid (integer)switching_to
Set live modePOST /productionenabled (boolean)production_mode, active_recipe_id, active_recipe_name
Get statusGET /statusproduction_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:

Hàm Trigger inspection

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

Hàm Get result và các đầu ra của nó

Gửi nhiều hơn chỉ số serial

Để 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).

Ứng dụng Overview Camera Station trong trình chỉnh sửa Tulip

Điều khiểnChức năng
Trường Serial NumberSố serial của bộ phận. Trigger inspection gửi nó cùng với trigger.
Trigger inspectionKí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 resultGhi 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 recipeKích hoạt recipe với ID đó.
Live mode on / offBật hoặc tắt chế độ production.
Refresh statusHiển thị liệu live mode có đang bật và recipe nào đang hoạt động.
PASS / FAILCác nút thủ công gốc, để ghi kết quả bằng tay.
Kết quả từ camera là chữ thường

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.

Timer của Tulip chạy nhanh nhất mỗi 30 giây

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).

Một dashboard Tulip được xây dựng trên bảng results

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.

TopicHướngNội dung
ov/<serial>/resultcamera → brokerJSON giống như GET /result, cho mỗi lần kiểm tra (QoS 1).
ov/<serial>/statuscamera → 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>/cmdbroker → 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​

  1. 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.

  2. 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.

    Set your plant broker in the MQTT broker node

  3. 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.

  4. Nhấp Deploy. Cả hai node sẽ hiển thị connected khi broker có thể truy cập được.

Kiểm tra mà không cần plant broker

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​

  1. 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.

    An MQTT connector for the plant broker

  2. Để gửi lệnh, thêm các hàm write với topic ov/$camera_serial$/cmd và một message JSON, ví dụ {"action":"trigger","serial":"$part_serial$"}.

    An MQTT write function that triggers the camera

  3. Để nhận kết quả, thêm broker làm nguồn dữ liệu Machine đăng ký vào ov/+/result và ov/+/status, và sử dụng trigger Machines & devices trong ứng dụng của bạn.

Các hàm MQTT trong Tulip chỉ publish

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-feed củ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_url là một liên kết http thuần đến camera. Trình duyệt chặn hoặc làm hỏng hình ảnh http trê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-20261013 vớ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ứngNguyê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ớiTrigger 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 recipeRecipe bạn đã chuyển sang không có tab Tulip integration. Import flow vào recipe đó.
GET /result trả về 404Chư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 LibraryCapture 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 TulipHì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ị disconnectedSai đị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.

Lỗi mà operator thấy khi Tulip không thể kết nối tới 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.