에스앤아이 / 제품·솔루션

USB LAMP AGENT

업무 시스템의 상태를,
현장의 빛과 소리로.

USB 타워 램프를 제어하는 Windows 에이전트입니다.
화면에서 직접 조작하거나 REST API로 업무 시스템과 연결해
작업 상태와 알림을 LED와 부저로 전달하세요.

REST API → USB → LIGHT & SOUND
01 / SYSTEM업무 시스템

작업 결과 · 상태 알림 · 호출 명령

02 / AGENTUSB Lamp Agent

Windows PC에서 명령 수신 및 USB 제어

03 / SIGNALUSB 타워 램프

5색 LED · 점등과 점멸 · 부저

최대 4대 개별 제어램프별 연결 상태 및 제어 탭
5색 LED + 부저색상별 동작과 소리 패턴 선택
REST API 연동외부 시스템에서 상태 조회 및 제어

Control at a Glance

색상과 소리로 전하는,
명확한 현장 신호.

램프별로 필요한 신호를 선택하고, 현장 운영 방식에 맞게 업무 시스템과 연결합니다.

01 / LED

5색 LED 개별 제어

적색·황색·녹색·청색·백색 채널마다 소등, 점등, 점멸을 선택합니다. 변경할 채널만 지정하면 나머지 채널의 설정은 유지됩니다.

02 / SOUND

부저 패턴 선택

부저를 끄거나 5개 소리 패턴 중 하나를 선택할 수 있습니다. 화면의 재전송 버튼으로 선택한 패턴을 다시 전달합니다.

03 / MULTI DEVICE

최대 4대 램프 관리

Lamp 1부터 Lamp 4까지 개별 탭으로 제어합니다. 연결된 램프의 탭을 활성화하고, 화면 하단에 전체 연결 수를 표시합니다.

04 / CONNECTION

연결 상태 확인

USB 램프의 연결 여부를 주기적으로 확인합니다. 연결된 장치가 없으면 안내 화면을 표시하며, 미연결 장치의 제어 요청은 실패로 처리합니다.

05 / API

업무 시스템 연동

REST API로 램프별 연결 상태와 에이전트의 제어 상태를 조회하고, LED와 부저 명령을 보냅니다. 제어 결과는 JSON 응답으로 확인합니다.

06 / WINDOWS

트레이와 자동 시작

Windows 트레이에서 화면 보기·숨김, 설정, 종료를 관리합니다. 자동 시작을 설정하면 다음 Windows 로그인부터 적용됩니다.

Inside the Application

제어와 연결 확인을
하나의 화면에서.

실제 프로그램 화면입니다. 이미지를 선택하면 확대해서 볼 수 있습니다.

01 / CONNECTED

램프 연결 및 제어

색상별 OFF·ON·BLINK 버튼과 부저 선택으로 연결된 램프를 조작합니다.

램프별 탭 · 5색 LED · 부저 · USB 연결 수
02 / DISCONNECTED

미연결 상태 안내

연결된 USB 램프가 없으면 안내 문구와 함께 연결 수 0 / 4를 표시합니다.

미연결 안내 · USB 연결 수 · API 주소

Connect Your Workflow

시스템의 이벤트를,
램프 제어 명령으로 연결하세요.

검사 결과, 작업 완료, 담당자 호출 등 업무 시스템에서 판단한 상태를 램프로 표현할 수 있습니다. 이벤트 판단과 제어 요청은 연동 시스템에서 구성합니다.

REST API

조회와 제어,
두 가지 요청으로.

램프 번호는 1~4를 사용합니다. 색상은 off, on, blink, 부저는 0(정지) 또는 1~5(패턴)로 지정합니다. 생략한 채널은 기존 상태를 유지합니다.

응답의 success, isConnected, error로 처리 결과를 확인하세요. 상태 조회는 에이전트가 보관한 마지막 제어 상태를 반환합니다.

같은 PC에서 호출하는 요청 예시

# 1번 램프 상태 조회
GET http://localhost:11111/Api/get?index=1

# 녹색 점멸 + 부저 패턴 1
GET http://localhost:11111/Api/set?index=1&green=blink&sound=1
연동 예시이며 이 페이지에서 실제 장치에 명령을 보내지는 않습니다.
GET / RESPONSE

조회한 상태를
JSON으로 확인하세요.

GET /Api/get?index=1 요청의 응답 예시입니다. 연결 여부와 각 LED, 부저의 제어 상태를 함께 반환합니다.

  • time: 응답 생성 시각
  • success: 요청 처리 성공 여부
  • index: 조회한 램프 번호(1~4)
  • isConnected: USB 램프 연결 여부
  • red / amber / green / blue / white: 색상별 상태(Off·On·Blink)
  • sound: 부저 상태(Off 또는 Sound1~Sound5)
  • error: 오류 메시지, 오류가 없으면 null

상태 조회에 성공해도 램프는 미연결 상태일 수 있습니다. success와 isConnected를 함께 확인하세요.

1번 램프 상태 조회 응답 예시

{
  "time": "2026-09-21T16:30:00+09:00",
  "success": true,
  "index": 1,
  "isConnected": true,
  "red": "Off",
  "amber": "On",
  "green": "Blink",
  "blue": "Off",
  "white": "Off",
  "sound": "Off",
  "error": null
}
연결된 화면을 기준으로 구성한 예시이며, 실제 값은 조회 시점의 상태에 따라 달라집니다.

Getting Started

현장에 맞는 연결부터 시작하세요.

  1. 01

    램프 확인

    USB 타워 램프 모델과 색상·부저 지원 사양을 확인합니다.

  2. 02

    PC 연결

    Windows PC에 USB 램프를 연결하고 에이전트를 실행합니다.

  3. 03

    동작 점검

    연결 상태를 확인하고 LED와 부저를 화면에서 조작합니다.

  4. 04

    시스템 연동

    업무 이벤트별 신호를 정하고 API 요청과 처리 결과를 확인합니다.

실행 환경
.NET 10 기반 Windows x64 프로그램입니다. 배포 방식에 맞는 런타임과 큐라이트 USB 통신 라이브러리가 필요합니다.
지원 장치
큐라이트 사 USB 타워 램프
통신 환경
HTTP 11111 포트로 REST API를 제공합니다. 다른 PC에서 연동할 경우 에이전트 PC의 주소와 방화벽 설정을 확인합니다. HTTPS와 CORS 조건은 별도 검토가 필요로 합니다.
제어 상태
상태 조회 값은 실제 발광·발음의 센서 측정값이 아닌 에이전트의 마지막 제어 상태입니다. 초기화 및 정상 종료 시 전체 소등 명령을 전송합니다.

Let's Connect

현장에 필요한 알림,
업무 시스템과 연결하세요.

사용할 램프 모델과 수량, 연동 시스템, 표현할 알림을 알려주세요.
에스앤아이가 현장에 맞는 구성을 함께 검토합니다.