Remote API

Introduction

TRACE32는 Application Programming Interface (이후로 API로 표시) 를 이용하여 외부 application 으로 target을 control 과 debugging 가능하다.

API는 C library와 C function interface로 control 할 수 있다. API 는 socket interface를 이용해 TRACE32 application과 통신한다. (TRACE32 단독으로는 안됨) command chain은 다음과 같다.

Interface

Application -> TRACE32 API

Application은 기본 C function을 사용한다.

TRACE32 API -> TRACE32 display driver

TRACE32 S/W (PowerView) 는 socket interface 기반으로 통신한다. 통신을 위한 네트워크 연결을 사용 할 때는 API를 포함한 application control 과 두 개의 다른 host가 있어야 한다. 이 연결 방법은 제대로 된 방법이 아니다. 기본적으로 API 내에는 error detection을 해주는 네트워크 설정이 없기 때문이다. 그렇기 때문에 같은 host에서 running 할 수 있는 방법을 추천한다.

TRACE32 display driver -> TRACE32

S/W (PowerView)는 API가 TRACE32 H/W를 통해 요청하는 루트로 되어있다. Interface 방법은 세가지 중 (Ethernet, parallel, USB) 하나를 선택할 수 있다.

API build 하기

API file 구성

두 개의 C source file과 하나의 header file 로 이루어져 있다. (C:\T32\demo\api\capi\src)

① hlinknet.c : TRACE32 socket interface 하는 source file.

② hremote.c : 모든 API function 을 가지고 있는 source file.

③ t32.h : API header file.

API와 Application의 연결

API 를 사용 할 때는 header file은 “t32.h”에 반드시 포함된다. Source의 시작을 의미한다.

#include “t32.h”

Compile 과 linking 할 때 API file 은 application의 source를 반드시 handling 한다.

cc -c hlinknet.c

cc -c hremote.c

cc -c applic.c

linker는 “cc”로 object file은 “o”로 표현된다.

cc -o applic hlinknet.o hremote.o applic.o

TRACE32 Software 준비

TRACE32 S/W는 remote control 을 사용 하기 위해 API와 같은 환경설정을 해야 한다. “config.t32” 파일을 아래와 같이 수정하도록 한다.

;Environment Variables

OS=

ID=T32_1000021

TMP=C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp

SYS=C:\T32

HELP=C:\T32

; Standard License File used

;T32 API Access

RCL=NETASSIST

PORT=20001

PACKLEN=1024

;T32 Intercom

; not used

;Connection to Host

PBI=

USB

;Screen Settings:

SCREEN=

HEADER=TRACE32 API_REMOTE

;Printer Settings:

PRINTER=WINDOWS

PACKLEN 은 socket 통신을 위한 최대의 package length (byte) 를 넣어준다. 1024가 최대이다.

Port Number 는 API 통신을 위해 사용하는 UDP port 를 넣어준다. Default 는 20000이다. 이미 port 20000이 사용 중이기 때문에 20000보다 크게 설정한다.

API 환경 설정

T32_Config(), T32_Init() 과 T32_Attach() function 들에 의해서 API 환경 설정을 한다. T32_Config() 는 두 개의 변수를 가지며 node name과 port number이다. T32_Init() 은 통신 채널 셋업 설정을 한다. T32_Exit() 는 connection을 끊을 때와 application의 terminating 전에 항상 호출된다.

나머지 function들은 C:\T32\pdf\api_remote.pdf에서 확인 할 수 있다.

API 활용 방법

TRACE32 Remote API 은 상당히 많은 기능을 제공한다 여기에서는 그 중에 가장 많이 사용되는 API에 대하여 사용 방법 및 예제에 관하여 설명한다.

타겟 상태 읽어 오기 : T32_GetState

Explanation	현재 Target 보드의 상태가 Down/Halt/Stop/Running 인지를 확인
Prototype	int T32_Getstate ( int *pstate );
Parameters	pstate : ICD 상태 값을 Return 받을 변수 지정
Returns	0 : Debug system 이 DOWN 상태 1 : Debug system 이 HALT 상태 2 : Target이 Break 에 걸려있는 상태 3 : Target이 Runnig 중인 상태
Example	int state = -1; error = T32_GetState ( &state ); /* no error handling, but state preset to detect problems */ printf ("System is "); switch (state) { case 0: printf ("down.\n"); break; case 1: printf ("halted.\n"); break; case 2: printf ("stopped.\n"); break; case 3: printf ("running.\n"); break; default: printf ("Error!\n"); }

타겟 CPU Reset : T32_ResetCPU

Explanation	Target CPU 을 Reset 하기 위하여 내부적으로 SYStem.UP, Register.Reset 을 진행
Prototype	int T32_ResetCPU ( void );
Parameters	none
Returns	0 : 실행 성공 0 외의 다른 값 : Error 발생
Example	error = T32_ResetCPU ();

CMM 스크립트 실행 하기 : T32_Cmd

Explanation	Powerview 에서 수행할 명령어 실행
Prototype	int T32_Cmd ( const char *command );
Parameters	command : 수행할 명령어 정의
Returns	0 : 실행 성공 0 외의 다른 값 : Error 발생
Example	error = T32_Cmd ( "Data.Set %Long 12200 033FFC00" ); error = T32_Cmd ( "Do test.cmm" ); *명령어에 대한 결과 메시지는 T32_GetMessage() API를 통해 확인 가능하다.

메모리 읽기 : T32_ReadMemory

Explanation	Target 메모리부터 Data 를 Read 함
Prototype	int T32_ReadMemory ( uint32_t byteAddress, int access, uint8_t *buffer, int byteSize );
Parameters	byteAddress : Data를 읽어올 메모리 주소 번지 access : 메모리 접근 형태(클래스 * 0x0 : data memory) buffer : 전달 받은 버퍼 변수 byteSize ; 메모리에서 읽어올 Byte 수
Returns	0 : 실행 성공 0 외의 다른 값 : Error 발생
Example	// Read 16 bytes from address D:0x100 // 1) byte-addressed machine (e.g. x86, MicroBlaze, PPC) uint8_t buffer[16]; error = T32_ReadMemory (0x100, 0x0 /D:/, buffer, 16 /bytes/); // 2) word-addressed machine using 16bit words (e.g. C2000) uint8_t buffer[16]; error = T32_ReadMemory (0x100 * 2 /16bit/, 0x0, buffer, 16 /bytes/);

메모리 쓰기 : T32_WriteMemory

Explanation	Target 메모리부터 Data 를 Write 함
Prototype	int T32_WriteMemory (dword address, int access, byte * buffer, int size);
Parameters	address : Data를 Write 할 메모리 주소 번지 access : 메모리 접근 형태(클래스 * 0x0 : data memory) buffer : Write 데이터의 버퍼 변수 size ; Write 할 Byte 수
Returns	0 : 실행 성공 0 외의 다른 값 : Error 발생
Example	unsigned char buffer[16]; error = T32_WriteMemory ( 0x100, 0xc0, buffer, 16 );

compile 환경설정

compiler 설치

① Visual Studio 2005 Professional 을 설치한다. (Visual Studio 2005 설치가이드 문서를 참고한다.)

② 설치 후에는 C:\Program Files<x86>\Microsoft Visual Studio 8 폴더를 확인 한다.

* 다른 compiler를 이용할 경우 GCC, Sun Compiler를 이용할 수 있다.

makefile 설정

① make file에는 설치된 compiler 환경에 따라 경로 설정을 변경해 준다.

② 경로 사이에 공백이 사이에 있을 경우 “” 로 처리해준다.

* 설치 후 기본 적인 make 파일은 다음과 같다.

# Microsoft compiler

MSDIR=C:\Program Files\Microsoft Visual Studio .NET 2003\Vc7

INCDIR="$(MSDIR)\Include"

INCDIR2="$(MSDIR)\PlatformSDK\Include"

LIBDIR="$(MSDIR)\Lib"

LIBDIR2="$(MSDIR)\PlatformSDK\Lib"

MCC="$(MSDIR)\bin\cl.exe" -DWIN32 -DMS_WINDOWS -I$(INCDIR) -I$(INCDIR2) -I"..\src"

MLINK="$(MSDIR)\bin\link.exe" /LIBPATH:$(LIBDIR) /LIBPATH:$(LIBDIR2) /OUT:$@

# GNU compiler

# GCC=/usr/local/bin/gcc -ansi -Wall

# GLINK=/usr/local/bin/gcc -o $@

# Sun compiler

# SCC=/usr/ucb/cc -I/usr/openwin/include

# SLINK=/usr/ucb/cc -o $@

LINK=$(MLINK)

CC=$(MCC)

OBJ=hremote.obj hlinknet.obj hrtest.obj

OBJ2=hrcmd.obj hlinknet.obj hremote.obj

OBJ3=notifications.obj hlinknet.obj hremote.obj

all: t32rem.exe hrtest.exe

notifications.exe : $(OBJ3)

$(LINK) $(OBJ3) kernel32.lib wsock32.lib

t32rem.exe : $(OBJ2)

$(LINK) $(OBJ2) kernel32.lib wsock32.lib

hrtest.exe : $(OBJ)

$(LINK) $(OBJ) kernel32.lib wsock32.lib

hremote.obj : ../src/hremote.c ../src/t32.h

$(CC) -c -o $@ ../src/hremote.c

hlinknet.obj : ../src/hlinknet.c ../src/t32.h

$(CC) -c -o $@ ../src/hlinknet.c

hrtest.obj : hrtest.c ../src/t32.h

$(CC) -c -o $@ hrtest.c

hrcmd.obj : hrcmd.c ../src/t32.h

$(CC) -c -o $@ hrcmd.c

notifications.obj : notifications.c ../src/t32.h

$(CC) -c -o $@ notifications.c

build 하기

① cmd를 이용해 build 한다.

② Source가 설치 된 경로로 이동해 nmake 하면 된다.

③ Exe 파일이 제대로 생성이 되었는지 확인한다.

API 사용하기

TRACE32 start

① config.t32 수정 후 t32marm.exe 를 실행한다. (C:\T32)

② compile이 완료 된 exe 파일을 실행한다. 위의 ①②의 실행 순서에 주의 하도록 한다.

Command	Description
q / Quit Program	API 프로그램 종료
c / System Up	Target 연결. System up
D / Do Test	Test.cmm 실행
g / Go	Target running
b / Break	Running 중인 target break
S / Single Step	Stepping debugging
r / Read Registers	Register 값 read
s / Show target State	현재 target status 표시