Tulip を使用した Zebra プリンターのトラブルシューティング

Tulipとの連携におけるZebraプリンターの一般的な問題について理解しましょう。

デバッグ手順

何が機能していて、何が機能していないかを特定することが重要です。まず、どの方式／ドライバーが使用されているかを確認してください。

シリアル

Player

Player で開発者コンソールを開きます。
開発者コンソールがある場合は、「ConnectSerial」トリガーが正常に動作していることを確認してください。a. 接続できない場合は、COM ポートが間違っている可能性があります。
print コマンドの送信を試みてください。a. 何も出力されず、エラーも送信されない場合は、zcode が間違っています。b. 何も出力されず、エラーが送信される場合は、そのエラーを確認してください。

エッジデバイス（Node-RED以外）

デバイスのログを確認してください。
左上のメニューを使用して、「tulip-cell」でフィルタリングすると、読みやすくなります。
serialまたはgeneric-serialを含むエラーを探してください。

エッジデバイス Node-RED

Node-REDの起動前に、プリンターの電源が入っていたことを確認してください。そうでない場合は、デバイスの設定ページからNode-REDを一度オフにしてから、再度オンにしてください。
シリアルノードの「利用可能なポート」ドロップダウンリストに/dev/ttyUSB のパスがリストされていることを確認 してください。EIO の RS232 ポートを使用している場合を除き、その場合は /dev/ttyS のいずれかを使用します。
シリアルノードが「接続済み」と表示されていることを確認してください。
シリアルノードがデバッグペインに出力する内容を観察してください。a. タイムアウトが発生している場合は、Node-REDの実行時にプリンターの電源が入っておらず、接続されていませんでした。Node-REDを再起動してください。
エラーがない場合は、zcodeに問題があります。

ネットワーク

Player

FAQ「プリンタのIP アドレスは？」に記載されている方法のいずれかを使用して、プリンタの IP アドレスが正しいことを確認してください。a. 注意！設定ラベルから IP アドレスを取得する場合、プリンタはアドレスの各バイトを 3 文字ずつ（例：010.001.002.003）で印刷します。Tulip はこの形式を認識できません！先頭の 0 を削除してください：10.1.2.3。
開発者コンソールを確認してください。エラーが表示されない場合は、Zコードに誤りがあります。

Zebraプリンターに初めて接続する際は、ZPLエラーが発生していないことを確認するために、簡単な印刷を試してみてください。次のようなトリガーを使用します：

このようなエラーが発生した場合は、開発者コンソールペインを確認してください。タイムアウトが発生している場合は、IP アドレスが間違っているか、Player がプリンタと同じネットワーク上にない可能性があります。

それでも問題が解決せず、ターミナルにアクセスできる場合は、「ping (ここにIPアドレスを入力)>」を実行してください。

エッジデバイス

Edge Device がオンライン状態であることを確認し、トリガーが正しいデバイスやステーションに設定されているかなどを確認してください。
エッジデバイスは、LAN ポートのみを使用してプリンターに接続されていることを確認してください！a. エッジデバイスの WAN ポートに何かが接続されている場合、Wi-Fi も設定されているにもかかわらず、その接続を介してインターネットへの接続を試みます！
FAQ に記載されている方法のいずれかを使用して、プリンタの IP アドレスが正しいことを確認してください：（プリンタの IP アドレスは？）a. 注意！設定ラベルからIPアドレスを取得する場合、プリンターはアドレスの各バイトを3文字ずつ（例：010.001.002.003）で出力します。Tulipはこの形式を認識しません！先頭のゼロを削除してください：10.1.2.3。
デバイスのログにエラーがないか確認してください。ドロップダウンメニューで「tulip-cell」をフィルターに設定し、「zebra」という文字列を探してください。

よくある質問

プリンターのIPアドレスは？

すべてのドライバー：設定ラベルを印刷してください。IPアドレスはラベルの上部に記載されています。
Zebra プリンタのボタンを、LED が 1 回点滅するまで押し続け、その後指を離します。すると、一連のラベルが印刷されます。
一番上のラベルに IP アドレスが記載されていない場合、Zebra プリンターはまだネットワークに接続されていません。電源を入れたばかりの場合は、起動するまで少し待ってください。しばらく電源が入っている場合は、接続を確認してください。
注意！このラベルには、各バイトが3文字になるよう、IPアドレスの先頭にゼロが追加されています。Tulipはこれを認識しません！先頭のゼロを削除する必要があります。例：010.128.000.005 → 10.128.0.5
Windows、LANのみ：ターミナルで「ipconfig」を実行して、IPアドレスを確認してください。
エッジデバイス：エッジデバイスの設定ポータルの「診断」ページにある「DHCPリース」を確認してください。LANに接続されていることを確認すれば、IPアドレスは10.0.5.Xとなります。

プリンターのシリアルポート番号/パスは？

Windows：[スタート] を右クリックし、[デバイスマネージャー] を選択します。[COM デバイス] セクションを展開し、一覧の中から該当するポートを探してください。
このコミュニティ投稿の手法を使って、Tulipにポート番号を自動的に検出させましょう！
エッジデバイス：ポート番号は /dev/ttyUSB$ です。ここで $ は、デバイスが接続された順序番号（0 から始まる）を表します。
例えば、最初に接続されたデバイスであれば、…USB0となります。
注意！Node-REDを使用する場合、Node-REDの起動前にプリンターが接続され、電源が入っている必要があります。デバイスの設定ポータルにあるトグルを切り替えて、Node-REDを再起動してください。

正しいIPアドレスとCOMポートを設定しているのに、プリンターから何も出力されない？

有効なZPLコードであることを確認してください。確認するには、Labelaryにコードを貼り付けてください。コンパイルに失敗する場合は、コードに誤りがあります。

なお、式に行末改行が含まれている場合（例：Enterキーを押したり、複数行のZPLを貼り付けたりした場合）、有効なZPLであってもエラー表示なしに失敗することがあります。ZPLが単一の連続した文字列になるよう、行末改行をすべて削除してください。

ラベルが中心からずれて印刷されるのはなぜですか？

プリンタの設定が、実際に使用しているラベルサイズと異なっているため、「原点」（ラベルの左上隅）の認識がずれています。

zcode で ^LH のような「すべてを左にオフセットする」コマンドを使用して修正することは可能ですが、これはそのラベル1枚のみを修正するだけのものであり、持続可能でも責任ある方法でもありません。さらに、そのオフセットはプリンタの電源を入れ直すまで残ってしまうため、他のラベルの印刷を台無しにしてしまう可能性があります！

これを修正する正しい方法は、Zebra Setup Utilityをダウンロードし、USB経由でプリンターに接続して、このユーティリティを使用して適切なラベルサイズを設定することです。また、このユーティリティを使用して設定ページを印刷し、変更が正しく反映されたことを確認することもできます。

プリンターのランプが点滅しているのはなぜですか？

緑色の点滅：キャリブレーションが必要です。ボタンを1回押してください。
赤色の点滅：紙詰まりや用紙切れなどの問題が発生しています。

Zコードが間違っていると思うのですが、何が間違っているのかわかりません。

最も簡単な方法は、トリガーのデバッグを行い、ログに記録されたトリガーアクションを調査して、実際にZcodeメッセージとして何が送信されているかを確認することです。なお、これにはデバイス設定に保存されているテンプレート情報は含まれていない可能性が高いので、その場合はLabelaryに貼り付けて確認する必要があります。

メッセージに変数が含まれている場合（例：Serialメソッドを使用して式を送信する場合）、それらがnullになっていないことを確認してください！式内の変数がnullになると、メッセージ全体がnullになってしまいます。これは、別の場所で式を出力するか、デバッグペインでトリガーを調べない限り確認できません。

ラベルの取り扱い

ラベルには2種類あることに注意してください。一方のタイプのプリンターでは、もう一方のタイプのラベルを印刷することはできず、ラベルは空白のまま出力されてしまいます！

直接熱転写印刷

プリンタ内部にラベルロールしか入っていない場合は、そのプリンタは直接熱転写式プリンタです。熱を加えると黒く変色し始めるラベルは、直接熱転写式ラベルです。プリンタがラベルに熱を加えると、反応性インクが黒く変色して画像が形成されます。インクとして追加の「材料」は必要なく、ラベルだけで十分です。

熱転写印刷

プリンター内部にリボンとラベルの2つのロールがある場合は、そのプリンターは熱転写式プリンターです。ラベルが熱を加えても反応しない場合は、そのラベルは熱転写ラベルです。

お探しの情報は見つかりましたか？

また、community.tulip.coにアクセスして、質問を投稿したり、他のユーザーが同様の質問を投稿していないか確認することもできます！