문제 해결

IoT box connection

Unable to locate the pairing code to connect the IoT box

The pairing code should be printed on receipt printers connected to the IoT box and should also be displayed on connected monitors.

The pairing code does not show under the following circumstances:

  • The IoT box is already connected to an Odoo database.

  • The IoT box is not connected to the Internet.

  • The code is only valid for 5 minutes after the IoT box has started. It is automatically removed from connected displays when this time has expired.

  • IoT 박스 이미지가 너무 오래된 버전입니다. 이전 버전으로 IoT 박스 이미지를 사용 중인 경우 IoT 박스의 SD 카드를 다시 구동하여 이미지를 업데이트해야 합니다 (SD 카드 구동 참조).

위에 설명된 방법으로도 문제가 해결되지 않는 경우에는 전원 포트 옆에 고정된 초록색 LED가 표시되는지 확인하여 IoT 박스가 제대로 시작되었는지 확인하세요.

IoT box is connected but it is not showing in the database

IoT 박스가 데이터베이스에 연결되면 재시작될 수 있습니다. 이런 경우 데이터베이스에 나타날 때까지 최대 5분까지 소요될 수 있습니다. IoT 박스가 5분 후에도 계속 표시되지 않는 경우에는 IoT 박스가 데이터베이스에 연결되어 있는지 확인하고 서버가 다중 데이터베이스 환경에서 운영되고 있지 않는지 확인하세요.

To access the database from the IoT box, open a browser and type in the database address.

The IoT box is connected to the Odoo database, but cannot be reached

로컬 네트워크 외부에서는 IoT 박스에 연결할 수 없으므로, IoT 박스와 브라우저가 실행되는 컴퓨터가 동일한 네트워크에 있는지 확인합니다.

The HTTPS certificate does not generate

abbr:HTTPS (하이퍼텍스트 전송 프로토콜 보안) 인증서를 생성하려면, IoT 박스를 사용하기 위해 IoT 박스를 구독해야 합니다. 계정 관리자를 통해 데이터베이스 및 IoT 박스에 대한 IoT 구독 설정을 하기 전에 IoT 박스를 연결하할 경우 보안되지 않은 상태로 연결됩니다.

또한, 방화벽 때문에 HTTPS 인증서가 올바르게 생성되지 않을 수도 있습니다. 이 경우 인증서가 제대로 생성될 때까지 방화벽을 비활성화합니다. 라우터와 같이 방화벽이 내장되어 있는 특정한 장치의 경우에는 HTTPS 인증서를 생성하지 못할 수도 있습니다.

프린터

The printer is not detected

If a printer does not appear in the devices list, go to the IoT box homepage and make sure that it is listed under Printers.

The IoT box Home Page landing page.

프린터가 IoT 박스 홈페이지에 없으면 프린터 서버 를 클릭하고 관리 탭으로 이동하여 프린터 추가 를 클릭합니다. 프린터가 목록에 나타나지 않는 경우 제대로 연결이 되지 않았을 수 있습니다.

The printer outputs random text

대부분의 프린터에서는 자동으로 알맞은 드라이버를 감지하여 선택합니다. 그러나 경우에 따라 자동 감지 메커니즘이 충분하지 않을 수 있으며 드라이버를 찾지 못하면 프린터에서 임의의 문자가 인쇄될 수 있습니다.

이를 해결하기 위해서는 해당 드라이버를 수동으로 선택하면 됩니다. IoT 박스 홈페이지에서 프린터 서버 를 클릭하고 프린터 탭으로 이동하여 목록에서 프린터를 선택합니다. 관리 드롭다운 메뉴에서 프린터 수정 을 클릭합니다. 단계별로 프린터에 해당하는 제조사모델 을 선택합니다.

Edit the printer connected to the IoT box.

참고

Epson and Star receipt printers and Zebra label printers do not need a driver to work. Make sure that no driver is selected for those printers.

The printer is detected but is not recognized correctly

If the printer is not recognized correctly by Odoo and the IoT box, go to the form view of the device (IoT App ‣ Devices ‣Printer Device) and change the subtype. The three options available are: Receipt Printer, Label Printer, and Office Printer.

Sub-type selection in a printer IoT device.

Epson configuration special case

Most Epson printers support printing receipts in Odoo POS using the GS v 0 command. However, the following Epson printer models do not support this command:

  • TM-U220

  • TM-U230

  • TM-P60

  • TMP-P60II

Bypass this issue by configuring the printer to use the ESC * command instead.

Process to force ESC * command
Epson printer compatibility

The first step is to check whether the printer is incompatible with GS v 0 command.

더 보기

프린터에서 ESC * 명령어 실행이 되지 않는 경우에는 다음의 프로세스를 진행할 수 없습니다. 프린터가 ESC * 명령어로 인쇄할 수 있는 경우, 다음 프로세스에 따라 IoT 박스로 프린터를 설정합니다.

IoT box configuration for ESC *

ESC * 명령어로 인쇄가 되도록 IoT 박스를 설정하려면 IoT 앱 ‣ IoT 박스`로 이동하여 :abbr:`IoT (사물인터넷) 박스 홈페이지로 이동합니다. 그런 다음 IP 주소`를 클릭하면 :abbr:`IoT (사물인터넷) 박스 홈페이지로 연결됩니다.

프린터 선택

이제 프린터 서버 버튼을 클릭합니다. 그러면 브라우저가 CUPS 페이지로 리디렉션됩니다. 그 다음 :menuselection:`관리 –> 프린터 –> 프린터 추가`로 이동하여 수정할 프린터를 선택한 다음 :guilabel:`계속`을 클릭합니다.

If the name of the printer is still uncertain, take the following steps:

  1. Take note of the listed printers on the CUPS page.

  2. Turn the printer off and refresh the page.

  3. Now compare the difference with the first list to see which printer disappeared.

  4. Turn the printer back on and refresh the page again.

  5. Double-check the list again to see if the printer re-appears.

  6. The printer that disappeared and reappears again on the listed printers is the name of the printer in question.

참고

This can be Unknown under Local printers.

CUPS naming convention

CUPS 에서 관리자에게 이름, 설명위치 의 세 가지 정보를 묻는 메시지를 표시합니다. 마지막 두 가지 정보는 구체적이지 않아도 됩니다. 그러나 이름 의 경우 ESC * 명령어과 함께 작동하려기 위해서는 특정 규칙을 따라야 합니다.

The Name should match this convention: <printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__

A breakdown of the naming convention:

  • printer_name: This is the printer name. It can be any character as long as it does not contain _, /, #, or ` ` (space character).

  • IMC: This stands for Image Mode Column (the simplified name for ESC *).

  • param_1: This stands for the specific parameter:

    • SCALE<X>: Scale of the picture (with the same aspect ratio). X should be an integer describing the scale percentage that should be used.

      Example

      100 is the original size, 50 is half the size, 200 is twice the size.

    • LDV: Low Density Vertical (will be set to High Density Vertical if not specified).

    • LDH: Low Density Horizontal (will be set to High Density Horizontal if not specified).

      참고

      Density parameters might need to be configured in a particular way depending on the printer model.

더 보기

Visit Epson’s ESC * documentation and click on the printer model printer in the table above to see if the printer should set these parameters.

Example

The following are examples of proper and improper name formatting:

Proper name formatting:

  • EPSONTMm30II__IMC__

  • EPSON_TM_U220__IMC_LDV_LDH_SCALE80__

Improper name formatting (this will not prevent printing, but the result might not have the expected printed output):

  • EPSON TMm 30II -> The name cannot have spaces.

  • EPSONTMm30II -> The name itself is correct, but it will not use ESC *.

  • EPSONTMm30II__IMC -> This name is missing the end __.

  • EPSONTMm30II__IMC_XDV__ -> The parameter XDV does not match any existing parameters.

  • EPSONTMm30II__IMC_SCALE__ -> The parameter SCALE is missing the scale value.

Finish adding a printer

이름 제작 규칙에 따라 알맞게 프린터 이름을 설정한 후 계속 을 클릭합니다. 다음으로, 만들기 값을 원시 로 설정하고 모델 값의 경우 이를 원시 대기열 (en) 로 설정합니다.

After completing these steps, click Add Printer. If everything was done correctly, the page should redirect to the Banners page.

이 시점에서 프린터가 만들어지게 되며, 이제 IoT 박스에서 프린터를 인식하여 Odoo 서버와 동기화만 하면 됩니다 (몇 분 정도 걸릴 수 있음).

Adding the printer to Odoo PoS

프린터가 Odoo 데이터베이스에 표시되면 POS 설정에서 해당 프린터를 IoT 프린터로 선택해야 합니다. POS 앱 ‣ 설정 ‣ 연결된 장치 ‣ IoT 박스 ‣ 수신 프린터 ‣ 저장 에 따라 진행하세요.

참고

프린터가 잘못 설정된 경우 (텍스트가 계속 임의로 인쇄되거나 인쇄하도록 수신된 파일이 너무 크거나 작은 경우), 프린터 이름에 *CUPS*를 붙이는 방법으로는 수정할 수 없습니다. 대신 위에 있는 과정을 반복하여 다른 프린터를 처음부터 설정하면 매개변수가 수정되어 프린터를 생성할 수 있습니다.

Example setup of the Epson TM-U220B printer using ESC

다음은 ESC * 명령어를 사용한 TM-U220B 프린터 모델의 문제 해결 프로세스의 예시입니다. 아래 그림의 영수증은 알맞은 형식 (이론상)으로 올바르게 인쇄된 영수증의 예입니다.

Properly formatted receipt picture from a demo database.

TM-U220B 프린터 모델에서는 ‘GS v 0’이 지원되지 않으므로 알맞게 양식이 적용되기 전에 영수증을 바로 인쇄하려고 하면 작동하지 않습니다. 대신 임의의 문자가 인쇄됩니다:

Printer paper with seemingly random characters.

To properly configure formatting for the Epson TM-U220B printer model take the following steps.

Epson 웹사이트에서 두 명령어에 대한 호환성 GS v 0 and ESC * 을 확인한 후 실제로 TM-U220B는 GS v 0 과는 호환되지 않지만 ESC * 와 호환되는 것을 확인할 수 있습니다.

Epson compatibility evaluation from Epson website.

When adding the printer, CUPS will ask which printer should be added:

Administration menu, add printer selection.

이 경우, 프린터가 USB (범용 직렬 버스)`로 연결되어 있으므로 :guilabel:`검색된 네트워크 프린터`로는 찾을 수 없습니다. 대신 :guilabel:`로컬 프린터 아래의 알 수 없음 선택 항목에 있는 경우가 대부분입니다. 프린터 USB 케이블을 IoT 박스에서 뽑은 후 페이지를 새로고침하면 알 수 없음 프린터가 사라집니다. 다시 연결하면 프린터가 다시 나타나므로, 이 프린터가 문제의 프린터가 아닌 것을 알 수 있습니다.

분류 규칙에서는 ESC * 명령어를 사용하여 인쇄해야 하므로 __IMC 를 반드시 추가해야 합니다. density 매개변수에 대해 자세히 알아보려면 Epson의 ESC * 사이트 에서 프린터 모델을 참조하세요.

Epson TM-U220 specifications on manufacturer's website.

해당하는 TM-U220 모델의 경우, m`은 0 또는 1이어야 합니다. 그림에서 분홍색 상자 아래에 있는 :guilabel:`설명`을 보면, `m 값은 0, 1, 32 또는 33 중에서 입력합니다. 따라서 이 프린터에서는 m 값으로 32 또는 33을 사용할 수 없습니다 (그렇지 않으면 문자가 임의로 인쇄됩니다).

표에는 숫자 값 32와 33이 포함되어 있으며, 두 숫자 모두 수직 데이터의 비트 수`가 24로 설정된 경우에 사용합니다. 이는 *고밀도 수직* 방식을 의미합니다. Epson TM-U220을 설정하는 경우, 이 프린터 모델에서는 `ESC * 명령어로 고밀도 수직 방식이 지원되지 않으므로 *서밀도 수직*을 강제 설정해야 합니다.

To add a Low Vertical Density, add the LDV parameter to the naming convention.

Add a *Low Vertical Density* (the `LDV` parameter) to the naming convention.

Click Continue to proceed. Next, set the Make value to Raw and for the Model value, set this to Raw Queue (en).

Epson TM-U220 specifications on manufacturers website.

그러나 명명 규칙으로 EpsonTMU220B__IMC_LDV__ 를 인쇄하면 영수증을 인쇄할 수 있으나 너무 커서 여백을 벗어납니다. 이 문제를 해결하려면 ‘SCALE<X>’ 매개 변수를 사용하여 영수증 크기에 맞게 새 프린터 (및 명명 규칙)를 추가하여 조정합니다.

Here are some examples:

Printer Naming Convention

EpsonTMU220B__IMC_LDV__

EpsonTMU220B__IMC_LDV_SCALE75__

EpsonTMU220B__IMC_LDV_LDH__

EpsonTMU220B__IMC_LDV_LDH_SCALE35__

Receipt example format. Receipt format using naming convention: EpsonTMU220B__IMC_LDV__. Receipt format using naming convention: EpsonTMU220B__IMC_LDV_SCALE75__. Receipt format using naming convention: EpsonTMU220B__IMC_LDV_LDH__. Receipt format using naming convention: EpsonTMU220B__IMC_LDV_LDH_SCALE35__.

DYMO LabelWriter print issue

DYMO LabelWriter에서 IoT 박스를 사용하여 인쇄 시 발생되는 문제가 있습니다. OpenPrinting CUPS 서버에서 :guilabel:` 로컬 원시 프린터` 드라이버를 사용하여 프린터를 설치합니다. 인쇄하려면 제조사 및 모델 을 정확히 설정해야 하므로 장치를 사용할 때 알맞은 드라이버를 참조합니다.

Additionally, a new printer needs to be added to reduce a print delay that occurs after updating the driver.

중요

DYMO LabelWriter 450 DUO 프린터는 Odoo 및 IoT 박스와 함께 사용하는 데 권장되는 DYMO 프린터입니다. 반드시 미리 IoT 박스에 연결되어 인식되는 상태여야 합니다.

DYMO LabelWriter 450 DUO 프린터에는 두 개의 프린터인 라벨 프린터와 테이프 프린터가 하나로 합쳐져 있습니다. 다음 프로세스를 설정할 때 알맞은 모델 (DYMO LabelWriter 450 DUO Label (영어) 또는 DYMO LabelWriter 450 DUO Tape (영어))을 선택하는 것이 중요합니다.

To keep things consistent, both of the following processes detail the configuration for the DYMO LabelWriter 450 DUO Label (en) model. Change the model when needed.

DYMO LabelWriter not printing

In the case where the DYMO LabelWriter is not printing anything, a new driver needs to be installed.

먼저 IoT 박스 홈페이지 하단에 있는 프린터 서버 를 클릭하면 OpenPrinting CUPS 콘솔이 열립니다. 그 다음, 상단에 있는 메뉴에서 프린터 를 클릭합니다. 문제가 있는 프린터를 클릭한 후 첫 번째 드롭다운 메뉴에서 유지관리 를 선택합니다. 그런 다음 두 번째 드롭다운 메뉴에서 프린터 수정 을 선택합니다.

Modify the make and model of the DYMO LabelWriter. Maintenance and Modify drop-down menus highlighted.

Next, select the specific network connection/printer that the modification should be made on. Click Continue.

Printer selection screen with Continue highlighted.

On the next page, click Continue to proceed to set the Make of the printer.

Printer modification screen with Continue highlighted.

Under Make select DYMO from the menu. Click on Continue to set the Model.

Setting the make page, with DYMO and continue highlighted.

다음 페이지에서 모델DYMO LabelWriter 450 DUO 라벨 (en) (또는 사용 중인 DYMO 프린터 모델)로 설정합니다. 프린터 수정 를 클릭하여 새 드라이버 설정을 완료하면 확인 페이지가 나타납니다.

Setting the printer model page with DYMO LabelWriter 450 DUO Label (en) highlighted.

After being redirected to a confirmation page, acknowledging a successful update, click on the Printers button in the top menu.

새로 업데이트된 DYMO LabelWriter 450 DUO Label (또는 사용 중인 DYMO 프린터 모델)을 포함하여 OpenPrinting CUPS 서버에 설치되어 있는 모든 프린터가 나타납니다. 방금 업데이트한 프린터를 클릭합니다.

테스트 라벨을 인쇄하려면 관리 드롭다운 메뉴 왼쪽에 있는 유지 관리 드롭다운 메뉴를 클릭하고 테스트 페이지 인쇄 를 선택합니다. 드라이버 업데이트에 성공한 경우 테스트 라벨이 10초 후에 인쇄됩니다.

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

To reduce this delay a new printer will need to be added, follow the process below.

DYMO LabelWriter print delay

드라이버 수정 후 지연 문제를 해결하려면 반드시 프린터를 재설치해야 합니다. 프린터를 재설치하려면 IoT 박스 홈페이지 하단에 있는 프린터 서버 를 클릭하여 OpenPrinting CUPS 관리 페이지를 엽니다. 그런 다음 상단 메뉴에서 관리 를 클릭한 다음 프린터 추가 를 클릭합니다.

DYMO LabelWriter 450 DUO 프린터에서 전혀 인쇄가 되지 않거나 인식이 되지 않는 경우에는 (RAW 드라이버 유형 있음) 장치 드라이버를 업데이트합니다. DYMO LabelWriter not printing 를 참조하세요.

Add a printer button highlighted on the Printer CUPS management page.

다음 화면에 있는 :guilabel:` 로컬 프린터` 섹션에서 미리 설치되어 있는 DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO 라벨) (또는 사용 중인 DYMO 프린터 모델)을 선택합니다. 계속 을 클릭합니다.

Add a printer screen on OpenPrinting CUPS with DYMO LabelWriter 450 DUO Label highlighted.

On the following screen, modify the Name to something recognizable, as the original printer will still be present. Click Continue to be taken to the next screen.

Rename printer page in the 'Add a Printer' flow, with the name field highlighted.

Next, choose the Model. Select DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used), and finally, click Add Printer to complete the installation.

Choose model screen on the OpenPrinting CUPS console with model and add a printer highlighted.

After being redirected to a confirmation page, acknowledging a successful installation, click on the Printers button in the top menu.

새로 설치한 DYMO LabelWriter 450 DUO Label (또는 사용 중인 DYMO 프린터 모델)을 포함하여 OpenPrinting CUPS 서버에 설치되어 있는 모든 프린터가 나타납니다. 방금 설치한 프린터를 클릭합니다.

Printer page with newly installed printer highlighted.

테스트 라벨을 인쇄하려면 관리 드롭다운 메뉴 왼쪽에 있는 유지 관리 드롭다운 메뉴를 클릭하고 테스트 페이지 인쇄 를 선택합니다. 테스트 라벨이 즉시 인쇄됩니다 (1~2초 지연).

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

The Zebra printer does not print anything

Zebra 프린터는 인쇄 시 ZPL (Zebra 프로그래밍 언어) 코드 형식에 매우 민감합니다. 프린터에서 아무 것도 인쇄되지 않거나 빈 라벨이 인쇄되는 경우 개발자 모드 에서 설정 ‣ 기술 ‣ 사용자 인터페이스 ‣ 보기 에 액세스하여 프린터로 전송되는 보고서 형식을 변경한 후 해당 템플릿을 찾으세요.

더 보기

Check out Zebra’s instructions on printing ZPL files here.

Barcode scanner

The characters read by the barcode scanner do not match the barcode

기본적으로 대부분의 바코드 스캐너는 US QWERTY 형식으로 설정됩니다. 바코드 스캐너에서 다른 레이아웃을 사용하는 경우 디바이스 양식 보기(IoT 앱 ‣ 디바이스 ‣ 바코드 디바이스)로 이동하여 알맞은 형식을 선택합니다.

Nothing happens when a barcode is scanned

POS 환경 설정에서 디바이스가 알맞게 선택되었는지 확인하고 모든 바코드 끝에 엔터 문자 (키코드 28)를 보내도록 바코드가 설정되어 있는지 확인합니다. 이렇게 하려면 POS 앱 ‣ POS의 점 세 개 메뉴 ‣ IoT 박스 섹션 ‣ 편집 으로 이동합니다.

The barcode scanner is detected as a keyboard

중요

Some barcode scanners do not advertise themselves as barcode scanners but as a USB keyboard instead, and will not be recognized by the IoT box.

The device type can be manually changed by going to its form view (IoT App ‣ Devices ‣ Barcode Device) and activating the Is scanner option.

Modifying the form view of the barcode scanner.

Barcode scanner processes barcode characters individually

바코드 스캐너와 페어링된 모바일 장치 또는 태블릿에서 IoT 박스를 통해 Odoo의 모바일 버전에 액세스하면 스캐너는 각 바코드 문자를 개별 스캔으로 처리할 수 있습니다. 이 경우 바코드 스캐너 양식 페이지에서 키보드 레이아웃 옵션을 반드시 바코드 스캐너에 알맞은 언어로 입력해야 합니다.

Access the barcode scanner form page by navigating to IoT App ‣ Devices ‣ Barcode Scanner.

Barcode scanner form page, with keyboard layout option highlighted.

The Keyboard Layout is language based, and the options available vary, depending on the device and the language of the database. For example: English (UK), English (US), etc.

Cash drawer

The cash drawer does not open

금전 등록기가 프린터에 연결되어야 하며 POS 환경 설정 메뉴에서 금전 등록기 확인란에 표시가 되어 있어야 합니다. 이렇게 하려면 POS 앱 ‣ POS의 점 3개 메뉴 ‣ IoT Box 섹션 ‣ 편집 ‣ 영수증 프린터 ‣ 금전등록기 확인란 로 이동합니다.

크기

Scales play a crucial role in the checkout process, especially for products sold by weight, rather than fixed pricing.

Set up Ariva S scales

Odoo에서 Ariva S 시리즈 중량계 (제조사 Mettler-Toledo, LLC.)에 있는 특정한 설정을 수정해야 하며 측량계가 Odoo IoT 박스와 함께 작동하게 하려면 전용 Mettler USB-전용 RJ45 케이블이 필요하다는 내용을 확인했습니다.

To correctly configure the scale for recognition by the IoT box, follow this setup process for the Ariva S series scales.

중요

It is crucial to use the official Mettler USB-to-RJ45 cable during this process.

케이블

Mettler 부품 번호는 72256236 - USB- POS 케이블입니다. 정품 케이블을 구매하려면 Mettler 또는 파트너에게 문의하세요. Mettler 케이블 이외의 다른 케이블 은 설정에서 작동하지 않습니다. USB 어댑터에 연결된 직렬 전용 케이블을 사용하는 것은 효율적이지 않습니다.

Authentic Mettler USB to POS cable, part number 72256236.

설정

Refer to Mettler’s Setup Guide for Ariva S series scales during the following configuration: Ariva Checkout Scale User’s Guide.

To begin, go to page 17 in the above manual for Setup. This guide lists potential settings for the Ariva S series scales.

Follow the instructions, along with the following process, to set the scale to setup mode. First, hold the >T< button for eight seconds, or until CONF appears.

Next, press >T< until GRP 3 appears, then press >0< to confirm.

Under 3.1, ensure the setting is set to 1 (USB Virtual COM ports). Press >T< to cycle through the options under group 3.1.

Once 3.1 is set to 1, press >0< to confirm the selection. Continue to press >0< until GRP 4 appears.

Now, press >T< until EXIT appears.

중요

Do not make any other changes unless otherwise needed.

Once EXIT appears, press >0<. Following this, press >0< again to SAVE. Now the scale restarts.

마지막으로 IoT 박스를 다시 시작하여 측량계 설정에 대한 변경 사항을 인식하게 합니다. 다시 시작하면 측량계가 ‘Adam Equipment Serial’로 표시되던 이전 디스플레이와 달리 ‘Toledo 8217’로 표시됩니다.