EZBee-300 Programmer’s Guide

Transcription

1 EZBee-300 Programmer s Guide (Version 0.5). 1

2 목 차 1. 제품개요 AT 명령어 AT 명령어참조테이블 알림메시지 (Notification message) 결과메시지 (Result message) AT 명령어설명 직렬통신인터페이스 직렬통신포트설정 에코모드설정 ZigBee 통신을위한 EzBee-300 모뎀설정 채널설정 PAN ID 설정 모뎀 ID 설정 그룹 ID 설정 Bypass 모드를위한기본대상 ID설정 자동시작모드설정 ZigBee 네트워크시작하기 네트워크메시지전송및수신 ASCII 모드에서메시지전송 Bypass 모드로메시지전송 단축주소읽기

3 3.5. 확장주소읽기 모듈리셋 네트워크모듈리셋 모듈버전읽기 모듈상태읽기 GPIO 제어및설정 GPIO 방향설정 GPIO 제어 ADC 읽기 원격제어허용여부설정 PAN 가입허용여부설정 EBI 명령어설명 EBI모드들어가기 EBI 모드로데이터통신하기 EBI 패킷타입 EBI_TYPE_UNICAST_MSG EBI_TYPE_GROUP_MSG EBI_TYPE_BROAD_MSG EBI_TYPE_IO_REQ EBI_TYPE_IO_ACK EBI_TYPE_IOD_REQ EBI_TYPE_IOD_ACK EBI_TYPE_ADC_REQ EBI_TYPE_ADC_ACK

4 EBI_TYPE_ACK EBI_TYPE_NET_ACK EBI_TYPE_ESCAPE

5 1. 제품개요 EZBee-300 ZigBee모뎀은 ZigBee Specification 2006을만족시키는데이터모뎀으로사용자가 ZigBee에대한전문적인지식없이도 ZigBee 네트워크를손쉽게구축할수있도록해준다. 사용자는 RS-232C 인터페이스와 AT 명령어를사용하여 EZBee-300 모뎀과통신할수있다. EZBee-300 모뎀은모듈간에메시지전송을위하여 ASCII 모드, Bypass 모드그리고 EBI(EZBee Binary Interface) 모드의총세가지메시지전송모드를제공한다. 먼저, ASCII 모드에서는각모뎀이 ZigBee 네트워크에연결되었을때, 모듈간에 AT 명령을통한 ASCII HEX 형식으로메시지를전송할수있다. Bypass 모드에서는메시지전송을위한별도의명령어나통신패킷구성없이도 PAN내에미리지정된모뎀을마치유선 RS-232C로연결된것처럼간주하여메시지를직접전송할수있다. 마지막으로, EBI 모드에서는사용자가 EBI 프로토콜에맞게패킷의타입과 Destination ID등을구성하여메시지를전송할수있다. 각모뎀은 ZigBee의확장주소 (extnded address) 및단축주소 (short address) 이외에고유 ID가부여되며, 모든모드에서메시지전송때이고유 ID를사용하여전송할수있다. 5

6 2. AT 명령어 이장에서는 AT 명령어인터페이스에관해설명한다. AT 명령어는다음과같은명령으로구 분된다 AT 명령어참조테이블 AT Category Description Parameter Default command D 시스템 BYPASS 모드로모드를변경한다. <Modem ID> B 시스템 EBI 모드로모드를변경한다 없음 Z 시스템 모뎀을리셋 (reset) 한다. 없음 NZ 시스템 네트워크상태삭제및모드를리셋한다 없음 V 시스템 모뎀버전을보여준다 없음 S 시스템 모뎀상태를보여준다 없음 +SPI 설정 RS-232C 인터페이스구성을설정? 38400/ HW 하거나보여준다. =<baud>,<flow> flow +CH 설정 주파수채널을설정하거나보여준? 다. =<11~26> 11 +DST 설정 bypass 모드에서기본대상 ID 설? 정하거나보여준다 =<Modem ID> 0 +E 설정 시리얼에코모드를설정하거나해제한다 0 / 1 1 +EA 설정 64비트확장주소를읽어온다? +ID 설정 모뎀 ID 설정하거나보여준다? =<Modem ID> 6

7 +PID 설정 PAN ID를설정하거나보여준다 0~ +GID 설정 Group ID를설정하거나보여준다. 1~ AS 설정 네트워크자동시작 / 가입모드를설정하거나보여준다. 0/1 0 +PMJ 시스템 PAN 가입을허용한다?/=<0/1> +SA? 시스템 16비트단축주소를보여준다 None +IO 시스템 GPIO를제어한다?/=<Value> +IOD 시스템 GPIO 방향을제어한다?/=<Value> +ADC? 시스템 ADC 값을질의한다 <ch1>,<ch2> +RA 시스템 원격제어를허용한다?/=<0/1> &MSG &PS 네트워크 PAN 을수동으로시작하거나가입 한다 None 2.2. 알림메시지 (Notification message) 알림메시지는모듈내부에서비동기적으로보내는메시지로 ASCII 모드일때만나타나는 메시지이다. message Parameter Description $MSG <ID>,<SADDR>,<LinkQuality>,<Message> 모뎀ID이보낸메시지 $ARP <ID>,<SADDR>,<EADDR> AT&ARP 명령에대한응답 $RARP <SADDR>,<ID> AT&RARP 명령에대한응답 $SND <transid>,<result> 보낸메시지에대한결과 $RESET 없음 모뎀리셋 $NWK COORD ROUTER,<SADDR> 모뎀이 ZigBee 코디네이터로 PAN을시작함모뎀이 ZigBee 라우터로기존의 PAN에가입하며해당모뎀의단축주소는 <SADDR> 임 7

8 2.3. 결과메시지 (Result message) 결과메시지는명령을수행한뒤에그결과를보여준다. Message OK ERROR FAIL NO_MEM Description 명령성공유효하지않은명령어또는변수내부에러발생메모리실패 8

9 3. AT 명령어설명 3.1. 직렬통신인터페이스 직렬통신포트설정 EZBee-300 모뎀은호스트와의통신을위하여표준직렬통신인터페이스 (RS-232C) 를제 공한다. EZBee-300 모뎀의직렬통신인터페이스는다음과같은기본설정값을가진다. 직렬포트기본설정값 Baud rate Data 8-bit Parity 없음 Stop bit 1-bit Flow control 하드웨어흐름제어 사용 EZBee-300 모뎀의직렬통신인터페이스는다음의 AT 명령어로설정할수잇다. AT+SPI? 없음 <baud >,<flow > 현재설정값을보여준다. AT+SPI= <baud>,<flow> OK or ERROR 새로직렬통신인터페이스를 설정한다 사용가능한매개변수 Parameter value description 9

10 baud 2400,9600,19200,38400,57600, 사용가능한 baud rate flow 0 하드웨어흐름제어사용해제 1 하드웨어흐름제어사용설정 AT 명령어를사용할때, 명령의끝은개행문자 ( \n ) 로구분한다 에코모드설정 직렬통신을할때입력된메시지에대한에코 (echo) 여부를설정할수있게해준다. AT+E0 없음 OK 에코모드를해제한다. AT+E1 없음 OK 에코모드를설정한다. AT+E? 없음 0 or 1 현재에코모드를보여준다 3.2. ZigBee 통신을위한 EzBee-300 모뎀설정 EZBee-300 모뎀이서로통신을하기위해서는서로간에네트워크설정값이일치해야한 다. EZBee-300 모뎀에서설정가능한네트워크변수는다음과같다 채널설정 PAN 을새로시작하거나기존에이미존재하는 PAN 에가입하기위해서는새로운주파수 채널을설정하거나기존의 PAN 과동일한채널로설정해야한다. 다음명령을사용하여 EZBee-300 모뎀의통신채널을설정하거나설정된통신채널을확 10

11 인할수있다. AT+CH? 11 ~ 26 현재설정된채널을보여준다. =<channel> OK or ERROR 새롭게채널을설정한다. 이미 PAN 이시작되었거나 PAN 에가입되어있는상태라면채널을설정한뒤에모뎀을리 셋해줘야바뀐상태가적용된다. 각채널별주파수는다음표와같다. Channel Frequency Channel Frequency MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz MHz PAN ID 설정 서로인접해있는 PAN 의구분이나원하지않는모듈의가입을막기위하여 PAN ID 를사 용하여 PAN 을서로구분해줄수있다. 설정가능한 PAN ID 는 0~16383 이다. 11

12 AT+PID? 없음 <PAN ID> 현재 PAN ID 를보여줌 AT+PID= 0~16383 OK ERROR PAN ID 를설정함 이미 PAN 을시작하였거나 PAN 에가입되어있는상태라면설정된 PAN ID 의값을반영하 기위하여모뎀을리셋해주어야한다 모뎀 ID 설정 ZigBee의단축주소는모뎀이 PAN에가입할때, 동적으로할당되기때문에 ZigBee 통신을위하여원격모뎀의단축주소만사용할경우에어느모뎀이해당단축주소를가지고있는지구분하기가용이하지않다. 따라서, EZBee-300은모듈간통신을용이하게하기위해각모듈에고유한 ID를설정한후그 ID를이용해통신할수있는기능을제공하고있다. ZigBee 통신을하기위하여각모뎀에고유 ID를설정해주어야한다. 다음은모뎀에설정된 ID를확인하거나새로운 ID를설정하는명령이다. AT+ID? 없음 0~253 현재설정된모듈 ID를보여준다. OK AT+ID= 0~253 ERROR 모뎀의 ID를설정한다. <SADDR>? OK 원격모뎀에대한 ID를불러온다. 모뎀 ID 0 은 ZigBee 코디네이터를의미하는것으로, PAN 을시작하기위해서는반드시 PAN 안에하나의코디네이터가존재하여야한다. 기존에 0 이아닌 PAN ID 를 0 으로바꾸거나, 0 이었던 PAN ID 를다른 ID 로바꿀경우에는반 드시 ATNZ 명령을통하여네트워크리셋을수행해야한다. 12

13 원격모뎀에대한 ID 명령의경우 <SADDR> 는원격모뎀의단축주소를의미하며 4 자리의 ASCII-HEX 포맷으로표현된다. 원격모뎀에대한 ID 질의명령이성공하였을경우다음과 같은이벤트메시지가반환된다. Message $ID@<SADDR>=<ID> Description 원격모뎀 <SADDR> 의모뎀 ID 그룹 ID 설정 EZBee-300 은한 PAN 내에서메시지를원하는모뎀그룹에만전송할수있는기능을제공한 다. 그룹메시지전송을위한그룹 ID 는다음명령으로설정및확인할수있다. AT+GID? 없음 0~255 모뎀의 Group ID를확인한다. OK AT+GID= 0~255 ERROR 모뎀의 Group ID를설정한다. AT+GID@<DstID>? 없음 OK 원격모뎀의 GroupID를확인한다. AT+GID@<DstID>= 0~255 OK 원격모뎀의 GroupID를설정한다. 원격설정명령은대상모뎀의원격접속이 1 로설정되어있어야한다 (AT+RA). 원격명령이성공하면다음과같은이벤트메시지가발생한다. Message $GID@<DstID>=<GroupID> Description 원격모뎀 <DstID> 에설정되어있는 GroupID 13

14 Bypass 모드를위한기본대상 ID설정 EZBee-300 모뎀에서 bypass 모드통신은호스트 (host) 에게 EZBee-300 모뎀을호스트와 peer 사이에일반적인유선직렬통신파이프가형성된것처럼보이게해준다. EZBee-300 모뎀을 bypass 모드로사용하기전에통신할대상을설정해야하는데다음의명령으로 bypass 모드시에통신할기본대상을설정하거나확인할수있다. AT+DST? 없음 0~253 모뎀에설정된기본대상 ID를확인한다. AT+DST= 0~253 OK 모뎀의기본대상 ID를설정한 ERROR 다 자동시작모드설정 모뎀을리셋하였을때, 자동으로 PAN 을시작하게하거나기존의 PAN 에가입하도록설정 하거나해제할수있다. AT+AS? None 0 or 1 현재자동시작모드를보여준다 AT+AS= 0 OK 자동시작모드를해제한다. 1 OK 자동시작모드를설정한다 ZigBee 네트워크시작하기 모뎀을처음설정하거나자동시작모드가꺼져있는경우, 다음의명령어를통하여 PAN 을시작하거나, 기존의 PAN 에가입한다. 14

15 AT&PS 없음 OK PAN을시작하거나 PAN에가입한다. ERROR PAN이이미시작되었거나 PAN에이미가입되어있음. PAN 이정상적으로시작되거나 PAN 에정상적으로가입되면다음과같은이벤트메시지가 발생한다. Message Description $NWK=COORD 코디네이터모드로 PAN을시작하였음. $NWK=ROUTER,<SADDR> 라우터모드로 PAN에가입하였으며, 단축주소는 SADDR임 15

16 3.3. 네트워크메시지전송및수신 본절에서는 EZBee-300 간에통신하는데필요한명령들에관하여기술한다 ASCII 모드에서메시지전송 ASCII 모드에서는보내고자하는메시지를다음표의형식에맞게 ASCII HEX 형태로메시 지를전송한다. ID<Modem ID> 를가진모뎀에메 <Modem ID>, <Message> 시지를전송함 <transid>/ 단축주소 <SADDR> 을가진모뎀에 S<SADDR>,<Message> ERROR/ 메시지를전송함 AT&MSG= FAIL/ 그룹 <GroupID> 에메시지를전송함 G<GroupID>,<Message> (Multi-cast). NO_MEM/ 전체 PAN에메시지를전송함 BROAD,<Message> (BroadCast). 결과메시지설명 : Result <transid> ERROR FAIL NO_MEM NWK_STOP Description 전송한메시지에대한트랜잭션 (Transaction) ID(0~255) 잘못된메시지형식이거나명령어임전송이모뎀내부적으로실패하였음모뎀에메모리가부족함 PAN이시작되지않았거나 PAN에가입되지않았음 메시지가모뎀에서전송되었을경우해당메시지에대한트랜잭션 ID 가반환되어송신결 16

17 과에대한태그로사용할수있다. 메시지가 peer 에성공적으로전송되었거나실패하였을경우다음과같이전송결과가이 벤트메시지로반환이된다. Message Parameter Description $SND= <transid>,<result> 전송상태 <transid> 는메시지를전송하였을때바로반환된트랜잭션 ID 이며, <result> 는 0 일경우 전송성공, 그이외의값은전송실패로간주한다. 메시지를수신받은모듈에서는다음과같이표시된다. Message Parameter Description $MSG@ <Modem ID>,<SADDR>,<link quality>= <Message> 모뎀 <Modem ID> 로부터메시지수신 메시지는 ASCII HEX 형식으로변환하여전송하여야하며, 전송하는메시지의길이는 AT 명 령을포함하여최대 127 자이상을넘지않도록하여야한다. 다음은메시지전송예를보여준다. 위의예에서모뎀 1 이모뎀 2 에보낸메시지는 0x13F7E536 이며모뎀 2 가메시지를수신 17

18 했을때의송신자의 ID 는 1 이고송신자의단축주소는 0x0001 이고수신감도는 134 이며, 메시지는 0x13F7E536 임을알수있다. 모뎀 2 가모뎀 1 에보낸메시지는 0x55AA7038 이며모뎀 1 이메시지를수신했을때송신자의 ID 는 2 이고송신자의단축주소는 0x14E8 이며수신감도는 120, 그리고메시지는 0x55AA7038 임을알수있다 Bypass 모드로메시지전송 EZBee-300은 Bypass 전송모드를제공하여모뎀간에생성된메시지를파이프를통하여 AT 명령어없이도시리얼 (serial) 로보내는데이터를그대로상대방에게전송할수있다. 각메시지간에는최소 6msec 이상의시간차를두어야 peer로메시지가전송이되며, 한번에보내는메시지는최대 64바이트이상을넘지않도록하여야한다. Bypass 전송모드는미리설정된수신 ID나모드전환시지정된 ID로메시지를보내게된다. 다음은 Bypass 모드전환에관련된명령어들이다. ATD <space><dstid> OK/ERROR/FAIL/NO_MEM 메시지전송모드를 Bypass 모드로 /NWK_STOP 전환한다. 설정된 Bypass 모드의수신자ID를? <DstID> 읽어온다. AT+DST =<DstID> OK /ERROR Bypass 모드의수신자ID를설정한다. +++ 없음 OK Bypass mode에서 ASCII 모드로전환한다. Bypass 전송모드에서는미리지정된수신 ID 로만메시지가송신된다. 그렇기때문에수신 ID 를바꾸기위하여는 ASCII 모드로전환해야하는데, 메시지전송모 18

19 드를바꾸거나수신 ID를바꾸는경우변경값이모뎀내부의플래시메모리 (flash) 에저장이되므로자주바꾸면플래시메모리영역이닳아버릴수있다. 따라서, 수신 ID가자주바뀌거나그룹메시지나브로드캐스트 (Broadcast) 메시지인경우, Bypass 전송모드는적합하지않고 ASCII 전송모드나 EBI 모드를사용하여야한다. 다음그림은메시지전송모드에따른메시지전송다이어그램을보여준다. 송신측이 Bypass 모드이고수신측이 ASCII 모드일경우, 송신측모뎀에서메시지를한번에 송신하였더라도내부의버퍼크기나송신지연등으로인하여수신측에서분할되어표시할 수있다 단축주소읽기 다음의명령어를사용하여코디네이터또는라우터로부터현재할당된 16 비트단축주소를 읽어올수있다. 19

20 AT+SA? 없음 <short address> 현재할당된단축주소를읽어온다. <DstID>? OK/ERROR/NWK_STOP ID가 <DstID> 인원격모뎀의단축주소를읽어온다. 만약읽어온단축주소가 FFFE 이면, 단축주소가할당되지않았음을 ( 즉, PAN 이시작되지않 았거나가입되지않았음 ) 의미한다. 원격모뎀의경우메시지전송이성공하였을경우다음의이벤트메시지가반환된다. Message Parameter Description $SA@ <DstID>=<SADDR> 모뎀 <DstID> 의단축주소는 <SADDR> 임 3.5. 확장주소읽기 다음명령어를사용하여모듈의 IEEE 64 비트확장주소를읽어올수있다. AT+EA? 없음 <extended address> 현재모듈의확장주소를읽어온다. AT+EA@ <DstID>? OK/ERROR/NWK_STOP ID가 <DstID> 인모뎀의확장주소를읽어온다. 확장주소의형식은 ASCII-HEX 16자이다 (8-byte). 원격모뎀에대한명령의경우명령이성공하였을때, 다음과같은이벤트메시지가발생한 다. Message Parameter Description $EA@ <DstID>=<EADDR> 모뎀 <DstID> 의확장주소는 <EADDR> 임 20

21 3.6. 모듈리셋 다음의명령어를사용하여모듈을리셋 (reset) 시킨다. ATZ 없음 $RESET 모듈을소프트웨어리셋시킨다 네트워크모듈리셋 모듈을 PAN 에다시가입하거나네트워크매개변수값을바꾼경우다음명령어를사용하여 네트워크상태를리셋시켜줘야한다. ATNZ 없음 $RESET 네트워크모듈을리셋시킨다 모듈버전읽기 모듈의버전정보를읽어온다. EZBEE300FV1.0 EZBEE300 FFD version 1.0 ATV 없음 EZBEE300RV1.0 EZBEE300 RFD version 모듈상태읽기 현재모듈의상태를읽어온다. 21

22 ATS 없음 $NWK=STOP $NWK=COORD $NWK=ROUTER,<SADDR> 현재 PAN 이시작되지않았거나가입되지 않았음 코디네이터모드로 PAN 을시작하였음 라우터모드로 PAN에가입하였고단축 주소는 SADDR 임 GPIO 제어및설정 EZBee-300 모뎀은로컬또는원격모뎀의 GPIO 및 ADC 를읽거나설정할수있는방법 을제공한다. EZBee-300 에서는 12 비트 ADC 2 채널과 GPIO 8 포트를제어하거나읽을수있다 GPIO 방향설정 EZBee-300 모뎀은다음명령을사용하여, 로컬또는원격모뎀의 GPIO 의입출력모드를 설정한다. AT+IOD? 없음 <direction value> 로컬모뎀의 GPIO 입출력방향을읽어온다. AT+IOD= <value> <direction value> 로컬모뎀의 GPIO 입출력방향을설정한다. 원격모뎀의 GPIO 입출력방향을읽어온 <DstID>? 다. AT+IOD@ OK <DstID>=<value> 원격모뎀의 GPIO 입출력방향을설정한다. GPIO 입출력설정값의포맷은다음과같다. 22

23 7(MSB) (LSB) PORT7 PORT6 PORT5 PORT4 PORT3 PORT2 PORT1 PORT0 유효값 (00~FF) 각포트별해당비트의값이 1일경우출력으로, 0일경우입력으로동작한다. 원격모뎀의 GPIO 방향레지스터를설정하기위하여는원격모뎀의원격접속이 1로설정되어있어야한다. 원격모뎀의경우성공시다음과같은이벤트메시지가수신된다. Message Parameter Description $IOD@ <DstID>=<value> 모뎀 <DstID> 로부터 IOD 값반환 GPIO 제어 EZBee-300 모뎀은다음명령을사용하여, 로컬또는원격모뎀의 GPIO 를제어하거나상 태를읽어올수있다. AT+IO? 없음 <value> 로컬모뎀의 GPIO 상태값을읽어온다. AT+IO= <value> <value> 로컬모뎀의 GPIO를제어한다. AT+IO@ <DstID>? OK 원격모뎀의 GPIO 상태값을읽어온다. AT+IO@ <DstID>=<value> OK 원격모뎀의 GPIO를제어한다. GPIO 입출력포맷은다음과같다. 23

24 7(MSB) (LSB) PORT7 PORT6 PORT5 PORT4 PORT3 PORT2 PORT1 PORT0 유효값 (00~FF) 각포트별해당비트의값이 1 일경우해당포트의상태가 높음 이거나 높음으로설정 한 다는의미이며, 값이 0 일경우는그반대이다. 원격모뎀에대한메시지의경우다음과같은이벤트메시지가반환된다. Message Parameter Description $IO@ <DstID>=<value> 모뎀 <DstID> 로부터 IO 값반환 ADC 읽기 EZBee-300 모뎀은다음의명령을사용하여, 로컬또는원격모뎀의 ADC 입력값을읽어 올수있다. AT+ADC? 없음 < CH1>,<CH2> 로컬모뎀의 ADC 입력값을읽어온다. AT+ADC@ <DstID>? OK 원격모뎀의 ADC 입력값을읽어온다. EZBee-300 의 ADC 는 3.3V 를레퍼런스전압으로동작하는 12 비트 2 채널 ADC 이다. ADC 를읽은결과는 ASCII HEX 형식으로출력된다. 예를들어서 ADC 채널 1 에 1.25V, 채널 2 에 2.5V 의입력전압이들어오면 ADC 출력은다 24

25 음과같다. 060F,0C1E 원격모뎀에대한메시지의경우다음과같은이벤트메시지가반환된다. Message Parameter Description <DstID>=<CH1>,<CH2> 모뎀 <DstID> 로부터 ADC 값반환 원격제어허용여부설정 EZBee-300 모뎀은다음명령을사용하여, 원격모뎀이자신의 GPIO 를제어하거나설정값 을변경하는것에대한허용여부를설정할수있다. AT+RA? 없음 1 / 0 현재설정된원격제어허용여부 AT+RA= 1 원격제어허용을설정 OK 0 원격제어허용을해제 PAN 가입허용여부설정 EZBee-300 모뎀은다음명령을사용하여, 다른모뎀이자신의 ZigBee Child 로 PAN 가입 을하는것을허용또는거절할수있다. AT+PMJ? 없음 1 / 0 현재설정된가입허용여부 AT+PMJ= 1 가입허용 OK 0 가입거부 AT+PMJ@ <DstID>? OK 원격모뎀의가입허용여부를확인하거 25

26 <DstID>=<1/0> 나설정한다. 원격모뎀에대한명령의결과는다음과같다. Message Parameter Description <DstID>=<value> 모뎀 <DstID> 에설정된가입허용여부 4. EBI 명령어설명 4.1. EBI 모드들어가기 EZBee-300 에서는좀더유연한통신방식을제공하기위하여 EBI(EZBee Binary Interface) 통 신모드를제공한다. ASCII 모드에서 EBI 모드로진입하기위해서는다음명령을사용한다. ATB 없음 OK 통신모드를 EBI 모드로변환한다 EBI 모드로데이터통신하기 EBI 모드에서통신하기위하여다음패킷포맷을준수하여야한다. 1byte 1byte 1byte 1byte Variable length SOP Type ID LEN DATA 각필드에유효한값은다음표와같다. 26

27 Field Value Meaning SOP 0x55 Start Of Packet Type EBI type 참조 메시지타입 ID 0~0xFF 수신 / 송신 ID LEN 0~0xFF 데이터길이 DATA - 실제데이터 4.3. EBI 패킷타입 EBI 모드에서제공하는패킷타입및의미는다음과같다. Packet type(mnemonic) CODE Meaning EBI_TYPE_UNICAST_MSG 0x10 유니캐스트메시지 EBI_TYPE_GROUP_MSG 0x11 그룹메시지 EBI_TYPE_BROAD_MSG 0x12 브로드캐스트메시지 EBI_TYPE_IO_REQ 0x20 로컬또는원격모뎀의 IO 레지스터의제어또는상태 값요청 EBI_TYPE_IO_ACK 0x21 EBI_TYPE_IO_REQ 에대한응답메시지 EBI_TYPE_IOD_REQ 0x22 로컬또는원격모뎀의 IOD(IO direction) 레지스터제어 또는상태요청 EBI_TYPE_IOD_ACK 0x23 EBI_TYPE_IOD_REQ 에대한응답메시지 EBI_TYPE_ADC_REQ 0x24 로컬또는원격모뎀에대한 ADC 상태값요청 EBI_TYPE_ADC_ACK 0x25 EBI_TYPE_ADC_REQ 에대한응답메시지 EBI_TYPE_ESCAPE 0x55 EBI 모드에서빠져나옴 (ASCII 모드로전환 ) 27

28 EBI_TYPE_ACK 0x80 모뎀에서결과메시지전송 EBI_TYPE_NET_ACK 0x81 네트워크에서결과메시지전송 EBI_TYPE_UNICAST_MSG Description: ZigBee 네트워크로유니캐스트메시지를전송하거나수신한다. Direction: Data len: ID: 수신 / 송신 가변 수신 / 송신 ID EBI_TYPE_GROUP_MSG Description: ZigBee 네트워크로그룹메시지를전송하거나수신한다. Direction: Data len: ID: 수신 / 송신 가변 수신 / 송신그룹 ID EBI_TYPE_BROAD_MSG Description: ZigBee 네트워크로브로드캐스트메시지를전송하거나수신한다. Direction: Data len: ID: 수신 / 송신 가변 브로드캐스트 ID(0xFF) 28

29 EBI_TYPE_IO_REQ Description: 로컬또는원격모뎀에대한 IO 레지스터제어또는상태값을요청함. Direction: Data len: ID: 송신 가변 원격혹은로컬 ID 데이터길이및변수값 : Data Length Parameter Descrption 0 0 IO 포트상태를요청한다. 1 0x00~0xFF IO 포트설정을요청한다 EBI_TYPE_IO_ACK Description: Direction: EBI_TYPE_IO_REQ 명령에대한응답메시지 수신 Data len: 1 ID: 원격혹은로컬 ID 데이터길이및변수값 : Value 0x00~0xFF Descrption 원격혹은로컬 ID 상태 29

30 EBI_TYPE_IOD_REQ Description: 로컬또는원격모뎀에대한 IOD 레지스터제어나상태값을요청한다. Direction: Data len: ID: 송신 가변 원격혹은로컬 ID 데이터길이및변수값 : Data Length Parameter Descrption 0 없음 IOD 레지스터상태를요청한다 1 0x00~0xFF Request set IOD register EBI_TYPE_IOD_ACK Description: Direction: EBI_TYPE_IO_REQ 명령에대한응답메시지 수신 Data len: 1 ID: 원격혹은로컬 ID 데이터길이및변수값 : Value 0x00~0xFF Descrption 원격혹은로컬 IOD 상태 30

31 EBI_TYPE_ADC_REQ Description: 로컬또는원격모뎀에대한 ADC 채널의상태값을요청함. Direction: 송신 Data len: 0 ID: 원격혹은로컬 ID EBI_TYPE_ADC_ACK Description: Direction: EBI_TYPE_ADC_REQ 명령에대한응답메시지 수신 Data len: 4 ID: 원격혹은로컬 ID Payload format: 1(byte) Channel-1 status Channel-2 value EZBee-300 의 ADC 는 12 비트 ADC 로 3.3V 를레퍼런스전압으로한다. 전송데이터포맷은항상 network-byte-order(big-endian) 으로전송된다 EBI_TYPE_ACK Description: Direction: 모뎀에서 ZigBee 네트워크로전송한메시지에대한결과 수신 31

32 Data len: 2 ID: 0 데이터형식 : 1(byte) 2 Result TransID Field Value Meaning 0 발송성공 1 유효하지않은메시지형식 Result 2 발송실패 ( 내부에러 ) 3 메모리할당실패 TransID 0~ 전송성공시, 메시지의트랜잭션 ID 본메시지는메시지가목적지에잘도착했는지에대한 ACK 가아니라로컬모뎀에서에러 없이잘전송이되었는지에대한 ACK 이다. 따라서상대방모뎀이없는경우에도본메시지 는 성공 으로반환될수있다 EBI_TYPE_NET_ACK Description: Direction: 네트워크에서 ZigBee 네트워크로전송한메시지에대한결과 수신 Data len: 2 ID: 0 32

33 데이터형식 : 1(byte) 2 Result TransID Field Value Meaning 0 발송성공 Result otherwise 발송실패 TransID 0~ 전송메시지의트랜잭션 ID EBI_TYPE_NET_ACK 메시지는브로드캐스트메시지나그룹메시지에대하여항상 성공 을반환한다. 주의할점은호스트에서유니캐스트메시지를모뎀에전송하더라도모뎀내부적으로 ID와매핑되는단축주소를모를경우이를해결하기위하여브로드캐스트메시지를사용하기때문에메시지를처음보낼때나상대방이없는경우도항상 성공 이라는메시지를반환하게된다 EBI_TYPE_ESCAPE Description: EBI 모드에서 ASCII 모드로복귀한다. Data len: ID: 0x55 0x55 EBI 모드에서 ASCII 모드로복귀하기위하여 0x 즉, ( UUUU ) 를 1 초이내에전송하 여야한다. 33