CPIT GP7x/GP6X SDK

7/30/2019 CPIT GP7x/GP6X SDK

1/25

Document about SDK

For CPIT Devices

Creator: slyzhang/cang.zhang

DateTime: July 3, 2006

Module: Samsung2410 solution(GP7X/GP6X)

Version: R1.6

PDF "pdfFactory Pro" www.fineprint.cn
http://www.fineprint.cn/http://www.fineprint.cn/


2/25

CPIT DOCUMENT OF SOFTWARE DEVELOPMENT

Createor : Sly Zhang(Cang.zhang) page 2 of page 25 2006-7-7

Content

History Version Control List................3

Requeset...............................................4

Install SDK ..........................................4

Create a demo application .................10Steps................................................................................................................................10

Debug with Remote Tool ................................................................................................ 13

FAQ about user application ...............16Could I use the registry to save the user values? .................................................................... 16Could I package the navigation software to OS? .................................................................... 16

Could we avoid user to copy files using USB connector? ...................................................... 17

FAQ about SDK.................................17How to control the backlight...................................................................................................17

How to get the battery life.......................................................................................................18

How to control the volume......................................................................................................18

How to control the stylus ........................................................................................................ 18

How to Get the GUID of device ............................................................................................. 19

How to get the Memory size...................................................................................................19

How to get the OS version...................................................................................................... 19

how to control the GPS com port............................................................................................19

How to Enter the Suspend mode.............................................................................................20

How to use the MUI feature....................................................................................................20

How many languages are supported ....................................................................................... 20

How to launch external executable file...................................................................................20

How to Test the GPS signal with our device........................................................................... 21

How to control the Key Board................................................................................................ 21

About the Win32 API: CreateFileForMapping ....................................................................... 21

How to Upgrade the OS..........................................................................................................22

How to change the second startup logo...................................................................................22

Support...............................................25



3/25



History Version Control List

Version Content Creator DataTime

R1.0 sly zhang/cang.zhang June 1, 2006

R1.1 add auto launch file sly zhang June 5,2006

R1.2 add the dependence of some API sly z hang June 15, 2006

R1.3 add the detail of the Upgrade System slyzhang June 29, 2006

R1.4 found a bug about get the OEM info slyzhang July 3, 2006

R1.5 and how to change the second logo slyzhang July 4, 2006

R1.6 Add FAQ about application slyzhang July 7, 2006



4/25



Requeset

OS: Windows2000/windowsXP

Develop platform: EVC4.0+SP4 or other tools

ActiveSync: Microsoft ActiveSync 3.7 or later, 3.8 is tested and

recommended.

USB interface: you have USB cable and had installed the USB driver for

PC, not the driver for OS upgrading.

Install SDK

Please read the USB driver and ActiveSync installing guide if you did not

installed those software. You could get it from support page of website:

http://www.cpit.com.hk

After you install the USB driver and the Microsoft ActiveSync software,

you should install the SDK package. Following is the step-to-step:

1. Download the *.msi(for example:gp-75_SDK.msi) file from supportpage of website:

http://www.cpit.com.hk



5/25



2. Double click or open the file you had downloaded.

3. Press the Next to continue.



6/25



4. Accept the license

5. Input the user name and the Organization.



7/25



6. You could select the Custom or Complete to install , here I selected theCustom.

7. select the Location you will to install.



8/25



8. Press the Install to start coping the files.

9. and click the Finish to complete.



9/25



10.You could see the GP75 item at the Install/Remove program controlpanel.

It is the same operate if you use the old version SDK file, perhaps the sdk

file name is XXXB.msi on your hand. Dont worry about it its the

same.



10/25



Create a demo application

Steps

Now, Create a demo application to test this SDK . The test Platform is

Embedded Visual C++ 4.0. Open the EVC4.0 and create a new

application as follow.

Select the Win32 [WCE ARMV4] option.

Here we will create a Dialog based demo application.



11/25



You must select the XXXB or XXXB-STANDARD option at the target

device type list , the last option is XXXB Device like following picture.

You must connect the USB cable with your PC If want to debug your

application. After you installed the USB driver and Microsoft ActiveSync,



12/25



normally you could see the folders and files of the device.

Now build and run your application. Maybe following picture are

appeared, dont worry about it, you only need to click OK(YES) to

Continue .



13/25



You could see your application appeared.

Debug with Remote Tool

After you entered the Windows CE desktop, insert the USB into socket

your PC will auto detect the USB insert event, press the menu tools of

EVC 4.0, and click the submenu Remote registry Editor.



14/25



And then click the first button of the tool bar. You could see follow

remote devices:



15/25



Select the GP75_SDK or XXXB option.

After some files copied to target device, the remote registry will be

showed.



16/25



If you could not use the remote debug tools, please check your PC

windows version, maybe the Windows2003 and ActiveSync4.0 version

(Chinese version) could not connect correctly. The windowsXP+SP2 and

ActiveSync3.8 is recommended.

If you could not connect and copy system file to the target, please connect

us, and re-upgrade your kernel file. Upgrading the kernel file, please read

the detail about How to upgrading the Kernel file.

FAQ about user application

Could I use the registry to save the user values?

Our device did not support the Hive-based of registry, so you could not save some values into the

registry, if you do that, those values will lost after device power off or system reset. You could

save some values into external storage, such as SD card or internal flash space. If you found a

folder of IPSM, you could save value on it, its a internal flash.

Could I package the navigation software to OS?

You can not package the navigation software into OS, it is have to done by us, not you side. Please

connect with us if you want to do.

Its not recommended to package the navigation software to OS, because it cost many and many

SDRAM and affect the performance of kernel, its recommended to save the navigation software

to external storage, if you want to protect your navigation, its a good idea to package the

navigation engineer into OS kernel file. But if you want to upgrade the navigation engine, its

recommended that you could use the GUID of device by using KernelIOControl().



17/25



Could we avoid user to copy files using USB

connector?

We could not avoid user to copy files using USB connector, because we want user to upgrade the

navigation map data by USB connector.

FAQ about SDK

How to control the backlight

Registry key and value

;=========== Default backlight Setting ===============

[HKEY_CURRENT_USER\ControlPanel\Backlight]

"ACBacklightOnTap"=dword:1

"BacklightOnTap"=dword:1

"BatteryTimeout"=dword:0

"ACTimeout"=dword:0

"UseExt"=dword:0

"UseBattery"=dword:0"OnOffAC"=dword:00000000 // 1:Enable the AC plug event 0 :ignore this event

"ACBrightNess"=dword:00000064 //the default backlight when you insert the AC when

//OnOffAC value is dword:1

"BrightNess"=dword:00000032 //the default backlight when you plug out the AC

//when OnOffAC value is dword:1

Event

BackLightChangeEvent

Example:

static const TCHAR szevtBacklightChange[] = TEXT("BackLightChangeEvent");

//user change the BackLight

HANDLE hBacklightEvent= CreateEvent(NULL,FALSE,FALSE,szevtBacklightChange);



18/25



How to get the battery life

Using the Win32 API :

GetSystemPowerStatusEx

The device should auto detect the system battery life , in order to have a

steady system ,we will set the system level as following:

Battery Voltage x> 3.8 BATTERY_FLAG_HIGH 50%

3.8>x>3.6 BATTERY_FLAG_LOW 10%3.3>x>3.6 BATTERY_FLAG_CRITICAL


19/25



TouchCalibrate();

How to Get the GUID of device

1.Define

#define IOCTL_HAL_GET_DEVICE_INFO CTL_CODE(FILE_DEVICE_HAL, 1,

METHOD_BUFFERED, FILE_ANY_ACCESS)

#define IOCTL_HAL_GET_DEVICEID CTL_CODE(FILE_DEVICE_HAL, 21,

METHOD_BUFFERED, FILE_ANY_ACCESS)

2.Call the function

KernelIoControl(IOCTL_HAL_GET_DEVICEID,OutBuf,1024,OutBuf,1024,&dwRe

turn))To get the OEM information or GUID info.

The dwReturn may return 0 because of there has a bug. It is fixed after version 2.0623

How to get the Memory size

Normally, use the Win32 API of the librarycoredll.dll

GetSystemMemoryDivisionGlobalMemoryStatus

How to get the OS version

Version information is saved at registry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Version]

"OS Version"=" OS Version:2.0604 "

"HW Version" = " R6.0 "

how to control the GPS com port

COM Port configuration:

Port: COM1

ByteBits : 8

StopBits: 1

StartBits: 1

Parity; None



20/25



BaudRate: 9600

How to Enter the Suspend mode

Use one of the following Win32 APIs of the library coredll.dll

SetSystemPowerState()

PowerOffSystem()

This feature is supported after kernel version 2.60601partage is supported at before version.

How to use the MUI feature

MUI component is packaged into kernel, any other language will be changed freely using the

Microsofts MUI component. Please send me your idea if you have some. Your idea maybe will

accelerate our mass product.

How many languages are supported

All European main characters and code pages are added. They are Latin, Greece, Baltic sea,

turkey, Portugal, Iceland , Norwegian, Russian, mid-Europe and the Aria font as the system default

font .

The Chinese version do not have MUI component and other language code page.

How to launch external executable file

Normally , the Shell will auto run the Main UI file cpithello.exe. This UI has two methods to

launch the navigation software on the SD card. The one UI has three ICON buttons, our

end-customer press the navigation ICON button to launch the navigation system or see the GPS

signal, the other is directly search the navigation software. You can select any one of them.

Its recommend to save an autorun.inf file to the root of SD card. The content is like following:

autorun=\Storage Card\MobileNavigation.exe

the other path is packaged into the kernel file, the following registry key will be auto searched

after search file \\Storage Card\\autorun.inf

[HKEY_LOCAL_MACHINE\SOFTWARE\autorun]

"AutorunFir"="\\Storage Card\\NaviOne\\NaviOne.exe"



21/25



"AutorunSed"="\\Storage Card\\startup\\smartguider.exe"

This way is only for a mass products.

You must connect with me if you want to launch other application. You must confirm whether you

OS has those functions.

How to Test the GPS signal with our device

We packaged a simple demo application (GPSTest.exe) for test the device, you could find it in

the \windows, normally , it has the Hide/System attribute.

You could download the same test software from our website.

If you use the other test software, you could launch it with up option detail How to launch

external executable file.

How to control the Key Board

Normally, we do not use any key board event for GP7X device because the GP75 module has no

keyboard.

But the GP6X modules has 4 key buttons, one is Power ON/OFF, one is for suspend (because of

customer do not want the suspend/awake feature, we changed it and use it as wake up the Main

Menu), other two are for volume control.The power on/off button did not have any virtual key value, its depend on the hardware.

The suspend button has a mapped key value: VK_LEFT.

The volume control key values are VK_DOWN, VK_UP.

You could use those keys as any purpose, you only need to RegisterHotKey before use them

and UnregisterHotKey when you do not use them.

About the Win32 API: CreateFileForMapping

Some company use this API to get more RAM for navigation applications. But I known it s

depended with the OS features, such as the below registry key value.

;;;;;;;;;;;; Maybe Some GPS Navigation company do not use this item.

;[HKEY_LOCAL_MACHINE\System\StorageManager\FATFS]

;"Paging"=dword:0

So, you must confirm your whether your current OS support it. If not ,please check the OS History



22/25



List at our side or check the Remote Registry value with the EVC4.0 or Platform Builder Remote

tools.

How to Upgrade the OS

The OS support upgrading the OS and kernel file on the user interface screen. And there are three

ways to upgrade the OS and the Logo. The one is ask the upgrade kernel tools from the company

which made the hardware. Please ask the documents from the original company. The other way is

that upgrading the OS on the user interface screen. Please read the user guide of the device.

Normally, its on the system option configuration screen. The last is use the API of the OS

supported.

You could use the following library (update.dll) and all the function

//This functionn will update the OS ,

// pOSBuffer is the update data from user

//the length is dwBufferSize, length is limited from 1MB to 32MB

//Return TRUE indicate the success

//dwUpdateType : 0:OS

BOOL UPD_Update(DWORD dwUpdateType, DWORD pOSbuffer,DWORD dwBufferSize)

The length is limited as following:

Update type description length limited

0 update OS Max length is 32MB and Min size is 6MB

1 No support

2 not support now

3 not support now

If you upgrade the wrong file size, you will get a FALSE return value and you could useGetLastError() get the reason, normally, you will get a ERROR_BAD_LENGTH (Error Code: 24)

or the ERROR_INVALID_PARAMETER when you input a wrong update type.

Note: This feature is supported after OS version 2.062201.

How to change the second startup logo

Please read the Note at the end of this section.

There are two startup logos, one is the first logo after power on or reset the device, the other is thethird screen after the screen which showed the message If you could not receive the GPS signal,



23/25



please use the external antenna. You could follow the steps to change it.

1. You must install the USB driver for PC firstly. You could read the USB driver install guider.2. You must install the Microsoft ActiveSync software for files synchronization.3. Power on the device and connect USB cable with your PC after main screen appeared, and

then ActiveSync will auto connect to device and at the same time you could see the files in the

ActiveSync explorer. Then, copy the GPS test software (normally you got it from CPIT, and

its name normal is GPSreciever_test.exe or something else) to the SD card(its the folder

Storage card in the ActiveSync explorer). File Microsoft ActiveSync and USB driver

install Guide.pdf will give you some help. After you connected with PC, you could see the

files and folders in the device, if you found the IPSM folder, you could skip the step 4,5 and

directly do the step 6.

4. Rename your original navigation software name, normally rename Alturion gps.exe to somename else, and then rename the GPS test software(GPSReciever_test.exe) to Alturion

GPS.exe to make the kernel could execute the test application. This file will be executed

automatically. (Insert SD card and reboot the device if you do it using SD card reader.)

5. Click the menu TEST and select the submenu STORAGE MEMORY, to format the internalflash, this internal flash will save your logo which you want to show. After you click this

submenu , test software will ask you whether you want to format the follow storage memory

and at the same time it will show the device name and storage name like FlashDr and Flash

Disk, select YES to format the internal flash. And you could find the folder IPSM in the

ActiveSync explorer.

6. Copy your logo to the IPSM folder and rename it as logo.bmp and reboot/reset device youwill see the new second logo appeared.



24/25



Note:

l not all of versions OS support this feature, its depend which one you use.l Normally you could seccuss after you format the flash storage. If you have a failure

message, please check whether the folder IPSM exists.

l If you want to change the second logo but your current OS did not support this feature,please connect us.

l This feature is only for special customer. And you must check whether your kernelsupported it

l If you found your device entering the RGB three color screen after you format the internalflash, please upgrade a old OS using DNW.exe. this is only because a few version OS will

format all data(including the image space) on the internal flash. Dont worry about it, only

need to upgrade again. And use a other OS is recommended.



25/25



Okay, good luck . please connect to sly.zhang (cang.zhang) if you have

other troubles.

Creator: slyzhang (Cang.zhang)

Support

Company: CPIT ( Central Pacific Electronics(ShenZhen)Ltd.)

Website: http://www.cpit.com.hk

http://www.cpit.com

Email: [email protected]

[email protected]

[email protected]

PostCode: 518057

Address : Shen Jian building

Shenzhen Hi Tech science Pard

Ma Que Ling industrial Estate

Nanshan Shenzhen

CHINA

Documents

CPIT GP7x/GP6X SDK