1

Install BTR

Common version only used for study , Standard version & enterprise version , APPLE Installing like LINUX used for comericial business.

common version installation

1.WINDOWS:

1) unpack BTR-common.zip to a temp directory d:\temp

2) cd d:\temp\win

3) run d:\temp\win\install.bat

install.bat

4) assign BTR directory , BTR directory can not be root directory.

d:\BTR

5) magic-no , magic-key

use magic-no , get magic-key from btrue company

6) try to start

d:\BTR\bin\bd.exe

　( First run bd.exe , windows firewall must allow d:\BTR\bin\*.exe can be run )

2.LINUX:

1) unpack BTR-common.zip to a temp directory .( here is /home/user/temp )

2) cd /home/user/temp/linux

3) run /home/user/temp/linux/install.sh

chmod ugo+x install.sh

./install.sh

4) assign BTR directory.

/home/user/BTR

5) magic-no , magic-key

use magic-no , get magic-key from btrue company

6) try to start

cd /home/user/BTR

./bd.sh

3.BSD UNIX( same as linux) :

1) unpack BTR-common.zip to a temp directory .( here is /home/user/temp )

2) cd /home/user/temp/unix

3) run /home/user/temp/unix/install.exe

chmod ugo+x install.sh

./install.sh

4) assign BTR directory.

/home/user/BTR

5) magic-no , magic-key

use magic-no , get magic-key from btrue company

6) try to start

cd /home/user/BTR

./bd.sh

4.ANDROID:

ANDROID has already included in WIN BTR debugger or LINUX BTR debugger.　

NETWORK

A: ANDROID DEVICE and BTR debugger both connect with WIFI

ANDROID DEVICE ---- WIFI ----- router

BTR debugger ---- WIFI ----- router

B: ANDROID DEVICE and BTR debugger both connect with ether lan

ANDROID DEVICE ---- ethercard ----- router

BTR debugger ---- ethercard ----- router

C: ANDROID DEVICE and BTR debugger communicate with AVD

ANDROID DEVICE ---- AVD( 10.0.2.2 ) ----- BTR debugger

5.MacOS( same as linux) :

1) unpack BTR-common.zip to a temp directory .( here is /Users/user/temp )

2) cd /Users/user/temp/unix

3) run /Users/user/temp/unix/install.exe

chmod ugo+x install.sh

./install.sh

4) assign BTR directory.

/Users/user/BTR

5) magic-no , magic-key

use magic-no , get magic-key from btrue company

6) try to start

cd /Users/user/BTR

./bd.sh

EMBED LINUX

1) Embed linux use PC Linux BTR debugger

2) In pc linux,
cd /home/usrname/BTR
./bd.sh
bd >
bd > build /home/usrname/myembed_prj
bd >

3) eg: download myembed_prj.exe to embed linux board

4) run /opt/myembed_prj.exe at embed board
chmod 0777 /opt/myembed_prj.exe
cd /opt

NETWORK

A: EMBED DEVICE and BTR debugger both connect with WIFI

EMBED DEVICE ---- WIFI ----- router

BTR debugger ---- WIFI ----- router

B: EMBED DEVICE and BTR debugger both connect with ether lan

EMBED DEVICE ---- ethercard ----- router

BTR debugger ---- ethercard ----- router

BTrue Box Connection

Standard version : 1 btrue box <==> n pc

Enterprise version : 1 btrue server pc <==> n pc

btrue box or btrue debugger server pc supplied by btrue software company.

btrue box 2 mac ports

WANLAN LAN

1. Standard version to single user btrue box connection

Code PC btrue box router
PC (USB)-------- LAN
(Ether)-------------------------------------------- ROUTER

PC use USB to communicate with btrue box LAN interface. Keep old ether card connect or not connect to router.

2. Standard version to multi-user

Code PC btrue box router
WANLAN ---------------- ROUTER
PC1 ---------------------------------------- ROUTER
PC2 ---------------------------------------- ROUTER

And what is btrue box ip ? see next,

3. Standard version test box ip

Code PC btrue box router
WANLAN ----------------------------------- ROUTER
pc ------------------------LAN
PC1 -------------------------------------------------- ROUTER
PC2 -------------------------------------------------- ROUTER

pc connect to btrue box LAN port, run boxip.bat to print box ip.
Here 'pc' maybe handset pc, or 'pc' maybe PC1 | PC2 .

4. Enterprise version to multi-user

Code PC router
btrue server --------------------- ROUTER
PC1 --------------------------------------------- ROUTER
PC2 --------------------------------------------- ROUTER

And what is btrue server ip ? btrue server print the BTR-server-ip.txt file regularly.

USB disk plugin btrue server PC to get the file.

　

5. Enterprise version firewall

btrue server used to configure firewall , and btrue box have not this function.
A. Powerful firewall configuration needs enterprise version .
B. Cloud debugger in some company , only need enterprise version.
C. The configuration of btrue server is the same configuration as user's PC.

6. btrue box power

1) USB power 2 ) 220V power

You can select one of the power supply.
USB power connection needs a usb cable. 220V power seems powerful enough.

Enterprise version , standard version installation

1.WINDOWS:

1) unpack BTR-enterprise.zip to a temp directory d:\temp

2) cd d:\temp\win

3) run d:\temp\win\install.bat

install.bat

4) assign BTR directory , BTR directory can not be root directory.

d:\BTR

5) assign server ip

Enterprise version needs server ip , and standard version needs BTR box ip.　

6) try to start

d:\BTR\bin\bd.exe

　( First run bd.exe , windows firewall must allow .\bin\*.exe to run )

2.LINUX:

1) unpack BTR-enterprise.zip to a temp directory .( here is /home/user/temp )

2) cd /home/user/temp/linux

3) run /home/user/temp/linux/install.sh

chmod ugo+x install.sh

./install.sh

4) assign BTR directory.

/home/user/BTR

5) assign server ip

Enterprise version needs server ip , and standard version needs BTR box ip.

6) try to start

cd /home/user/BTR

./bd.sh

3.BSD UNIX( same as linux) :

1) unpack BTR-enterprise.zip to a temp directory .( here is /home/user/temp )

2) cd /home/user/temp/unix

3) run /home/user/temp/unix/install.exe

chmod ugo+x install.sh

./install.sh

4) assign BTR directory.

/home/user/BTR

5) assign server ip

Enterprise version needs btrue server ip . ( standard version needs BTR box ip )

6) try to start

cd /home/user/BTR

./bd.sh

4.ANDROID:

ANDROID has already included in WIN BTR debugger or LINUX BTR debugger.　

NETWORK

A: ANDROID DEVICE and BTR debugger both connect with WIFI

ANDROID DEVICE ---- WIFI ----- router

BTR debugger ---- WIFI ----- router

B: ANDROID DEVICE and BTR debugger both connect with ether lan

ANDROID DEVICE ---- ethercard ----- router

BTR debugger ---- ethercard ----- router

C: ANDROID DEVICE and BTR debugger commucate with AVD

ANDROID DEVICE ---- AVD( 10.0.2.2 ) ----- BTR debugger

6.EMBED LINUX

1) embed linux board use PC linux BTR debugger.
2) In PC linux ,
cd /home/yourname/BTR
./bd.sh
build /home/yourname/myembed_prj

3) eg: download myembed_prj.exe to embed board
4) run myembed_prj.exe on embed board
/opt
chmod 0777 myembed_prj.exe
./myembed_prj.exe
5) In pc BTR debugger.
bd> flash -s a.txt
open /home/yourname/BTR/a.txt to see BTR debugger message.

NETWORK

A: EMBED DEVICE and BTR debugger both connect with WIFI

EMBED DEVICE ---- WIFI ----- router

BTR debugger ---- WIFI ----- router

B: EMBED DEVICE and BTR debugger both connect with ether lan

EMBED DEVICE ---- ethercard ----- router

BTR debugger ---- ethercard ----- router

Enterprise version authentication

1. common version upgrade to enterprise | standard version

Customer use common version and feel it is good , then customer want to officially use standard version or enterprise version.
Call 023-68935745 or email btrue@163.net or 3rd sales , BTRUE engineer will install standard | enterprise version at custom company.

2. authentication
Agreement will assign on which technical service years , user number , price will be list out. BTR box and BTR server pc will supply to user’s company.

3. server pc
server PC and btrue box both supplied by BTRUE COMPANY . Our engineer goes to user’s company install server , authenticate server , and train last user .
server PC needs firwall to let it run ok. Debugger server will run while power on and shutdown while power off.

Start enterprise | standard version:

( BTR server power on , or btrue box power on )

1. WINDOWS

d:\BTR\bin\bd.exe

2. LINUX

cd /home/user/BTR

./bd.sh

3. BSD UNIX

cd /home/user/BTR

./bd.sh

Shutdown BTR debugger:

bd >

bd > shutdown

BTR server power off.

Uninstall BTR debugger:

If you installed BTR driver engine, use

uninstall_driver.bat or unindtall_driver.sh

to uninstall BTR driver engine first.

uninstall.bat or unindtall.sh

to uninstall BTR debugger.

WINDOWS:

uninstall.bat

LINUX:

./install.sh

BSD UNIX:

./install.sh

Question & Answer

1) java , c#

Q: I have already install BTR, but I can't debug java or c# project ?

A: Mayebe network config wrong, the ip which build time set should be:

PC1: ( run java | c# )

PC2: ( runs btr debugger )

if ( pc1==pc2 ) ip = 127.0.0.1

else ip = PC2 ip address

when pc1 != pc2 , pc1 and pc2 should both connect to wifi , or connect to ether lan.

2) java　

Q: I have already install BTR, but I can't debug java project ?

A: Please check if javac.exe version is the same as the java.exe version.

javac -version

java -version

3) java , c#

Q: I have already install BTR, but I can't debug java | c# project ?

A: Java | c# will be deployed after build . please check deploy shell file if it is ok or not.

4) Qt

Q: I use BTR debug compile my Qt project OK , How to run it out of Qt IDE ?

A: Set Path , eg: Path=C:\Windows\system32;C:\Windows;...;C:\Qt\Qt5.2.1\5.2.1\msvc2012\bin

5) large project

Q: I use BTR debug my project, sometimes the code log have no [file][no] location , why?

A: Because the project is large and you use free BTR version. Enterprise version have no this problem.

6) build failed

Q: I use BTR build my project , but it failed , why?

A: First , you must rebuild all your project without BTR debugger. Then you use BTR debugger build it.

7) ANDROID java

Q: BTR debugger for android java can not build project ?

A: 1, Please check SDK , NDK , GRADLE_HOME envirment.

2, config network ok

if ( android in AVD ) ip = 10.0.2.2

else if ( android has wifi ) ip = BTR debugger pc ip

else if ( android has ether lan ) ip = BTR debugger pc ip

3, assign the correct studio module

bd > build /home/usr/mystudio_prj ( build default module ./app )

bd > build /home/usr/mystudio_prj/mymodule_aar ( build module : mymodule_aar )

8) android

Q: Android app can't break ?

A: No. android app can break. but it will cause app process quit android os. you can run the app again.

9) Android run again

Q: I run my android project again ,I see flash 0 lines, what should I do?

A: Sorry , please exit emulator first , start emulator again , start bd.exe again , then flash command will list all code lines now.

10) Debug 2 web applications in one time

Q: I use BTR debug 2 web applications in tomcat, but tomcat crashed, why?

A: deploy Java app , shutdown web server , start web server again .

11) EMBED LINUX
Q: How to install BTR debugger in embed linux board?
A: You do not need to install BTR debugger in embed linux board. BTR debugger in normal linux pc will build and debug embed device.

12) EMBED LINUX
Q: My embed device only have serial port , can it use BTR debugger?
A: No , you can't use BTR debugger. embed device must use LAN network to connect to BTR debugger pc .

embed device ------ wifi -------BTR debugger

embed device ------ ethercard-------BTR debugger

13) EMBED cpu
Q: My embed device is mips CPU, can BTR debugger debug it.
A: Yes , BTR debugger can debug non-arm cpu device.

14) EMBED serial

Q: My embed device only have serial port , can it use BTR debugger?
A: No , Can't. The only condition is your embed device has LAN network.

15) DRIVER ENGINE
Q: I use BTR build my driver ok, but BTR cannot debug the code,why?
A: You should install BTR driver engine first , then install BTR next! Note that BTR driver engine will lose when reboot OS.

16) SERVER IP
Q: How can I know the server ip , when I install multi-user version?
A: Plugin usb to BTR debugger server pc , after serial minutes BTR_SERVER_IP.txt return , which contents ip address.