본 기능은 태그의 값이 변화되는 이력 데이터를 오브젝트를 통해 확인하거나 파일의 형태로 저장해주는 기능입니다. Xpanel 내부 저장 공간인 블록을 생성하여 아날로그 태그와 디지털 태그를 수집할 수 있으며, 수집데이터가 저장된 로그 파일은 CSV 파일로 변환하여 날짜별로 출력하거나 Scope 트렌드를 이용하여 그래프로 그려볼 수 있습니다.
NOTE | 데이터수집 기능을 사용하기 위해서는 데이터수집 모델을 생성한 후, 해당 모델 내에서 수집하고자 하는 태그를 지정해야 합니다. |
특징
블록을 설정한 조건에 따라 생성할 수 있습니다.
태그의 실시간 값을 정주기로 수집하여 파일로 저장하거나 오브젝트에 표시합니다.
변경된 태그값만을 수집하도록 설정하여 저장공간을 효율적으로 운용할 수 있습니다.
블록 설정에 따라 수집한 데이터를 Xpanel 내부에 저장할 수 있습니다.
명령식을 사용하여 데이터 블록을 CSV 파일로 저장하거나 편집할 수 있습니다.
모델 설정 화면
[도구] – [데이터수집] 또는 프로젝트 워크스페이스의 데이터 수집 아이콘을 선택하면 다음과 같은 화면이 표시됩니다. 설정을 마친 후 화면 하단의 추가/수정 버튼을 눌러 모델을 추가 및 수정하거나, 선택한 모델을 삭제할 수 있습니다.
...
(1) 기동 설정
...
항목
...
설명
...
수집모델이름
...
생성할 데이터의 수집 모델의 이름을 입력합니다. 영문, 한글, 숫자, 특수 문자를 조합할 수 있습니다. 단, 기존의 수집 모델과 동일한 이름으로 새로운 수집 모델을 추가할 수 없습니다.
...
방법
...
정주기
...
새로운 데이터 블록 (데이터를 저장하기 위한 Xpanel 내부 저장공간)을 생성할 주기를 입력합니다. 매일 00시 00분을 기준으로 하여 지정한 주기에 따라 블록이 새로 생성됩니다.
생성된 블록에는 설정된 지연시간 이후에 데이터가 저장되기 시작합니다.
예) 기준 5분, 지연 2분으로 설정한 경우 매 5분마다 새로운 블록을 생성하며 생성 2분 후에 데이터 수집이 시작됩니다.
...
외부 호출
...
명령식이나 스크립트에서 DataLog() 함수를 사용하여 데이터 수집을 시작하고자 할 때 선택하는 옵션입니다.
...
Trigger ON
...
설정된 태그 또는 어드레스의 값이 ON 될 때 새로운 블록을 생성합니다. OFF상태가 되더라도 데이터 수집을 계속합니다.
...
Trigger OFF
...
설정된 태그 또는 어드레스의 값이 OFF 될 때 새로운 블록을 생성합니다. ON상태가 되더라도 데이터 수집을 계속합니다.
...
Trigger 태그 전환
...
설정된 태그 또는 어드레스의 값이 OFF → ON 되거나 ON → OFF 될 때 새로운 블록을 생성합니다. ON상태가 되더라도 데이터 수집을 계속합니다
...
Enable 태그
...
설정된 태그의 ON/OFF 상태에 따라 블록 생성 및 정지를 제어할 수 있습니다. ON 상태일 때 블록을 생성하고, OFF 상태일 때에는 블록을 생성하지 않습니다.
...
지정된 시각
(1일 1회)
...
하루에 단 하나의 블록을 지정한 시각에 생성합니다. 블록의 최대 저장 개수만큼 데이터가 저장되면 해당일에는 더 이상 데이터를 수집하지 않습니다. 이 옵션을 사용할 경우 다른 블록 생성 방법 (Xpanel 재실행 등)이 적용되지 않습니다.
...
기준
...
정주기,
지정된 시각
...
시간을 기준으로 블록을 생성합니다.
정주기의 경우 생성 주기와 지연시간을 지정합니다.
지정된 시각 옵션의 경우 하루 24시 중 블록을 생성하고자 하는 시간을 지정합니다.
최대 23시 59분까지 지정할 수 있으며, 지연의 경우 1439분까지 입력 가능합니다.
...
Trigger 태그 On/Off/전환Enable 태그
...
입력한 어드레스 또는 태그의 값이 0에서 0이 아닌 다른 값으로 변경될 때 블록을 생성합니다. […] 버튼을 눌러 디바이스 어드레스 또는 태그를 지정할 수 있습니다.
어드레스의 경우 데이터 타입(BIT/WORD)를 지정할 수 있습니다.
(2) 수집 설정
...
항목
...
설명
...
방법
...
정주기
...
원하는 주기를 입력하고, 그 주기에 맞게 데이터 값을 수집합니다. 최소 1초부터 최대 30,000초(500분)까지 설정할 수 있으며, 사용자가 설정한 주기에 따라 데이터를 수집할 수 있습니다. 블록이 생성되어 있어야 동작합니다.
...
태그값
...
입력한 어드레스 또는 태그의 값이 0에서 0이 아닌 다른 값으로 변경될 때 데이터를 수집합니다. […] 버튼을 눌러 디바이스 어드레스 또는 태그를 지정할 수 있습니다.
어드레스의 경우 데이터 타입(BIT/WORD)를 지정할 수 있습니다.
...
정주기/태그값 + CSV Save (1Day Create)
...
정주기 또는 태그 값에 따라 데이터를 수집합니다. 해당 옵션을 선택하는 경우 매일 자정을 지난 후 일 1회, [년월일.csv] 형식의 이름으로 CSV 파일을 생성합니다. 하나의 수집 모델에 대하여 동일한 날짜에 수집된 데이터는 모두 동일한 CSV 파일에 저장됩니다.
...
정주기/태그값 + CSV Save (1Month Create)
...
정주기 또는 태그 값에 따라 데이터를 수집합니다. 해당 옵션을 선택하는 경우 달이 변경될 때마다 월 1회, [년월.csv] 형식의 이름으로 CSV 파일을 생성합니다. 하나의 수집 모델에 대하여 동일한 달에 수집된 데이터는 모두 동일한 CSV 파일에 저장됩니다.
...
정주기/태그값 + CSV Save
(기동 시 새 CSV 생성)
...
기동 조건이 동작하여 데이터수집을 시작하는 시점부터 새로운 CSV 파일을 생성합니다. 주메모리 기준으로 \Xpanel\CSV\데이터수집 모델명\YYYYMMDD_hhmmss.CSV 경로에 저장됩니다.
데이터 수집 시작 후에는 날짜가 변경될 때마다 새로운 CSV 파일이 생성됩니다. 단, 주메모리에 저장되는 파일은 최대 3개이며, 3개를 초과할 경우에는 과거 CSV 파일부터 삭제됩니다. USB/SD 카드에 저장하는 경우에는 개수 제한이 없습니다. 디스크 저장공간이 부족한 경우에는 수집데이터가 CSV 파일에 갱신되지 않습니다.
※ 이 기능은 Xpanel Designer v2.53부터 사용할 수 있습니다.
...
수집 설정 기준
...
정주기
...
지정한 주기마다 데이터를 수집하여 블록에 저장합니다.
최소 1초부터 최대 30000초까지 지정할 수 있습니다.
...
태그값
...
입력한 어드레스 또는 태그의 값이 0에서 0이 아닌 다른 값으로 변경될 때 데이터를 수집합니다. […] 버튼을 눌러 디바이스 어드레스 또는 태그를 지정할 수 있습니다.
어드레스의 경우 데이터 타입(BIT/WORD)를 지정할 수 있습니다.
...
저장 위치
...
주메모리, USB, SD 카드 중 CSV 파일 저장 경로를 선택합니다. USB 및 SD 카드의 경로를 지정하는 경우, 해당 저장장치가 연결되어 있는 경우에만 CSV 파일 생성 및 수집 데이터가 저장됩니다. 디스크 저장 공간이 부족한 경우(4MB 이하), 수집 데이터는 CSV 파일에 갱신되지 않습니다.
각 저장 매체에 파일이 저장되는 경로는 다음과 같습니다.
※ 이 기능은 Xpanel Designer v2.53부터 사용할 수 있습니다.
...
주메모리
...
Xpanel: XPANEL\CSV\데이터수집 모델명\
PC Runtime: Xpanel 설치 경로\PCRun\CSV\데이터수집 모델명\
...
USB
...
USB메모리\CSV\데이터수집 모델명\
...
SD 카드
...
SD메모리\CSV\데이터수집 모델명\
(3) 블록 설정
...
항목
...
설명
...
블록당 최대 데이터 수집 개수
...
블록마다 최대로 저장할 데이터의 개수를 지정합니다. 최소 1에서 2048개의 데이터 수집 개수를 저장할 수 있습니다. 여기서 데이터 개수는 등록된 수집 태그 마다 각각 지정한 값 만큼의 데이터를 수집할 수 있음을 의미합니다.
예) 최대 20개 데이터를 수집하고 등록된 수집 태그가 4개일 경우, 각 태그 마다 20개의 데이터를 수집할 수 있습니다.
...
최대 저장 블록 개수
...
수집된 데이터를 저장할 Xpanel의 내부 저장 공간인 블록의 최대 개수를 지정합니다. 최소 1개에서 최대 32개까지 설정 가능합니다.
...
태그 추가
...
데이터를 수집할 태그 또는 어드레스를 추가합니다. […] 버튼을 눌러 상세 디바이스 어드레스를 설정하거나 태그를 선택할 수 있습니다.
해당 태그의 값을 표시하는 방법을 설정할 수 있습니다. 유효 소수점 자리 수의 경우 0에서 4까지 입력할 수 있으며, 태그 값을 16진수로 표현할 수도 있습니다.
...
태그 편집
...
선택한 태그의 내용을 편집할 수 있습니다.
...
태그 삭제
...
선택한 태그를 삭제합니다.
...
▲/▼/△/▽
...
선택한 태그의 위치를 변경합니다. 검은 화살표의 경우 선택한 태그를 가장 위 또는 아래로 이동시킵니다. 빈 화살표의 경우 선택한 태그의 위치를 한 칸 위 또는 아래로 이동시킵니다.
...
NOTE
...
데이터 수집은 블록 단위로 이루어지므로 블록이 생성되어야 데이터 수집이 가능합니다.
블록 당 최대 저장 개수를 초과하게 될 경우 새로운 블록을 생성해서 저장하여야 합니다.
블록은 최대 개수만큼 사용할 수 있으며, 그 이상이 필요한 경우 가장 오래된 블록을 지우고 새로운 블록을 생성합니다.
CSV파일을 저장할 경우 저장할 영역의 여유 공간을 확인하여야 합니다. USB나 SD메모리에 저장하는 것을 권장합니다.
수집 모델 설정을 변경하고 프로젝트를 다운로드 할 경우 이전 프로젝트의 블록을 모두 삭제합니다. (CSV파일 제외) 따라서, 프로젝트 다운로드 전 보관이 필요한 파일의 경우 별도로 백업하여 보관하시기 바랍니다.
데이터 수집 파일의 Xpanel 내부 경로는 다음과 같습니다.
\ Xpanel\Log\“수집모델이름”
오브젝트 설정 화면
[그림] – [데이터 수집]을 클릭한 뒤 페이지를 클릭하면 다음과 같은 화면이 나타납니다.
...
항목
...
설명
...
수집모델이름
...
현재 프로젝트에 등록된 데이터 수집 모델의 이름이 표시됩니다. 목록에서 오브젝트에 표시하고자 하는 모델을 선택합니다.
...
문자색
...
오브젝트에 표시할 문자의 색을 지정합니다. 총 98개의 색을 지원합니다.
...
선색
...
오브젝트에 표시할 선의 색을 지정합니다. 총 98개의 색을 지원합니다.
...
선종류
...
오브젝트에 표시할 선의 종류를 지정합니다. 총 7개의 종류를 지원합니다.
...
열수/행수
...
오브젝트에 표시할 열과 행의 수를 입력합니다. 각각 2에서 100까지 입력할 수 있습니다.
...
열 크기
...
오브젝트 열의 크기를 지정합니다. 균일 크기 또는 사용자 지정으로 선택할 수 있습니다. 사용자 지정 옵션을 선택한 경우 열 개수는 선택된 수집 모델의 태그 개수로 자동 지정되며, 만약 태그 개수가 20개를 초과하는 경우 사용자 지정 옵션의 선택이 불가능합니다. 열 크기는 행의 개수를 지정하여 조절할 수 있습니다.
...
날짜표시형식
...
데이터 수집 오브젝트에 표현할 날짜의 형식을 선택합니다.
yy/mm/dd, dd/mm/yy, mm/dd, dd/mm 총 4개의 형식을 선택할 수 있습니다.
...
값표시형식
...
데이터 수집 오브젝트에 표현할 값의 형태를 선택할 수 있습니다.
????는 해당 태그가 데이터베이스에 설정된 기본 형태로 표시되는 것을 의미합니다.
####, ####.0, ####.00, ####.000, ####.0000은 4자리 정수와 이하 소수점 자리 수만큼 표시되는 것을 의미합니다.
수집모델 태그 설정 사용 옵션의 경우, 데이터 수집 모델 태그 추가 시 설정하였던 내용대로 표시되는 것을 의미합니다.
...
표시항목
...
수집한 데이터 외에 표시할 항목을 선택합니다. 데이터가 수집된 날짜 및 시간, 지금까지 수집된 데이터의 최대값, 최소값, 평균값, 합계값을 표시합니다.
...
표시방식
...
데이터 수집 오브젝트에 표시되는 내용의 방식을 선택합니다.
연속 내용 표현 옵션을 선택하면 모델에 설정한 조건에 따라 수집된 데이터가 블록에 관계 없이 실시간으로 연속된 내용을 표시합니다.
블록 단위 표현 옵션을 선택하면 Xpanel 재부팅 등 오브젝트 수동 갱신을 하여야 오브젝트에 데이터가 표시됩니다. 갱신 직전에 데이터를 저장하던 블록의 내용이 표시됩니다.
...
NOTE
...
XpanelDesigner 2.40버전 이후부터 데이터 수집의 기본 방향은 내림차순입니다. (XpanelDesigner 2.34이하 버전: 오름차순)
오름차순으로 변경하고자 하는 경우 Xpanel Config창 → 로그 설정 에서 Log Data Sort Type을 Time Ascending Sort 로 변경하여 주시기 바랍니다.
블록 단위 표현은 오브젝트 내 데이터 자동 갱신을 지원하지 않습니다. 데이터를 표시하고자 하는 경우 Xpanel 전원 재인가 등의 방법으로 업데이트 하여 주시기 바랍니다.
관련 기능
본 항목에서는 데이터 수집 기능에서 자주 쓰이는 서브루틴(Subroutine)을 확인할 수 있습니다. 활용할 수 있는 서브루틴은 다음 표를 참조하여 주시기 바랍니다.
모든 명령어는 반드시 괄호를 사용하여야 합니다. |
...
명령어
...
설명
...
데이터 수집
...
서브루틴
...
DataLog
...
데이터 수집 블록을 생성하거나 종료합니다.
...
서브루틴
...
MakeCsv
...
데이터 블록을 CSV 파일로 변환하여 SD/MMC 메모리에 저장합니다.
...
서브루틴
...
MakeLogCsv
...
데이터 블록을 CSV 파일로 변환하여 지정된 위치에 저장합니다.
...
서브루틴
...
MakeLogCsvEx
...
데이터 블록을 CSV 파일로 변환하여 저장하고 A1 셀에 헤더 이름을 저장합니다.
데이터 수집 관련 함수
...
DataLog
...
데이터 수집 블록을 생성하거나 종료합니다.
...
서브루틴명
...
DataLog(“수집모델이름”,수집블록제어)
...
기능
...
데이터 수집 블록을 생성하거나 종료합니다.
수집블록제어에 0을 입력하면 블록이 정지되며, 1을 입력하면 새로운 블록이 생성됩니다.
...
사용 예제
...
데이터 수집 모델 LOG에 새로운 블록을 만들어 데이터 수집을 시작합니다.
DataLog(“LOG”,1)
...
MakeCsv
...
데이터 블록을 CSV 파일로 변환하여 SD/MMC 메모리에 저장합니다.
...
서브루틴명
...
MakeCsv(“수집모델이름”, 블록번호)
...
기능
...
지정한 수집모델이름의 블록번호를 CSV 파일로 변환하여 SD/MMC 메모리에 저장합니다.
블록번호에는 0에서 31까지 입력할 수 있습니다.
...
사용 예제
...
데이터 수집 모델 LOG의 10번 블록을 CSV 파일로 변환하여 SD/MMC 메모리에 CSV파일로 저장합니다.
MakeCsv(“LOG”,10)
...
MakeLogCsv
...
데이터 블록을 CSV 파일로 변환하여 지정된 위치에 저장합니다.
...
서브루틴명
...
MakeLogCsv(“수집모델이름”, 블록번호, 저장위치)
...
기능
...
지정한 수집모델이름의 블록번호를 CSV 파일로 변환하여 지정한 저장위치에 저장합니다.
블록번호에는 0에서 31까지 입력할 수 있습니다.
저장위치에 0을 입력하면 로컬을 의미하며, 1을 입력하면 SD/MMC를 의미합니다. 2를 입력할 경우 USB에 파일을 저장합니다.
...
사용 예제
...
데이터 수집 모델 LOG의 10번 블록을 USB 메모리에 CSV 파일로 저장합니다.
MakeLogCsv(“LOG”,10,2)
...
MakeLogCsvEx
...
데이터 블록을 CSV 파일로 변환하여 저장하고 A1 셀에 헤더 이름을 저장합니다.
...
서브루틴명
...
MakeLogCsvEx(“헤더이름”, “수집모델이름”, 블록번호, 저장위치)
...
기능
...
지정한 수집모델이름의 블록번호를 CSV 파일로 변환하여 지정한 저장위치에 저장하고 A1 셀에 지정한 헤더이름을 저장합니다.
블록번호에는 0에서 31까지 입력할 수 있습니다.
저장위치에 0을 입력하면 로컬을 의미하며, 1을 입력하면 SD/MMC를 의미합니다. 2를 입력할 경우 USB에 파일을 저장합니다.
...
사용 예제
...
데이터 수집 모델 LOG의 10번 블록을 USB 메모리에 CSV 파일로 저장합니다. CSV 파일의 A1 셀에 헤더 이름을 “Header”라고 저장합니다.
MakeLogCsvEx(“Header”,”LOG”,10,2)
활용 기능
수집된 데이터를 경향 감시 오브젝트에서 활용할 수 있습니다. 경향 감시 오브젝트는 수집된 데이터의 추이를 나타내기 위한 오브젝트로, 각각 다른 시간대에 수집된 데이터의 추이를 확인하고 분석할 수 있습니다. 여러 종류의 경향 감시 오브젝트 중 Scope 트렌드를 이용하여 데이터 수집 모델의 데이터를 표시할 수 있습니다.
...
데이터 수집 모델에 등록된 태그가 자동으로 펜에 등록되며 (최대 8개), 화면 갱신 시 수집 모델 내 지정된 블록의 데이터를 얻어옵니다. 블록에 저장된 데이터의 개수를 X축으로 보며 화면에 그래프를 업데이트합니다. 오브젝트의 업데이트는 컨트롤 태그의 값이 변경될 때 1 회 수행되며, 업데이트 방식은 변경된 값에 의해 다음과 같이 결정됩니다.
...
컨트롤 태그 값 2
...
현재 그려진 기준 그래프를 지웁니다.
...
컨트롤 태그 값 3
...
현재 그려진 그래프를 지우고 새 데이터를 업데이트 합니다.
※ 경향 감시 기능에 대한 자세한 설명은 [경향감시] 도움말을 참조해주시기 바랍니다.
사용 예제
본 예제는 기능을 설명하기 위해 삽입된 예제입니다. 실제 사용 시 사용자의 환경에 맞게 설정하여 사용해주십시오. |
사용 예제 : 데이터수집 기능을 통한 유량 변화 관측 |
시간에 따라 변화하는 유량 센서 데이터의 값을 수집하여 관측하는 예제입니다. 1초 정주기마다 데이터를 수집하여 표를 통해 수집한 데이터를 확인합니다.
(1) 태그 생성하기
a) [도구] – [데이터베이스]를 선택하여 데이터베이스 편집기로 이동합니다. 수집하고자 하는 태그를 다음과 같이 생성합니다.
...
(2) 데이터 수집 모델/오브젝트 설정
a) [도구] – [데이터수집]을 선택하여 데이터 수집 모델 설정화면으로 이동합니다. 모델 이름을 ‘수집’으로 입력하고, 기동 설정, 수집 설정, 블록 설정, 태그를 다음과 같이 구성합니다.
...
b) 오브젝트를 추가하고자 하는 페이지로 이동합니다. [그림] – [데이터수집]을 선택한 다음 페이지의 원하는 위치에 마우스 좌클릭을 합니다. 이후 나타나는 [데이터수집] 화면에서 모델을 설정하고 오브젝트를 설정합니다. 설정이 완료되면 [등록] 버튼을 눌러 페이지에 오브젝트를 추가합니다.
...
(3) 동작 확인
시뮬레이터 또는 Xpanel에 프로젝트를 다운로드하여 동작을 확인합니다. 매 초 데이터가 수집되는 것을 확인할 수 있습니다.
...