TS-CAM은 ONVIF 호환 CCTV 카메라를 차량 번호 인식 용으로 사용할 수 있는 프레임워크입니다.
😍 차번 인식 라이브 데모 👈 여기서 번호 인식 성능을 테스트해 보세요.
🚀 최신 엔진 다운로드 👈 TS-CAM은 최신 엔진에 포함되어 있습니다.
프로그래밍 언어별 응용 프로그램 예제 코드를 확인해 보세요.
루프 센서 입력, 스냅샷 이미지 획득, 차량 번호 인식, 차단기 제어, 이미지 저장 기능이 모두 구현되어 있습니다.
카메라와 응용프로그램 사이에서 중계자 역할을 수행하는 서버(브로커)로 동작하며, 응용 프로그램과는 Socket.IO 기반 API를 사용하여 실시간 메시지로 가볍게 통신합니다.
---
title: "[구성도]"
---
flowchart
loop([루프 센서])-->|디지털 입력|camera((카메라))
camera-->|이벤트, 이미지|tscam(TS-CAM)
tscam<==>|릴레이 출력|camera
camera-->|릴레이 출력|gate([추차 차단기])
tscam<==>|API|app(주차관리 소프트웨어)
tscam<-->|차번 인식|tsanpr(TS-ANPR)
tscam-->|파일 저장|images[(스냅샷 이미지)]
app-->led([전광판])
app-->kiosk([키오스크])
app<-->db[(데이터베이스)]
subgraph framework ["TS-CAM 프레임워크"]
tscam
tsanpr
end
subgraph applicaton ["응용 프로그램"]
images
app
db
end
subgraph devices ["주요 설비"]
loop
camera
gate
led
kiosk
end
linkStyle 0 stroke:red, stroke-width:2px;
linkStyle 1 stroke:red, stroke-width:4px;
linkStyle 2 stroke:blue, stroke-width:4px;
linkStyle 3 stroke:blue, stroke-width:2px;
linkStyle 4 stroke:green, stroke-width:4px;
-
소프트웨어 개발 생산성 향상 응용 소프트웨어를 개발할 때 TS-CAM 프레임워크를 도입하면 카메라 인테페이스, 차량 번호 인식에 대한 세부사항들은 TS-CAM에 맏기고 응용 프로그램은 데이터베이스, 사용자 인터페이스와 같은 비즈니스 로직에 집중할 수 있어 개발 생산성이 향상될 수 있습니다.
-
회복 탄력성 시스템 서비스로 실행할 수 있기 때문에 소프트웨어 오류로 프로그램이 죽거나 시스템이 재부팅될 경우 자동으로 재실행되므로, 장애 상태로 방치되지 않고 스스로 복구되므로 안정성이 향상됩니다.
-
32비트 응용프로그램 성능 향상 TS-CAM은 응용프로그램과 분리된 별도의 프로그램이기 떄문에 응용프로그램이 32비트라도 CPU와 운영체제가 64비트이면 TS-CAM을 64비트로 실행할 수 있습니다. 이렇게 구성하면 기존 32비트 응용프로그램에서 주로 CPU부하가 걸리는 부분을 64비트로 처리하는 효과를 얻을 수 있습니다. 멀티코어 CPU에서 32비트에 비해 64비트 차번인식 엔진이 차번 인식속도가 약 2~4배 빠릅니다.
Loadingflowchart LR tscam<-->tsanpr(TS-ANPR) tscam(TS-CAM)<==>|API|app(응용프로그램) subgraph 32비트 app end subgraph bit64Framework ["64비트"] tscam tsanpr end subgraph bit64OS ["64비트 운영체제"] bit64Framework 32비트 end classDef blue fill:#ccc,color:#fff,stroke:#333; class 32비트 blue linkStyle 1 stroke:green, stroke-width:4px;
-
카메라 선택 폭이 넓어짐 전용 카메라를 사용해야 하는 제약없이 CCTV 카메라 시장의 주류인 ONVIF 호환 카메라 중에서 필요한 사양, 성능, 가격에 맞는 카메라를 직접 선정할 수 있습니다.
-
실행 파일은 TS-ANPR 엔진 디렉토리에 포함되어 있습니다.
tscam.exe # TS-CAM 실행 파일 .env # 환경 변수 설정 파일 tsanpr.dll # TS-ANPR 엔진 파일 tsanpr-KR-2407M.eon # TS-ANPR 엔진 파일
-
환경변수 환경변수 설정을 통해
tscam.exe동작을 설정할 수 있습니다. 환경변수는 서비스 등록시 스크립트 파일에서 설정하거나 간단히.env파일에 설정할 수 있습니다..env파일은 항상tscam.exe파일과 같은 디렉토리에 위치해야 합니다.TSCAM_HTTP_PORT=10000 # listen용 TCP 포트 번호 #TSCAM_DATA_DIR=C:\Users\bob\tscam\data # 스냅샷 이미지가 저장될 디렉토리 #TSCAM_LOG_DIR=C:\Users\bob\tscam\log # 로그가 저장될 디렉토리 # 시각 표시는 밀리초가 기본으로 사용되는데 초 단위로 변경할 경우 사용 #TSCAM_NO_MILLISECONDS=1 # 스냅샷 이미지 URL 경로 prefix #TSCAM_URI_DATA_PATH_PREFIX=/site1 # 차번인식엔진이 tscam.exe와 다른 위치에 있는 경우 설정합니다. #TSANPR=C:\Program Files\TS-Solution\TS-ANPR\tsanpr-KR-v2.4.0M\windows-x86_64\tsanpr.dll # 로그 파일 설정 (기본값) # maxSize: 로그 파일 하나의 최대 크기 # maxFiles: 보관할 로그 파일 수 (지정한 날짜가 지나면 자동 삭제됨) # size: 전체 로그 저장소의 최대 크기 (총 로그 크기가 설정한 값을 초과하면 가장 오래된 파일부터 삭제됨) # TSCAM_LOG_CONFIG={"maxSize":"20m","maxFiles":"31d","size":"1024m"} # 파일 저장 로그 레벨 (info, warn, error 중 하나로 설정) TSCAM_LOG_LEVEL_FILE=info # 모든 로그 저장 # 콘솔 출력 로그 레벨 (info, warn, error 중 하나로 설정) TSCAM_LOG_LEVEL_CONSOLE=info # 모든 로그 출력
-
개발 환경 개발 환경은 동작 상황이 실시간으로 콘솔에 표시되도록 구성하면 편리합니다.
-
환경 변수 편집 실행 환경은 환경 변수를 사용해서 설정 가능하므로 먼저
.env파일을 개발 환경에 맞게 편집합니다. 운영체제의 환경 변수 설정을 사용해도 되지만 개발 환경에서는 간편히.env파일을 사용하는 것을 권장합니다. 로그가 별도로# 파일 저장 로그 레벨 (info, warn, error 중 하나로 설정) TSCAM_LOG_LEVEL_FILE=info # 모든 로그 저장 # 콘솔 출력 로그 레벨 (info, warn, error 중 하나로 설정) TSCAM_LOG_LEVEL_CONSOLE=info # 모든 로그 출력
-
TS-CAM 실행 콘솔 창을 열고 tscam을 실행합니다.
C:\Program Files\TS-Solution\TS-ANPR\tsanpr-KR-v2.4.0M\windows-x86_64> tscam tscam v0.1.0 log= C:\Users\bob\tscam\log data= C:\Users\bob\tscam\data 2024-08-09 16:36:35.201 info: Process started { pid: 18764 } 2024-08-09 16:36:35.446 info: os_name=win32, arch_name=x64 2024-08-09 16:36:35.448 info: LIB_PATH= 'C:\Program Files\TS-Solution\TS-ANPR\tsanpr-KR-v2.4.0M\windows-x86_64\tsanpr.dll' 2024-08-09 16:36:36.547 info: TS-ANPR v2.4.0 is ready 2024-08-09 16:36:36.570 info: listening 127.0.0.1:10000 -
TS-CAM 종료 콘솔 창에서
Ctrl+C를 입력하여 프로그램을 종료합니다.2024-08-09 16:37:02.240 info: SIGINT received. Shutting down gracefully 2024-08-09 16:37:02.243 info: Closing server 2024-08-09 16:37:03.245 info: Server closed 2024-08-09 16:37:03.248 info: Socket.IO server closed 2024-08-09 16:37:03.250 info: Process terminated { pid: 18764 }
-
-
운영 환경 (윈도우즈) 운영 환경은 회복 탄력성을 위해 시스템 서비스로 실행합니다.
-
서비스 등록 먼저
tscam과TS-ANPR디렉토리를 원하는 위치에 복사한 다음, 시스템 서비스로 등록하기 위해utils/windows-service/addsvc.bat파일 내용 중 필요한 부분을 수정합니다. 예를 들어,C:\Program Files\TS-Solution\TS-ANPR\에 복사했다면 아래와 같이 수정하면 됩니다.@echo off REM tscam 서비스 설치 스크립트 REM 관리자 모드로 실행하세요. reg Query "HKLM\Hardware\Description\System\CentralProcessor\0" | find /i "x86" > NUL && set NSSM=win32\nssm.exe || set NSSM=win64\nssm.exe REM 실제 실행파일의 경로로 수정하세요. %NSSM% install tscam "C:\Program Files\TS-Solution\TS-ANPR\tsanpr-KR-v2.4.0M\windowns-x86_64\tscam.exe" %NSSM% set tscam AppExit Default Restart %NSSM% set tscam AppRestartDelay 3000 REM 필요한 환경변수 설정 REM HTTP 포트 번호 REM %NSSM% set tscam AppEnvironment TSCAM_HTTP_PORT=10000 REM 데이터 저장 디렉토리 REM %NSSM% set tscam AppEnvironment "TSCAM_DATA_DIR=C:\ProgramData\TS-Solution\tscam\data" REM 로그 파일 디렉토리 REM %NSSM% set tscam AppEnvironment "TSCAM_LOG_DIR=C:\ProgramData\TS-Solution\tscam\log" REM 밀리초 단위 삭제 REM %NSSM% set tscam AppEnvironment TSCAM_NO_MILLISECONDS=1 REM 저장 이미지 파일 다운로드 경로 prefix REM %NSSM% set tscam AppEnvironment TSCAM_URI_DATA_PATH_PREFIX=/site1" REM 콘솔 로그 레벨 (info, warn, error) REM 운영 환경에서는 쓰기 부하를 줄이려면 warm, error 수순으로 설정합니다. REM %NSSM% set tscam AppEnvironment TSCAM_LOG_LEVEL_CONSOLE=error REM 파일 로그 레벨 (info, warn, error) REM 운영 환경에서는 쓰기 부하를 줄이려면 warm, error 수순으로 설정합니다. REM %NSSM% set tscam AppEnvironment TSCAM_LOG_LEVEL_FILE=error REM 로그 파일 설정 (따옴표 두개로 이스케이프 처리) REM maxSize: 로그 파일 하나의 최대 크기 REM maxFiles: 보관할 로그 파일 수 (지정한 날짜가 지나면 자동 삭제됨) REM size: 전체 로그 저장소의 최대 크기 (총 로그 크기가 설정한 값을 초과하면 가장 오래된 파일부터 삭제됨) REM %NSSM% set tscam AppEnvironment "TSCAM_LOG_CONFIG={""maxSize"":""20m"",""maxFiles"":""31d"",""size"":""1024m""}" REM 차번인식엔진이 tscam.exe와 다른 위치에 있는 경우 설정합니다. REM %NSSM% set tscam AppEnvironment "TSANPR=C:\Program Files\TS-Solution\TS-ANPR\tsanpr-KR-v2.4.0M\windows-x86_64\tsanpr.dll" %NSSM% start tscam %NSSM% status tscam
수정한
addsvc.bat파일을 저장한 다음 관리자 모드에서 실행하면 등록이 완료됩니다. -
서비스 삭제 등록한
tscam서비스를 삭제하려면 관리자 모드에서utils/windows-service/rmsvc.bat를 실행하세요.
-
-
운영환경 (리눅스)
- 서비스 등록
시스템 서비스로 등록하기 위해
utils/linux-service/addsvc.sh파일 내용 중 필요한 부분을 수정합니다. 예를 들어,/var/tsanpr/에 복사했다면 아래와 같이 수정하면 됩니다.
#!/bin/bash # tscam 서비스 등록 스크립트 echo "# tscam configuration [Unit] Description=tscam (ONVIF Camera Broker) After=network.target [Service] # HTTP 포트 번호 # Environment=\"TSCAM_HTTP_PORT=10000\" # 데이터 저장 디렉토리 # Environment=\"TSCAM_DATA_DIR=/var/tscam/data\" # 로그 파일 디렉토리 # Environment=\"TSCAM_LOG_DIR=/var/tscam/log\" # 밀리초 단위 삭제 # Environment=\"TSCAM_NO_MILLISECONDS=1\" # 저장 이미지 파일 다운로드 경로 prefix # Environment=\"TSCAM_URI_DATA_PATH_PREFIX=/site1\" # 콘솔 로그 레벨 (info, warn, error) # Environment=\"TSCAM_LOG_LEVEL_CONSOLE=error\" # 파일 로그 레벨 (info, warn, error) # Environment=\"TSCAM_LOG_LEVEL_FILE=error\" # 로그 파일 설정 # maxSize: 로그 파일 하나의 최대 크기 # maxFiles: 보관할 로그 파일 수 (지정한 날짜가 지나면 자동 삭제됨) # size: 전체 로그 저장소의 최대 크기 (총 로그 크기가 설정한 값을 초과하면 가장 오래된 파일부터 삭제됨) # Environment=\"TSCAM_LOG_CONFIG={\\\"maxSize\\\":\\\"20m\\\",\\\"maxFiles\\\":\\\"31d\\\",\\\"size\\\":\\\"1024m\\\"}\" # 차번인식엔진이 tscam.exe와 다른 위치에 있는 경우 설정합니다. # Environment=\"TSANPR=/var/tsanpr/tsanpr-KR-v2.4.0M/linux-x86_64/libtsanpr.so\" # 필수 항목 WorkingDirectory=/var/tscam # tscam 실행 파일 경로 ExecStart=/var/tsanpr/tsanpr-KR-v2.4.0M/linux-x86_64/tscam # 죽으면 3초 후 자동 재시작 Restart=always RestartSec=3 LimitNOFILE=400000 Type=simple [Install] WantedBy=multi-user.target " > ~/.tmp.tscam.service sudo mv ~/.tmp.tscam.service /etc/systemd/system/tscam.service sudo systemctl daemon-reload sudo systemctl enable tscam sudo systemctl restart tscam
- 서비스 삭제
등록한
tscam서비스를 삭제하려면 관리자 모드에서utils/linux-service/rmsvc.sh를 실행하세요.
- 서비스 등록
시스템 서비스로 등록하기 위해
TS-CAM은 번들로 제공되며 무료로 사용할 수 있습니다.
다만 TS-ANPR이 설치되어 있어야 동작하며 TS-ANPR 라이선스에 의존합니다.
TS-ANPR은 동시에 이벤트 수신 대기 watchEvent 하는 최대 카메라 수를 라이선스로 제한하고 있습니다.
| TS-ANPR 라이선스 | 카메라 수 제한 |
|---|---|
| 무료 평가판 | 최대 4대 |
| 상용 라이선스 | 기본 1대 (카메라 추가시 라이선스 구매 가능) |