Argox PT-10 Operating instructions

Programming Guide for
PT-10/12
Portable Data Collector
Copyright © 2005 by ARGOX Information Co., Ltd.
http://www.argox.com
Version: 2.30 2006/10/30

1
Preface
To satisfy the user’s customized needs, the PT-10/12 provide users to
generate programs for their actual demands. This allows users to collect data,
execute function expression and store the processed data with the application
programs designed by their own.
Developers can use Assembly, C, and C++ to create the program flow. And
developers can also link standard ANSI C function library to meet the demands
through executing the functions of input, output, expression and storage using
the functions provided by PT-10/12.
Later in this manual, you’ll learn how to write the program, how to compile the
linking program, how to download renewed codes and how to test simulation
functions. Finally, this manual will also conclude the function illustration of
PT-10/12 for your reference.

2
Table of Contents
Programming Guide for PT-10/12 Portable Data Collector
1. Program Design：................................................................................................4
◆Development Environment.......................................................................4
◆Function Library..........................................................................................7
◆Standard Function Library........................................................................8
◆How to Build Your Program......................................................................9
2. Simulator..........................................................................................................13
3. Upgrade User Program.............................................................................16
4. Software Support ........................................................................................17
5. SDK Utility........................................................................................................18
6. General Library.............................................................................................20
◆Memory Allocation and Management..................................................24
◆Data Conversion Routines......................................................................25
◆Searching and Sorting.............................................................................26
◆Date and Time Function..........................................................................27
◆File Manipulation.......................................................................................30
◆Input and Output Routines.....................................................................33
◆System Calls for Collector......................................................................41
◆System Calls for Simulator.....................................................................43
◆System Calls for BIOS Setting...............................................................44
◆Graphics-Text Mode .................................................................................45
◆Graphics-Graphics Mode........................................................................46
◆Menu Management....................................................................................49
7. DBMS Library..................................................................................................53
◆DBMS Functions Description ................................................................53
8. CL Library.........................................................................................................63
◆Reader..........................................................................................................66
◆Buzzer ..........................................................................................................69
◆Calender ......................................................................................................71
◆File Manipulation.......................................................................................72
◆LED................................................................................................................84
◆Keypad.........................................................................................................85
◆LCD...............................................................................................................88
◆Communication Ports..............................................................................95

3
◆Keyboard Wedge.......................................................................................99
◆System.......................................................................................................101
◆Power..........................................................................................................102
◆Other...........................................................................................................102

4
1. Program Design：
◆Development Environment
1. User Program Directory
1.1 Menu Structure:
When open the SDK folder in the CD provided with the PT-10/12, it will
show the structure as the following:
1.2 Function Instruction:
‧ Binary file is used to store the generated UserProg.bin files through
Armmake. It is needed when updating programs.
‧ Error file is used to store the generated error or warning files through
Armmake.
‧ Library file is that the library needed is put to the place while
developing the procedure.
‧ MVC file is used to develop program in Microsoft Visual C++ 6.0.
‧ Object file is used to store Armmake generation file.
‧ ARM Project Manager file is used to store ARM Project Manager 2.51
installation files.
‧ Source file is used to store the program files and the PT-10 function
library used in the programs.
1.3 Adding Source File:
For all the source files under the program has to be placed under SRC
folder, also record the entire needed file name under Makefile (placed
under SRC folder), or under ARM Project Manager file before
proceeding with compiling and linking process.

5
2. Development Tool Kit Directory
The Development Tool Kit is available from the menufacture or the
suppliers. After installing the Development Tool Kit, run the files store under
ARM251\WINDOWS\SETUPexe, upon installation completion, both DOS
and Windows will be ready for programming.
2.1 DOS Environment:
Upon installation, under ARM251\BIN\ folder, it will generate the
following commands for compiling, linking, and generating purpose.
Command Function Extension
Armasm.exe Merge to combine codes *.s, *.a
Armcc.exe Edit C & C++ files *.c, *.h
Armlink.exe Link object files *.obj, *.alf
Armmake.exe –a Run MAKEFILE MAKEFILE
2.2 Windows Environment:
‧ Follow the steps above to complete installation and the Windows
system will create a shortcut under (Start\Program\ARM SDT
v2.51\ARM Project Manager shortcut)
.
‧ Click on the shortcut to runARM Project Manager for Windows.
‧ ARM Project Manager for Windows can add a new project by
including Source and Library in order to generate a Binary file and
then download to the data collector to complete the process.
‧ For detailed operations of ARM Project Manager, please refer to the
help files of ARM Project Manager for Windows.
\ (Compressed File) -------ARM251 -------WINDOWS -------SET.exe

6
3. Simulation Directory
3.1 Menu Structure:
When open the SDK folder in the CD provided with the PT-10/12, it will
show the structure as the following:
3.2 Menu Instruction：
‧ “Debug”,”Release” is used to store the source file that created by
compiling and linking user programs.
‧ “Executable” is used to store the execution files of simulator and
dynamical linking function library.
‧ “Library” is used to store the library functions files, including the *.h
files.
‧ “SRC” is used to store the customerized program files, including the
*.cpp files.
3.3 Adding User Program:
This simulator is required running under the Microsoft Visual C++ 6.0.
The file adding and deleting must be done under this environment. All
the user program files have to be stored in the UPFiles folder. Simply
select the Project\Add to project\Files…function, and record the
UPCode file under Workspace“SDK_SIM. You will be able to view the
file lists through the Workspace windows, and then proceed with
debugging.

7
◆Function Library
‧ The user program of data collector can use the PT-10/12 Function
Library provided by the manufactur to complete the data collection
jobs. PT-10/12 Function Library provides variety of services, and
accomplish special functions according to specifical demands.
‧ When using the PT-10/12 Function Library, please add the import
command (#include “UserLib.h＂, “DBMS.h”, “LIB_CL.h”) into the
user program file (*.c) and the function can be imported. In this case,
the PT-10/12 Function Library file SDKLib.alf is needed. The path
should be:
SDK\UserProg\Library\SDKLib.alf (Refer to User Program Directory)
‧ The PT-10/12 Function Library file SDKLib.alf has always the revision
control issue. For most updated version, please ask helps from your
vendor or the manufactur. If your function library has errors or
requirements for new features, this file needs to be updated.
‧ In order to complete generating the UserProg.bin file, the PT-10/12
Function Library file SDKLib.alf will be needed when compiling and
linking.
‧ The libraries offered at present has:：
1.UserLib.h: General Functions. Please refer General Library of this
document.
2.LIB_CL.h: CL Functions. Please refer CL Library of this document.
3.DBMS.h: Database Manage System. Please refer DBMS Library of
this document.
‧ If want to use the examples of CL and DBMS libraries, please copy
LIB_CL and DBMS examples to UserProg.c in SDK\UserProg\SRC.
Executes the UserProg.apj file in SDK\UserProg\SDT. After compiling,
You must download the binary file to PT-10 and use the example file in
collector.

8
◆Standard Function Library
‧ The user program in the data collector can complete the tasks by
using standard C language function library. The function library is
enclosed in the developing environment (ARM Software Development
Toolkit). When the developing environment installation was completed,
you will find the include head file of standard C language function
library in the directory \\ARM251\Include. The following are the
available include head file list in standard C language function library:
<assert.h>
__assert ;
<ctype.h>
isalnum ; isalpha ; iscntrl ; isdigit ;isgraph ; islower ; ispr; ispunct ;
isspace ; isupper ; isxdigit ; tolower ;toupper ;
<locale.h>
setlocale; localeconv;
<math.h>
acos; asin; atan; atan2;cos; sin; tan; cosh;
sinh; tanh; exp; frexp;ldexp; log; log10; modf;
pow; sqrt; ceil; fabs;__d_abs; floor; fmod;
<setjmp.h>
setjmp; longjmp;
<signal.h>
signal; raise;
<stdio.h>
sprintf; sscanf;
<stdlib.h>
atof; atoi; long atol; strtod;long strtol; strtoul; rand ; srand;
_ANSI_rand; _ANSI_srand; abort; atexit; exit; getenv; system; bsearch;
qsort; abs; long labs;
‧ If you need to use standar C language functions in the user program,
please import the correlated include head files, and import #include
<header file name> in the top of the file. See following sample:
#include <stdio.h>
‧If follow the steps above, after running the Compile and Link, all the
correlated functions will be imported and used to generate as the
UserProg.bin file.

9
◆How to Build Your Program
1. Edit Program:
‧ Developers may use the UserProg.c file under SRC folder in the User
Propgram Directory as the starting file. And you can use int
UserProg(void) as the start point to edit the program. And also you
can freely create a new source file to proceed structuralization
development.
‧ There is a sample program was enclosed. It is the service system for
Import, Export, Search and Link.And already covers most of the
function-calls and the way to use. There are toally three file were
included:
UserProg.c, UserDef.c, and UserLib.h.
‧ For regulations and procedures in the developing procedures, please
refer to the “Development Notice”
2. Under DOS Mode:
‧ Add or Delete Files:
When adding or deleting the source files, the makefile (placed
under the SRC folder) has to be registered first.
‧ Compile, Link and Create:
To compile and link the program, you can use the armmake
under DOS mode to combine the procedures of compiling and
linking and simplify the generating process. However, the
makefile file (placed under SRC folder) should be provided.
Please see the command below:
armmake –a
3. Under WINDOWS Mode:
‧ Add or Delete Files:
When adding or deleting the source files, you can complete the
adding and removing direcly under the ARM Executable Image.
The file will be displayed under DebugRel, Debug, and Release.
‧ Compile, Link and Create:
Here we provide another choice, you can open the default
project UserProg.apj in \SDK\UserProg\SDT to have the
ability to edit, translate,link,and produce the source file. When
compiling, linking, and producing, it's neccesary to use the