Unitech PT600 User manual

PT600 Portable Terminal
Programming Reference Guide
Document number: 3506000120

Table of Contents
Chapter 1 BIOS and System Functions
1.1 Interrupt Vector Assignments for I/Os......................................1
1.2 Display Font Functions (INT 09H)...........................................1
1.3 Kermit Server Function (INT 0FH)..........................................4
1.4 LCD Control Functions (INT 10H...........................................5
1.5 System Functions (INT 21H) ...................................................9
1.6 Power Management Function (INT 22H) .................................47
1.7 Beeper Control (INT 31H) ......................................................48
1.8 RS232 Control Functions (INT 33H).......................................48
Chapter 2 Multipoint Communication
2.1 Multipoint Communication Protocol..........................................53
2.2 Data Communication in Multipoint Protocol..............................55
2.3 File Communication in Multipoint Protocol................................55
2.4 Host Commands......................................................................56

Chapter 1 BIOS and System Functions
The PT600 operating system supports DOS/BIOS function calls that a programmer
can access when developing an application for the portable.
1.1 Interrupt Vector Assignment for I/Os
Vector BIOS Function
09 H Display Font
0F H Kermit Server
10 H LCD Control
21 H System Functions
22 H Power Manager
31 H Beeper Control
33 H RS232 Control
1.2 Display Font Functions ( INT 09H )
00 Select Large Font
Entry Parameter: AH = 0/1 ; select 8*16-dot character font (4
lines * 16
; columns display)
Return Value: None
Example:
void TL_font(int status)
{
regs.h.ah = (unsigned char)status;
int86(0x09,&regs,&regs);
}
01 Select Small Font
Entry Parameter: AH = 1 ; select 6*8-dot character font (8 lines * 20
columns display)
Return Value: None
Example:
void TL_font(int status)

{
regs.h.ah = (unsigned char)status;
int86(0x09,&regs,&regs);
}
02 Set Font Type
3Entry Parameter: AH= 2
4AL= 0/1 ; set to large/small font
5Return Value: None
Example:
void TL_font(int status)
{
regs.h.ah = (unsigned char)status;
regs.h.al= 2;
int86(0x09,&regs,&regs);
}
03 Get Font Type
Entry Parameter: AH= 3
Return Value: AL= 0/1 ; large/small font
Example
int TL_get_font_type()
{
regs.h.ah = 3;
int86(0x09,&regs,&regs);
return(regs.h.al);
}
04 Set User-Defined Font for All Characters
Entry Parameter: AH= 4
AL= 0/1 ; large/small font
DS:DX ; pointer to the buffer with font data
; ( for large font: buffer size = 16*256 =4096
bytes
; for small font: buffer size = 6*256 =1536
bytes )
Return Value: None
Example

void TL_change_all_ASCII_font(int type,unsigned char *str)
{
regs.h.ah=4;
regs.h.al=(unsigned char)type;
segregs.ds = FP_SEG(str);
regs.x.dx = FP_OFF(str);
int86x(0x9,&regs,&regs,&segregs);
}
05 Get Font Data for All Characters
Entry Parameter: AH= 5
AL= 0/1 ; large/small font
DS:DX ; pointer to the buffer
; ( for large font: buffer size = 16*256 =4096
bytes
; for small font: buffer size = 6*256 =1536
bytes )
Return Value: Font data in the buffer
Example:
void TL_get_all_ASCII_font(int type,unsigned char *str)
{
regs.h.ah=5;
regs.h.al=(unsigned char)type;
segregs.ds = FP_SEG(str);
regs.x.dx = FP_OFF(str);
int86x(0x9,&regs,&regs,&segregs);
}
06 Set User-Defined Font for One Character
Entry Parameter: AH= 6
AL= 0/1 ; large/small font
CL =0 -255 ; character
DS:DX ; pointer to the buffer with font data
; ( for large font: buffer size = 16 bytes
; for small font: buffer size = 6 bytes )
6Return Value: None
Example:
void TL_change_one_ASCII_font(int type,int ascii_code,unsigned char
*str)

{
regs.h.ah=6;
regs.h.al=(unsigned char)type;
regs.h.cl=(unsigned char)ascii_code;
segregs.ds = FP_SEG(str);
regs.x.dx = FP_OFF(str);
int86x(0x9,&regs,&regs,&segregs);
}
07 Get Font Data for One Characters
Entry Parameter: AH= 7
AL= 0/1 ; large/small font
CL =0 -255 ; character
DS:DX ; pointer to the buffer
; ( for large font: buffer size = 16 bytes
; for small font: buffer size = 6 bytes )
Return Value: Font data in the buffer
Example:
void TL_get_one_ASCII_font(int type,int ascii_code,unsigned char *str)
{
regs.h.ah=7;
regs.h.al=(unsigned char)type;
regs.h.cl=(unsigned char)ascii_code;
segregs.ds = FP_SEG(str);
regs.x.dx = FP_OFF(str);
int86x(0x9,&regs,&regs,&segregs);
}
1.3 Kermit Server Function ( INT 0FH )
Entry Parameter: None
Return Value: None
When INT 0FH is called in user application, PT600 will enter Kermit server.
Pressing [CMD] key then [Exit] key to leave it and return to user application.
Example :
void TC_kermit_mode()
{
int86(0x0F,&regs,&regs);

}

1.4 LCD Control Functions ( INT 10H )
00 Clear LCD Screen
Entry Parameter: AH = 0
Return Value: None
Example:
void TL_clrscr()
{
regs.h.ah= 0;
int86(0x10,&regs,&regs);
}
01 Enable/Disable Screen Scroll
Entry Parameter: AH = 1
AL = 0/1 ; disable/enable screen scroll
Return Value: None
Example:
void TL_scroll(int status)
{
regs.h.ah = 1;
regs.h.al = (unsigned char)status;
int86(0x10,&regs,&regs);
}
02 Set Cursor Position
Entry Parameter: AH = 2
DH = Row
DL = Column PT6006x8 8x16
Row 0~7 0~3
Column
0~15 0~12
Return Value: None
Example :
void TL_gotoxy(int x,int y)
{

regs.h.ah = 2;
regs.h.dh = (unsigned char)y;
regs.h.dl = (unsigned char)x;
int86(0x10,&regs,&regs);
}
03 Get Cursor Position
Entry Parameter: AH = 3;
Return Value: DH = Row
DL = Column
Example :
void TL_getxy(int *x,int *y)
{
regs.h.ah = 3;
int86(0x10,&regs,&regs);
*y = regs.h.dh;
*x = regs.h.dl;
}
04 Display 16x16 Bitmap
Entry Parameter: AH = 4
DH = Row
DL = Column
DS:BX ; pointer to bitmap ( 32-bytes pattern data )
Return Value: None
Note: This function is available only in large font.
Example :
void TL_display_16x16_location(int x,int y,unsigned char *str)
{
regs.h.ah=4;
regs.h.dh=(unsigned char)y;
regs.h.dl=(unsigned char)x;
segregs.ds = FP_SEG(str);
regs.x.bx = FP_OFF(str);
int86x(0x10,&regs,&regs,&segregs);
}

Sample C program to display 16x16 graphic pattern.
1
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
content FF FF 3E 1C C9 E3 F7 FF FF FF FF FF FF FF FF FF
7 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
6 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
Bit 5 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
Count 4 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
3 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
2 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
1 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
0 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
7
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
6 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
Bit 5 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
Count 4 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
3 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
2 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
1 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
0 ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦
Byte
count 17
18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
Content FF FF FF FE FC F9 F3 E7 CF CF E7 F3 F9 F3 E7 CF
#include <stdio.h>
#include <stdlib.h>
#include <dos.h>
#include <conio.h>
unsigned char logo[32]={0xFF,0xFF,0x3E,0x1C,0xC9,0xE3,0xF7,0xFF,
0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,
0xFF,0xFF,0xFF,0xFE,0xFC,0xF9,0xF3,0xE7,
0xCF,0xCF,0xE7,0xF3,0xF9,0xF3,0xE7,0xCF};
void main()
{
void far *buff;
union REGS regs;
struct SREGS sregs;
regs.h.ah=0;
int86(0x10, &regs, &regs); /* clear screen */