2D Code Scanner

바코드 스캐너 FAQ

설정, 스캔 방법, 그리고 스캐너가 PC에 연결되지 않을 때 확인할 사항을 안내합니다.

시작하기

2D Code Scanner는 어떤 일을 하나요?

같은 로컬 네트워크에 있는 Windows 또는 macOS Companion(Linux는 실험적 지원)으로 Android 스캐너의 바코드를 전송합니다. Companion은 키보드 웨지처럼 PC에서 포커스된 입력란에 각 코드를 입력합니다.

키보드 웨지처럼 동작하나요?

네. Companion이 키보드 웨지처럼 PC에서 포커스된 입력란에 각 바코드를 입력합니다. 스캔할 때마다 Enter나 Tab을 추가할 수도 있습니다.

USB 바코드 스캐너 대신 사용할 수 있나요?

네. Zebra 기기나 휴대폰이 별도의 USB 스캐너를 대신합니다. Companion이 Windows, macOS 또는 실험적으로 지원되는 Linux에서 포커스된 입력란에 코드를 입력합니다.

무엇을 설치해야 하나요?

양쪽 모두 설치해야 합니다. PC에는 데스크톱 Companion을 설치하고, Android 앱은 다음 중 하나를 설치하세요: Zebra, 카메라, Honeywell곧 출시, Urovo곧 출시, Newland곧 출시, Datalogic곧 출시, Universal곧 출시. 스캐너에는 Companion 1.1.0 이상이 필요합니다.

Zebra 앱과 카메라 앱 중 무엇을 써야 하나요?

기기에 맞는 앱을 사용하세요. Zebra와 Urovo곧 출시는 DataWedge를 사용합니다. Honeywell곧 출시은 Data Collection을 사용합니다. Newland곧 출시는 NLScan을 사용합니다. Datalogic곧 출시은 Intent Wedge를 사용합니다. 카메라 앱은 휴대폰 카메라를 사용합니다.

Universal곧 출시 앱은 해당 스캐너가 설치된 기기에서는 제조사의 이미저를 사용하고, 그렇지 않으면 카메라를 사용합니다.

Bluetooth는 사용하지 않습니다.

계정이나 구독이 필요한가요?

아니요. 클라우드 계정도 구독도 없습니다. 바코드는 스캐너와 PC에만 저장되며, 연결은 네트워크 안에서 AES-256-GCM으로 암호화됩니다.

페어링

스캐너를 PC와 어떻게 페어링하나요?
  1. Companion을 엽니다. 창이 보이지 않으면 트레이에 있을 수 있습니다.
  2. 스캐너와 PC를 같은 로컬 네트워크에 연결합니다.
  3. Zebra 기기에서는 QR 코드를 향해 하드웨어 트리거를 누릅니다. 카메라 앱에서는 Scan을 탭합니다.
  4. 스캐너에 Connected 상태가 표시되어야 합니다.

PC에 네트워크 어댑터가 여러 개라면 Companion의 Settings → Connection Wizard(또는 홈 화면의 Connection Wizard 링크)를 여세요. 마법사가 사용할 LAN 주소를 추천하고, 방화벽 설정을 안내하며, 기기에서 Connections를 열었을 때 나타나는 스캐너를 목록으로 보여 줍니다. QR 코드를 스캔하기 전에 Network를 스캐너가 접근할 수 있는 주소로 직접 지정할 수도 있습니다.

매번 다시 페어링해야 하나요?

아니요. 페어링 정보는 스캐너의 Connections에 저장됩니다(홈 화면의 연결 줄을 탭하세요). Companion은 종료했다가 다시 열어도 같은 페어링 토큰을 유지하므로 스캐너가 알아서 다시 연결됩니다.

같은 네트워크에서 PC 주소가 바뀌면 Companion이 새 주소를 알리고 저장된 연결이 갱신됩니다. PC가 다른 네트워크로 옮겨졌거나 QR 코드를 다시 생성한 경우에만 QR 코드를 다시 스캔하세요.

PC를 두 대 이상 사용할 수 있나요?

네. 각 Companion의 QR 코드를 스캔해 저장하세요. Connections에서 연결 이름을 지정하거나, 사용할 연결을 바꾸거나, 삭제할 수 있습니다.

QR 다시 생성은 어떤 기능인가요?

새 페어링 토큰을 만들고 모든 스캐너의 연결을 끊습니다. 각 기기는 새 QR 코드를 스캔해야 다시 연결할 수 있습니다. IP 주소가 바뀐 것만으로는 사용하지 말고, 이전 페어링을 무효로 만들고 싶을 때 사용하세요.

스캐너에 Companion 버전이 너무 오래되었다고 표시됩니다

Companion 1.1.0 이상을 다운로드에서 설치하거나, Companion 설정의 Check for updates를 사용하세요. 오래된 Companion은 거부되며, PC 앱을 업데이트하기 전에는 다시 연결되지 않습니다.

스캔

기기에는 코드가 표시되지만 PC에는 아무것도 입력되지 않습니다

먼저 텍스트 입력란을 클릭하세요. Companion은 포커스된 창에 입력합니다.

Companion의 Settings에서 Type into focused window 옵션을 켜 둔 상태로 유지하세요. 스캐너에서는 연결이 복구된 뒤 Resend last scan으로 마지막 코드를 다시 보낼 수 있습니다.

열려 있는 검증 또는 집계 세션에 해당하는 항목은 의도적으로 기기에만 남으며 PC에는 입력되지 않습니다. 재고 실사 세션을 참고하세요.

상태가 Connected가 아니면 스캔은 대기열에 저장되었다가 연결이 복구되면 전송됩니다. 연결이 전혀 되지 않는다면 네트워크 문제 해결부터 확인하세요.

스캔할 때마다 Enter나 Tab을 보내려면 어떻게 하나요?

스캐너에서 Settings를 열고 After each scan을 Enter, Tab 또는 없음 중에서 선택하세요. 기본값은 Enter입니다.

어떤 바코드를 지원하나요?

Code 128, Code 39, Code 93, EAN-8, EAN-13, UPC-A, UPC-E, Interleaved 2 of 5, GS1 DataBar, QR Code, Data Matrix, PDF417, Aztec, MaxiCode, MicroPDF417, Micro QR Code를 지원합니다.

Zebra 기기에서는 DataWedge에서 해당 바코드 종류도 활성화해야 합니다. 카메라 앱은 기기 내 스캐너가 카메라 이미지에서 해독할 수 있는 코드를 읽습니다.

Zebra 트리거를 눌러도 반응이 없습니다

처음 실행하면 2DCodeScanner라는 DataWedge 프로필이 만들어집니다(바코드 입력, 이 앱으로 인텐트 출력, 키 입력 출력 꺼짐). 해당 프로필이 있고 이 앱과 연결되어 있는지 확인하세요.

이 앱은 DataWedge가 있는 Zebra 기기가 필요합니다. 다른 Android 브랜드 기기와 카메라 앱은 이 프로필을 사용하지 않습니다.

카메라 앱이 스캔되지 않습니다

Android에서 요청하면 카메라 권한을 허용한 다음 Scan을 탭하세요. 스캐너가 백그라운드에서 계속 실행되려면 알림 권한도 필요합니다.

재고 실사 세션

검증 세션이란 무엇인가요?

예상되는 바코드의 체크리스트입니다. 스캐너에서 만들거나, Companion의 Tools → Validation에서 만들어 스캐너로 보낼 수 있습니다. 일치하는 스캔은 항목에 체크 표시가 되며, PC에는 입력되지 않습니다.

모든 항목이 체크되면 세션이 완료됩니다. 기기의 Reset / undo는 체크 표시를 지워 목록을 다시 스캔할 수 있게 합니다. Return to building은 체크 표시를 지우고 코드를 추가하거나 삭제할 수 있는 상태로 되돌립니다.

집계 세션이란 무엇인가요?

수량을 집계하는 세션입니다. 스캐너(Sessions → Counting) 또는 Companion(Tools → Counting)에서 만든 뒤 기기에서 열어 스캔하세요. 수량은 Companion과 다시 동기화됩니다. Companion에서는 집계 결과를 TSV로 복사할 수 있습니다.

세션 중에 스캔이 기기에만 남은 이유는 무엇인가요?

검증 또는 집계 상세 화면이 열려 있는 동안에는 스캔이 해당 세션에 속합니다. PC의 포커스된 입력란에 일반 바코드를 입력하려면 세션에서 나가세요.

네트워크 문제 해결

스캐너와 Companion은 로컬 네트워크에서만 통신합니다. 인터넷, Bluetooth, 클라우드 중계를 사용하지 않습니다. 휴대폰이 웹을 탐색할 수 있어도 게스트 Wi‑Fi, 클라이언트 격리, VPN, 방화벽이 기기 간 통신을 막으면 PC에 연결되지 않을 수 있습니다.

다음 순서대로 확인하세요

  1. Companion이 실제로 실행 중인지 확인

    창을 닫으면 Close to tray 옵션이 켜져 있을 때 트레이로 숨겨질 뿐이며, 이 상태에서도 스캐너 연결은 유지됩니다. 트레이 아이콘의 Quit을 선택하면 종료됩니다.

  2. 두 기기가 같은 로컬 네트워크에 있는지 확인

    스캐너는 Wi‑Fi를 사용합니다. PC는 같은 Wi‑Fi에 있거나 같은 LAN에 유선으로 연결되어 있어도 됩니다. 게스트 네트워크, 공용 핫스팟, 클라이언트 격리가 켜진 액세스 포인트에서는 두 기기 모두 인터넷에 연결되어 있어도 서로를 볼 수 없습니다.

  3. QR 코드가 스캐너가 접근할 수 있는 주소를 사용하는지 확인

    Companion Settings → Network에 PC의 LAN 주소가 나열됩니다. 사무실 Wi‑Fi 또는 유선 이더넷 주소(주로 192.168… 또는 10…)를 선택하세요. VPN, 가상 머신, 하이퍼바이저 어댑터는 선택하지 마세요. 또는 Connection Wizard를 사용해도 됩니다. 추천 어댑터에는 표시가 붙고, Connections가 열려 있거나 시작 안내가 연결 단계에 있을 때 스캐너가 목록에 나타납니다. 이 설정을 바꾼 뒤에는 QR 코드를 다시 스캔하세요.

  4. 방화벽이 Companion을 허용하는지 확인

    인바운드 TCP 및 UDP 17832(또는 Settings → Port에서 지정한 포트)를 허용하세요. TCP는 연결에 사용됩니다. 같은 포트의 UDP는 DHCP로 PC 주소가 바뀌었을 때 저장된 스캐너가 새 주소를 알아내고, Companion이 Connection Wizard에서 스캐너를 찾는 데 사용됩니다.

  5. 현재 QR 코드를 스캔

    네트워크, 포트 또는 PC의 LAN을 바꾼 뒤에 이 작업을 하세요. 같은 네트워크에서 IP만 바뀐 경우에는 새 QR 코드가 필요하지 않습니다.

그래도 연결되지 않는다면

  • 상태가 Connecting 또는 Not connected에서 바뀌지 않습니다

    • 휴대폰과 PC의 VPN을 끈 뒤 QR 코드를 다시 스캔하세요. VPN은 PC의 LAN 주소를 가리는 경우가 많습니다.
    • 게스트 Wi‑Fi에서 나와 휴대폰과 PC가 서로 접근할 수 있는 사설 LAN을 사용하세요.
    • 사무실 네트워크 없이 앱을 테스트하려면 PC를 스캐너 휴대폰의 핫스팟에 연결하거나(또는 둘 다 소형 여행용 라우터에 연결하고) 그곳에서 QR 코드를 스캔하세요.
    • Windows에서는 Private 네트워크에서 Companion을 허용하세요. Public으로 지정된 네트워크는 다른 기기의 들어오는 연결을 차단하는 경우가 많습니다.
    • macOS에서는 시스템에서 요청하면 로컬 네트워크 접근을 허용하세요. Linux에서는 같은 포트의 TCP와 UDP를 허용하세요.

  • 예전에는 잘 됐는데 PC 주소가 바뀌었습니다

    • 페어링 토큰은 그대로 두세요. Regenerate QR를 하면 모든 스캐너가 다시 페어링해야 합니다.
    • 해당 UDP 포트가 허용되어 있으면 Companion이 새 주소를 알리고 저장된 연결이 갱신됩니다. 포트가 차단되어 있다면 현재 QR 코드를 한 번 스캔하세요.
    • 다른 네트워크(사무실과 집, 또는 새 VLAN)에서는 QR 코드를 새로 스캔해야 합니다.

  • 화면이 꺼지면 연결이 끊깁니다

    • 화면이 꺼져 있는 동안 스캐너는 Wi‑Fi 연결을 일시 중지합니다. 알림에 연결이 일시 중지되었다고 표시됩니다.
    • 스캐너 Settings에서 Keep screen on을 켜거나, 화면을 깨워 다시 연결하세요.
    • Android에서 요청하면 알림 권한을 허용하세요. 허용하지 않으면 스캐너 서비스가 계속 실행될 수 없습니다.

  • 스캔이 기기에만 남습니다

    • 상태가 Connected가 아니면 스캔은 대기열에 저장되었다가 다시 연결되면 전송됩니다. 스캔이 사라지지는 않습니다.
    • 검증 또는 집계 화면이 열려 있으면 스캔은 입력되지 않고 해당 세션에 저장됩니다.
    • 홈 화면의 상태가 Connected라면 PC의 텍스트 입력란을 클릭하고 Type into focused window 옵션이 켜져 있는지 확인하세요.

  • 포트를 변경했습니다

    • 포트는 QR 코드에 들어 있습니다. Companion Settings에서 적용한 뒤 새 QR 코드를 스캔하세요.
    • 해당 포트의 TCP와 UDP를 모두 허용하세요. 이 Companion을 이미 저장한 스캐너는 알림을 통해 새 포트를 알게 됩니다. 한 번도 저장한 적이 없는 스캐너는 계속 17832로 신호를 보내므로, 처음 한 번은 QR 코드를 스캔해 페어링하세요.
    • 이미 다른 프로그램이 사용 중인 포트에서는 Companion이 수신 대기를 할 수 없습니다. 1024보다 큰 사용 가능한 포트를 선택하세요.

여전히 해결되지 않나요? office@updruck.com으로 Companion 버전(PC Settings), Android 앱 버전(스캐너 Settings), Network에서 선택한 주소, 그리고 휴대폰이 게스트 Wi‑Fi나 VPN에 연결되어 있는지 여부를 알려 주세요.