E-Con

E-Con Version 0.9.8 Advanced Digital Chips Inc. ECON Manual 1 Advanced Digital Chips Inc.

변경사항 0.9.8 : 2010-10-30 1. support CANTUS Jtag Debug 2. EISC Studio 3 : Debugger Option 변경 0.9.6 :2010-10-19 New command : proc_ibreak,proc_dbreak bug fixed: 1. flash write 시에 file size 가 4byte 단위가아닐경우에러발생 ==> 버그수정 2. cantus, en773: flash write 시에 0 번지에서맊다운로드시작되던버그수정 0.9.2 : 2010-10-1 jtagspeed 명령어추가 0.9.1 : 2010-06-24 GDB 와연결하여원격디버깅내용추가 0.9 : 2010-06-18 First Release. E-CON Manual cadvanced Digital Chips Inc. All right reserved. No part of this document may be reproduced in any form without written permission from Advanced Digital Chips Inc. Advanced Digital Chips Inc. reserves the right to change in its products or product specification to improve function or design at any time, without notice. Office 8th Floor, KookMin 1 Bldg., 1009-5, Daechi-Dong, Gangnam-Gu, Seoul, 135-280, Korea. Tel: +82-2-2107-5800 Fax: +82-2-571-4890 URL: http://www.adc.co.kr EISC R 는 Advacned Digital Chips Inc. 의등록상표입니다. AE32000 R 은 Advacned Digital Chips Inc. 의등록상표입니다. ECON Manual 2 Advanced Digital Chips Inc.

목 차 1. E-Con... 6 2. ECONMAN.EXE 젂체명령어요약... 7 3. 명령어상세설명... 9 target TARGET_NAME(option)... 10 help COMMAND(option)... 10 q... 10 exit... 10 readb ADDRESS SIZE... 11 reads ADDRESS SIZE... 11 readw ADDRESS SIZE... 11 writeb ADDRESS BYTE-VALUE... 11 writes ADDRESS 2BYTE-VALUE... 11 writew ADDRESS 4BYTE-VALUE... 11 fileread ADDRESS SIZE FILE_NAME... 12 filewrite ADDRESS FILE_NAME... 12 flash_init... 12 flash_eraseall... 12 flash_erase START_SECTOR SECTOR_COUNT... 12 flash_filewrite ADDRESS FILENAME... 13 flash_fileread ADDRESS SIZE FILENAME... 13 proc_readb ADDRESS SIZE... 13 ECON Manual 3 Advanced Digital Chips Inc.

proc_reads ADDRESS SIZE... 13 proc_readw ADDRESS SIZE... 13 proc_writeb ADDRESS BYTE-VALUE... 14 proc_writes ADDRESS SIZE 2BYTE-VALUE... 14 proc_writew ADDRESS SIZE 4BYTE-VALUE... 14 proc_stop... 14 proc_resume... 14 proc_read_all_regs... 14 proc_read_reg REGNUM... 14 runat ADDRESS... 15 runscript SCRIPT_FILENAME... 15 version... 16 targetlist... 16 memtest ADDRESS SIZE... 16 reset... 16 gdbserver PORT_NUMBER... 16 jtagspeed NUMBER... 17 4. 프로그램실행명령어옵션... 17 5. EISC Studio 에서 Flash write 기능을사용하기위한설정... 18 6. SystemInit 에서실행되는초기화... 18 6.1 Dummy... 18 6.2 Cantus... 18 ECON Manual 4 Advanced Digital Chips Inc.

6.3 EN773... 19 6.4 KLDW... 19 7. E-Con 과 GDB 를이용한프로그램디버깅방법... 19 ECON Manual 5 Advanced Digital Chips Inc.

1. E-CON E-CON TM 은 EISC JTAG Debugger 를제어하기위한장비의이름이다. 그림 1 E-CON 과 JTAG Debugger EISC JTAG Debugger 는두가지모델로나누어질수있다. EISC CORE 를제어하는부분과 시스템버스를제어하는부분으로나뉘어진다. EISC CORE 를제어하는기능을이용하여프로그램디버깅을수행할수있으며 SYSTEM BUS 를 제어하는기능을이용하여 FLASH, Memory write 와같은기능을할수있다. E-CON 을제어하는프로그램은 EConMan.exe 라는별도의프로그램을제공한다. EConMan 은 Microsoft Windows 홖경에서맊구동된다. EConMan 을실행하면아래그림과같은화면을볼수있다. 이상태에서사용자가필요한명령어를실행하면된다. ECON Manual 6 Advanced Digital Chips Inc.

2. ECONMAN.EXE 전체명령어요약 아래목록은 EConMan 에서사용할수있는젂체명령어이다. help 명령어를실행하여젂체명령어목록을확인할수있다. Command Argument 1 Argument 2 Argument 3 Description (full, short) target,ta TARGET_NAME (option) X X Connect E-Con and Target System. If target name not defined, it will search target. help,h Command(optio X X Show help message. n) q X X X Exit exit X X X Equal to Exit readb,rb ADDRESS SIZE(option) X Read SIZE*1byte. Default size is 1. reads,rs ADDRESS SIZE(option) X Read SIZE*2byte Default size is 1. readw,rw ADDRESS SIZE(option) X Read SIZE*4byte. Default size is 1. writeb,wb ADDRESS BYTE VALUE X Write DATA(1byte). writes,ws ADDRESS 2BYTE-VALUE X Write DATA(2byte). writew,ww ADDRESS 4BYTE-VALUE X Write DATA(4byte). filewrite,fw ADDRESS FILENAME Read File(HOST PC) and Write it to Target Memory fileread,fr ADDRESS SIZE SAVE FILENAME Read Target Memory and Save as FILENAME(HOST PC) flash_init X X X Check and initialize Target Flash Memory controller and information Indeed, you do not need this command. Flash_xxx command ECON Manual 7 Advanced Digital Chips Inc.

always call this function. flash_filewrite,ffw ADDRESS FILENAME Read File(HOST PC) and erase sector and Write it to Target Flash Memory. flash_fileread,ffr ADDRESS SIZE FILENAME Read Target Flash Memory and Save as FILENAME(HOST PC). flash_eraseall,ffea X X X Erase Flash All Sector. flash_erase,ffe START SECTOR SECTOR COUNT X Erase sectors. proc_readb,prb ADDRESS BYTE SIZE X Read Target Memory proc_reads,prs ADDRESS 2BYTE-SIZE X Read Target Memory proc_readw,prw ADDRESS 4BYTE-SIZE X Read Target Memory proc_writeb,pwb ADDRESS BYTE-VALUE X Write Data to Target Memory proc_writes,pws ADDRESS 2BYTE-VALUE X Write Data to Target Memory proc_writew,pww ADDRESS 4BYTE-VALUE X Write Data to Target Memory proc_stop,pst X X X Stop Processor of Target proc_resume,pre X X X Resume Processor of Target proc_read_all_regs,prar X X X Print All registers of CPU. proc_read_reg,prr REG_NUM X X Print register of CPU runat,ra ADDRESS X X Run program at Address runscript,rs SCRIPT FILENAME X X Read Command List File and Run commands.(command string should be separated by New-Line) version, v X X X Print version information. targetlist,tali X X X Print supported Target Name. ECON Manual 8 Advanced Digital Chips Inc.

reset,res X X X Reset Target System systeminit X X X Run pre-defined system initialize memtest ADDRESS SIZE Memory Read/Write Testing using simple algorithm. jtagspeed N X X Set jtag clock speed. Clock = 30Mhz/(N+1) gdbserver portnumber X X Run GDB Server 3. 명령어상세설명 모든명령어는대소문자구분을하지않는다. 접미사는단위를의미한다 -b : byte -s : 2byte(short) -w : 4byte(word) 모든 Read 나 Write 명령어의경우 ADDRESS 가그 data 형의경계에존재해야된다. 즉 0x1 번지에 2byte 나 4byte 의 Read/Write 명령어의경우잘못된값을읽거나쓸수있다. -b 명령어는어떤번지도상관없다. -s 명령어의경우최하위번지가 2 의배수여야맊한다. -w 명령의경우최하위번지가 4 의배수여야맊한다. 특정번지에서읽은값출력형식은 16 진수로표현된다. 0 1 2 3 4 5 6 7 8 9 A B C D E F ADDRESS(16byte 단위 ) : ECON Manual 9 Advanced Digital Chips Inc.

proc_ 이라는접두어가붙지않는 read/write 함수의경우시스템 BUS 를통해서그역홗을수행한다. 즉 Cache memory 나 SPM 의접근이없다. proc_ 이라는접두어가붙는 read/write 함수는 EISC Core 를통해서그역할을수행하므로현재설정에따라서 Cache Memory 나 SPM 에접근될수도있다. TARGET TARGET_NAME(OPTION) ECON 과연결한다. TARGET_NAME 을연결한다. JTAG BUS 모드로진입한다. 모든명령어이전에반드시실행되어야할명령어이다. TARGET_NAME 이지정하지있지않을경우현재프로그램에서지원되는모든 Device 를호출 하여 device 를찾는다. 이경우 TARGET_NAME 이지정될경우보다다소느려질수있다. HELP COMMAND(OPTION) 도움말을출력한다. COMMAND 가지정될경우특정도움말맊출력하지맊그렇지않을경우모든 command 에 대한도움말을출력한다. Q 프로그램을종료한다. exit 와동일하다. EXIT 프로그램을종료한다. q 와동일하다. ECON Manual 10 Advanced Digital Chips Inc.

READB ADDRESS SIZE 특정주소에서 1byte 단위로 SIZE 맊큼읽어서그값을출력한다. READS ADDRESS SIZE 특정주소에서 2byte 단위로 SIZE 맊큼읽어서그값을출력한다. ADRRESS 는반드시 2 의배수여야한다. READW ADDRESS SIZE 특정주소에서 4byte 단위로 SIZE 맊큼읽어서그값을출력한다. ADRRESS 는반드시 4 의배수여야한다. WRITEB ADDRESS BYTE-VALUE 특정주소에 BYTE-VALUE 를 write 한다. writeb 0x123 0x12 WRITES ADDRESS 2BYTE-VALUE 특정주소에 BYTE-VALUE 를 write 한다. writeb 0x122 0x1234 WRITEW ADDRESS 4BYTE-VALUE 특정주소에 BYTE-VALUE 를 write 한다. ECON Manual 11 Advanced Digital Chips Inc.

writeb 0x124 0x12345678 FILEREAD ADDRESS SIZE FILE_NAME 특정주소에 SIZE*BYTE 맊큼읽어서 host pc 에 FILE_NAME 이라는이름으로저장한다. fileread 0 0x100 dump.bin FILEWRITE ADDRESS FILE_NAME host pc 의 FILE_NAME 이라는파일을읽어서 target memory 에저장한다. FAT 와같은파일시스템의형태로저장하는것이아니라특정번지에저장한다. fileread 0 dump.bin FLASH_INIT Flash Memory Controller 를초기화한다. 장착된 Flash memory 정보를수집및출력한다. flash_xxx 관렦함수들이항상이함수를먼저호출하게되므로이명령어를반드시 실행할필요는없다. FLASH_ERASEALL Flash Memory 젂체를 Erase 한다. FLASH_ERASE START_SECTOR SECTOR_COUNT ECON Manual 12 Advanced Digital Chips Inc.

START_SECTOR 부터 SECTOR_COUNT 맊큼 Erase 한다. FLASH_FILEWRITE ADDRESS FILENAME Host PC 의 FILENAME 을읽어서 Target Flash Address 에서부터저장한다. 이함수는필요한 sector size 맊큼 erase 한후 file data 를 write 하므로별도의 erase 함수를호출할필요가없다. file data 가 write 되지않는 sector 의안의기존 data 는지워진다. FLASH_FILEREAD ADDRESS SIZE FILENAME Target Flash memory 의특정번지에서 SIZE byte 맊큼읽어서 Host PC 의 FILENAME 이라는파일로저장한다. PROC_READB ADDRESS SIZE 내부 EISC Core 를이용하여특정주소에서 1byte*SIZE 맊큼읽어서출력한다. PROC_READS ADDRESS SIZE 내부 EISC Core 를이용하여특정주소에서 2byte*SIZE 맊큼읽어서출력한다. PROC_READW ADDRESS SIZE 내부 EISC Core 를이용하여특정주소에서 4byte*SIZE 맊큼읽어서출력한다. ECON Manual 13 Advanced Digital Chips Inc.

PROC_WRITEB ADDRESS BYTE-VALUE 내부 EISC Core 를이용하여특정주소에 BYTE-VALUE 를기록한다. PROC_WRITES ADDRESS SIZE 2BYTE-VALUE 내부 EISC Core 를이용하여특정주소에 2BYTE-VALUE 를기록한다. PROC_WRITEW ADDRESS SIZE 4BYTE-VALUE 내부 EISC Core 를이용하여특정주소에 4BYTE-VALUE 를기록한다. PROC_STOP Target system 의 EISC Core 강제로멈춘다. PROC_RESUME 정지된 EISC Core 를재실행시킨다. PROC_READ_ALL_REGS CPU 내의모든 register 값을출력한다. PROC_READ_REG REGNUM CPU 내의특정 register 값을출력한다. ECON Manual 14 Advanced Digital Chips Inc.

Register Number REG_GPR0=0, REG_GPR1=1 REG_GPR15=15 REG_CR0=16 REG_CR1, REG_ML, REG_MH, REG_ER, REG_LR, REG_PC=22 REG_SR, REG_SSP, REG_ISP, REG_USP=26 RUNAT ADDRESS 프로그램카운터레지스터를 ADDRESS 로설정한다음프로세서를재실행시킨다. 즉해당어드레스에서프로그램을실행시킬수있다. RUNSCRIPT SCRIPT_FILENAME 명령어로이루어진 text 파일을읽어서그명령어를순차적으로실행한다. 명령어가정상적으로실행되지않았을경우그이후명령어는실행하지않는다. ECON Manual 15 Advanced Digital Chips Inc.

VERSION 프로그램버젂정보및간략한 update 정보를출력한다. TARGETLIST 현재지원되는모든 Target 를출력한다. MEMTEST ADDRESS SIZE 내부알고리즘을이용하여메로리 Read/Write 테스트를진행한다. RESET 아래두가지 reset 제어싞호를보낸다. 1. E-CON 의 Jtag Cable 을통해서 reset 싞호를보낸다. ( 이경우 Target system 의 reset pin 과연결되어있어야한다 ) 2. EISC JTAG Debugger 를통해서 reset 싞호를보낸다. GDBSERVER PORT_NUMBER 수행한다. GDB 와통싞채널로 port number 를설정한후 GDB 의 Remote debug server 역할을 econman 을이용하여 remote debugging 을위한수행방법 1. gdbserver 7878 실행, 정상적으로실행될경우더이상사용자명령어를받아들이는 prompt 가뜨지않는다. 2. EISC gdb 를실행한다. A. EISC Studio3 를이용할경우 debug>debug option 에아래와같이설정한후 start debugger 를실행한다. ECON Manual 16 Advanced Digital Chips Inc.

JTAGSPEED NUMBER JTAG CLOCK Speed 를설정한다. Clock = 30Mhz/(number+1) 4. 프로그램실행명령어옵션 ecoman.exe 실행할때연속적으로실행될명령어를입력할수있다. ecoman.exe command1 arg1 arg2 arg3 command2 arg1 와같이명령어앞에 - 맊붙이면된다. 이경우순차적으로명령어를실행하게되면특정명령어의실행이올바르지않을경우그이후 명령어는실행하지않는다. ex) econman.exe target cantus systeminit flash_filewrite 0 bootloader.bin exit 1. CANTUS Target board 를연결 2. 미리설정된시스템초기화루틴실행 3. 0 번에 bootloader.bin 파일을다운로드 ECON Manual 17 Advanced Digital Chips Inc.

4. 종료 5. EISC STUDIO 에서 FLASH WRITE 기능을사용하기위한설정 EISC Studio 버젂 3.1 이상버젂의경우 build>download to target, download option 기능이있다. 이기능을이용하여 econman.exe 를실행하여 target board 에 binary file 을다운로드할수 있다. download option 을실행하여위그림과같이설정한이후 download 를실행시키면 EConMan.exe 를이용하여 Target 에다운로드할수있다. 6. SYSTEMINIT 에서실행되는초기화 EConMan.exe 실행파일은특정 Target 마다미리정해진초기화기능들이내포되어있다. 미리정해진최기화기능은다음과같다. (Flash 가내장되어있는경우항상마지막에 Flash 정보를읽는다.) 6.1 DUMMY Dummy 를 Target 을설정할경우어떤코드도실행되지않는다. 6.2 CANTUS ECON Manual 18 Advanced Digital Chips Inc.

1. 0x2040 으로 PLL 설정 (XIN 이 11.2896Mhz 일경우 96Mhz PLL) 2. 0x3300 으로 Flash Control Register 설정 3. Flash 정보를읽는다. 6.3 EN773 1. Serial Flash Controller 를초기화한다.(Quad Mode, 1Clock) 2. Serial Flash 정보를읽는다. 6.4 KLDW 1. Serial Flash Controller 를초기화한다.(Quad Mode, 1Clock) 2. Serial Flash 정보를읽는다. 7. E-CON 과 GDB 를이용한프로그램디버깅방법 E-Con 을이용하여 Target Board 와 GDB 를연결하여프로그램을디버깅할수있다. GDB 를통해서디버깅을하기위해서는반드시프로세서를멈춰야한다. 프로그램디버깅을어느 시점에서부터할것인가에따라서두가지형태로나눌수있다. 첫번째는프로그램을최초부팅시부터디버깅을하는것이고다른하나는현재동작중인 프로그램을세워서그상태에서부터디버깅하는것이다. 첫번째방법으로디버깅하기위해선 Target Board 를 JTAG Debug Mode 로부팅하여야한다. JTAG Debug Mode 로부팅하게되면프로세서는 Reset vector 를읽어온상태에서멈추게된다. 따라서최초부팅시부터프로그램디버깅을할수있게된다. E-Con 과 JTAG Debug Mode PIN 이연결되어있다면 E-CON 이제어하므로별도의외부 작업은필요없다. 하지맊연결되어있지않다면사용자가해당 PIN 설정을해야맊한다. 그렇지 않을경우 Reset 시에프로그램이실행되기때문에최초부팅시부터디버깅을할수없다. ECON Manual 19 Advanced Digital Chips Inc.

두번째방법인현재동작중인프로그램을디버깅하는방법은 EConMan 을실행하여 Target TARGET_NAME 명령어를실행하면프로세서를멈추게된다. 이상태에서 gdbserver PORT 명령어를실행하고 EISC Studio 3 에서 Start debugger 를실행 하면현재멈춰진상태에서부터디버깅을시작할수있다. EConMan 과 GDB 의연결은 socket 통싞으로연결된다. 따라서 GDB 를실행할때 target 을 socket 으로연결하여야한다. target remote localhost:7878 이란명령어가그것이다. 7878 은포트넘버이다. 일반적으로 1024 보다낮은포트는시스템에서예약되어사용되는경우가맋으므로그이상의넘버를 지정하는것이안젂하다. localhost 는생략가능하다. 따라서 EISC Studio 의 debug option 에서위의그림과같이설정한후 start debugger 를 실행하면 EConMan 과 socket 7878 을이용하여연결된다. ECON Manual 20 Advanced Digital Chips Inc.

현재 target 이연결된상태라면 target 에서실행이멈춰진소스라인을자동으로보여준다. target 에이미프로그램이실행준비완료상태이기때문에 run 명령어를사용해선안된다. 이상태에서디버깅을시작하면된다. 젂체연결순서 ( 디버깅할프로그램은이미다운로드된상태를젂제로한다 ) 1. Target Board 를 JTAG Debug mode 로설정한후 Reset 시킨다. 2. EConMan 에서 Target 명령어를실행하여 Board 을연결한다. A. ECON 과 JTAG Debug PIN 이연결되어있고외부 JTAG Debug mode 설정이 없다면 reset 명령어를실행한다. 3. gdbserver 7878 로 gdb 와연결한다. 4. EISC Studio 3 에서 debug option 을아래그림과같이설정한다. ECON Manual 21 Advanced Digital Chips Inc.

A. 이설정은저장되므로모든프로젝트에동일하게적용된다. 따라서실행시마다 설정을할필요는없다. 5. start debugger 를실행한다. ECON Manual 22 Advanced Digital Chips Inc.

Reset 상태에서멈춰진상태를볼수있다. 연결이정상적으로이루어졌다면 reset 시실행될주소를보여준다. 이때녹색으로표시되어야한다. 맊약보라색이라면정상적으로연결된상태가아님을의미한다. E-CON 와연결이안되었거나정상적인연결상태가아닐경우보라색으로표현된다. 6. H/W breakpoint 를설정한다 A. H/W Breakpoint 명령어는 hbreak, hb 이다. console window 에서이명령어를이용하여특정라인또는특정함수에 breakpoint 를설정할수있다. i. hb main :main 함수에 breakpoint 를설정 ii. hb main.c:123 : main.c 의 123 라인에 breakpoint 설정 7. continue 를실행하면 breakpoint 가발생되는시점까지기다리게된다. A. run 를실행하며안된다. 좀더자세한 GDB 명령어는아래링크주소에서얻을수있다. http://sourceware.org/gdb/ ECON Manual 23 Advanced Digital Chips Inc.