1.1 CONST DEFINED IN 7188.H

1.2.1 Functions for COM ports
1.2.2 Functions for LED
1.2.3 Functions for 5-Digit LED
1.2.4 Functions for data storage
1.2.5 Functions for WatchDog Timer
1.2.6 Functions for timer
1.2.7 Functions for stdio
1.2.8 MISC functions

2.1 InstallCom
2.2 InstallCom1
2.3 InstallCom2
2.4 InstallCom3
2.5 InstallCom4
2.6 RestoreCom
2.7 RestoreCom1
2.8 RestoreCom2
2.9 RestoreCom3
2.10 RestoreCom4
2.11 IsCom
2.12 IsCom1
2.13 IsCom2
2.14 IsCom3
2.15 IsCom4
2.16 ReadCom
2.17 ReadCom1
2.18 ReadCom2
2.19 ReadCom3
2.20 ReadCom4
2.21 ToCom
2.22 ToCom1
2.23 ToCom2
2.24 ToCom3
2.25 ToCom4
2.26 ToComBufn
2.27 ToCom1Bufn
2.28 ToCom2Bufn
2.29 ToCom3Bufn
2.30 ToCom4Bufn
2.31 ToComStr
2.32 ToCom1Str
2.33 ToCom2Str
2.34 ToCom3Str
2.35 ToCom4Str
2.36 ClearCom
2.37 ClearCom1
2.38 ClearCom2
2.39 ClearCom3
2.40 ClearCom4
2.41 WaitTransmitOver
2.42 WaitTransmitOver1
2.43 WaitTransmitOver2
2.44 WaitTransmitOver3
2.45 WaitTransmitOver4
2.46 Set485DirToTransmit
2.47 Set485DirToReceive
2.48 IsCom3OutBufEmpty
2.49 IsCom4OutBufEmpty
2.50 DataSizeInCom
2.51 DataSizeInCom1
2.52 DataSizeInCom2
2.53 DataSizeInCom3
2.54 DataSizeInCom4
2.55 SendCmdTo7000
2.56 ReceiveResponseFrom7000
2.57 LedOff
2.58 LedOn
2.59 Init5DigitLed
2.60 Show5DigitLed
2.61 Show5DigitLedWithDot
2.62 Show5DigitLedSeg
2.63 Set5DigitLedTestMode
2.64 Set5DigitLedIntensity
2.65 Disable5DigitLed
2.66 Enable5DigitLed
2.67 ReadNVRAM
2.68 WriteNVRAM
2.69 WriteEEP
2.70 ReadEEP
2.71 EnableEEP
2.72 ProtectEEP
2.73 FlashReadId
2.74 FlashWrite
2.75 FlashErase
2.76 FlashRead
2.77 EnableWDT
2.78 RefreshWDT
2.79 DisableWDT
2.80 IsResetByWatchDogTimer
2.81 IsResetByPowerOff
2.82 TimerOpen
2.83 TimerClose
2.84 TimerResetValue
2.85 TimerReadValue
2.86 StopWatchReset
2.87 StopWatchStart
2.88 StopWatchStop
2.89 StopWatchPause
2.90 StopWatchContinue
2.91 StopWatchReadValue
2.92 CountDownTimerStart
2.93 CountDownTimerReadValue
2.94 InstallUserTimer
2.95 InstallUserTimer1C
2.96 DelayTimeMs
2.97 DelayMs
2.98 Delay
2.99 Delay_1
2.100 getch4
2.101 kbhit4
2.102 ungetch4
2.103 putch4
2.104 InitLib
2.105 GetLibVersion
2.106 Is7188
2.107 ReadInitPin
2.108 hex_to_ascii
2.109 ascii_to_hex
2.110 _MK_FP
2.111 SetDtrActive
2.112 SetDtrInactive
2.113 SetRtsActive
2.114 SetRtsInactive
2.115 printCom
2.116 printCom1
2.117 printCom2
2.118 printCom3
2.119 printCom4
2.120 GetCtsStatus
2.121 GetDsrStatus
 

1 C Language Library

1.1 CONST defined in 7188.H

1.2 Functions By type

1.2.1 Functions for COM ports

1.2.2 Functions for LED

1.2.3 Functions for 5-Digit LED

1.2.4 Functions for data storage

1.2.5 Functions for WatchDog Timer

1.2.6 Functions for timer　

1.2.7 Functions for stdio

1.2.8 MISC functions

2. 7188(D)/DOS library reference

2.1 InstallCom

• Description:

Install the interrupt driven driver for any one of 4 COM port. These driver will handle all hardware details and provide 1K bytes input buffer for each com port. Only COM3/4 has output buffer.

• Declaration:

int InstallCom(int port, unsigned long baud, int data, int parity, int stop);

• Input Parameter:

 

Argument	What it does
port	1/2/3/4 for COM 1/2/3/4
baud	Baudrate, 1200,2400,.... 57600,115200
data	Data bits. 6 or 7 or 8(6 only for COM1/2)
parity	Parity bit. 0=None, 1=EVEN, 2=ODD,3=MARK,4=SPACE(3,4 only for COM1/2)
stop	Stop bit. 1= 1 stop-bit, 2=2 stop-bit(2 only for COM1/2)

• Return Value:

When install success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.2 InstallCom1

• Description:

Install the interrupt driven driver for COM1. This driver will handle all hardware details and provide 1K bytes input buffer. But no output buffer.

• Declaration:

int InstallCom1(unsigned long baud, int data, int parity, int stop);

• Input Parameter:

 

Argument	What it does
baud	Baudrate, 1200,2400,.... 57600,115200
data	Data bits. 6 or 7 or 8
parity	Parity bit. 0=None, 1=EVEN, 2=ODD, 3=MARK, 4=SPACE
stop	Stop bit. 1= 1 stop-bit, 2=2 stop-bit

• Return Value:

When install success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.3 InstallCom2

• Description:

Install the interrupt driven driver for COM2. This driver will handle all hardware details and provide 1K bytes input buffer. But no output buffer.
• Declaration:

int InstallCom2(unsigned long baud, int data, int parity, int stop);
• Input Parameter:

 

Argument	What it does
baud	Baudrate, 1200,2400,.... 57600,115200
data	Data bits. 6 or 7 or 8
parity	Parity bit. 0=None, 1=EVEN, 2=ODD, 3=MARK, 4=SPACE
stop	Stop bit. 1= 1 stop-bit, 2=2 stop-bit

• Return Value:

When install success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.4 InstallCom3

• Description:

Install the interrupt driven driver for COM3. This driver will handle all hardware details and provide 1K bytes input buffer and 256 bytes output buffer. The stop bit always is 1.
• Declaration:

int InstallCom3(unsigned long baud, int data, int parity);
• Input Parameter:

 

Argument	What it does
baud	Baudrate, 1200,2400,.... 57600,115200
data	Data bits. 7 or 8
parity	Parity bit. 0=None, 1=EVEN, 2=ODD

• Return Value:

When install success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.5 InstallCom4

• Description:

Install the interrupt driven driver for COM4. This driver will handle all hardware details and provide 1K bytes input buffer and 256 bytes output buffer. The stop bit always is 1.
• Declaration:

int InstallCom4(unsigned long baud, int data, int parity);
• Input Parameter:

 

Argument	descriptions
baud	Baudrate, 1200,2400,.... 57600,115200
data	Data bits. 7 or 8
parity	Parity bit. 0=None, 1=EVEN, 2=ODD

• Return Value:

When install success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.6 RestoreCom

• Description:

Uninstall the COM port driver, and restore the old driver.
• Declaration:

int RestoreCom(int port);
• Input Parameter:

 

Argument	descriptions
port	1/2/3/4 for COM 1/2/3/4

• Return Value:

When restore success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.7 RestoreCom1

• Description:

Uninstall the COM1 port driver, and restore the old driver.
• Declaration:

int RestoreCom1(void);
• Input Parameter:

None.
• Return Value:

When restore success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.8 RestoreCom2

• Description:

Uninstall the COM2 port driver, and restore the old driver.
• Declaration:

int RestoreCom2(void);
• Input Parameter:

None.
• Return Value:

When restore success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.9 RestoreCom3

• Description:

Uninstall the COM3 port driver, and restore the old driver.
• Declaration:

int RestoreCom3(void);
• Input Parameter:

None.
• Return Value:

When restore success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.10 RestoreCom4

• Description:

Uninstall the COM4 port driver, and restore the old driver.
• Declaration:

int RestoreCom4(void);
• Input Parameter:

None.
• Return Value:

When restore success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.11 IsCom

• Description:

Check is there any data in the comport input queue buffer .
• Declaration:

int IsCom(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4

• Return Value:

QueueIsEmpty QUEUE is empty
QueueIsNotEmptyQUEUE is not empty
Others Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo2.c

2.12 IsCom1

• Description:

Check is there any data in the com1 input queue buffer .
• Declaration:

int IsCom1(void);
• Input Parameter:

None.
• Return Value:

QueueIsEmpty QUEUE is empty
QueueIsNotEmptyQUEUE is not empty
Others Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.13 IsCom2

• Description:

Check is there any data in the com2 input queue buffer .
• Declaration:

int IsCom2(void);
• Input Parameter:

None.
• Return Value:

QueueIsEmpty QUEUE is empty
QueueIsNotEmptyQUEUE is not empty
Others Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.14 IsCom3

• Description:

Check is there any data in the com3 input queue buffer .
• Declaration:

int IsCom3(void);
• Input Parameter:

None.
• Return Value:

QueueIsEmpty QUEUE is empty
QueueIsNotEmptyQUEUE is not empty
Others Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.15 IsCom4

• Description:

Check is there any data in the com4 input queue buffer .
• Declaration:

int IsCom4(void);
• Input Parameter:

None.
• Return Value:

QueueIsEmpty QUEUE is empty
QueueIsNotEmptyQUEUE is not empty
Others Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.16 ReadCom

• Description:

Read one character from the input QUEUE buffer. If the QUEUE buffer is empty will return an ERROR code.
• Declaration:

int ReadCom(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4

• Return Value:

positive: --> character read
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program

None.

2.17 ReadCom1

• Description:

Read one character from COM1 input QUEUE buffer. If the QUEUE buffer is empty will return an ERROR code.
• Declaration:

int ReadCom1(void);
• Input Parameter:

None
• Return Value:

positive: --> character read
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program

None.

2.18 ReadCom2

• Description:

Read one character from COM2 input QUEUE buffer. If the QUEUE buffer is empty will return an ERROR code.
• Declaration:

int ReadCom2(void);
• Input Parameter:

None
• Return Value:

positive: --> character read
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program

None.

2.19 ReadCom3

• Description:

Read one character from COM3 input QUEUE buffer. If the QUEUE buffer is empty will return an ERROR code.
• Declaration:

int ReadCom3(void);
• Input Parameter:

None
• Return Value:

positive: --> character read
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program

None.

2.20 ReadCom4

• Description:

Read one character from COM4 input QUEUE buffer. If the QUEUE buffer is empty will return an ERROR code.
• Declaration:

int ReadCom4(void);
• Input Parameter:

None
• Return Value:

positive: --> character read
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program

None.

2.21 ToCom

• Description:

Transmit one character to Com port.
• Declaration:

int ToCom(int port, char data);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4
data	8-bit character to transmit

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.22 ToCom1

• Description:

Transmit one character to Com1.
• Declaration:

int ToCom1(char data);
• Input Parameter:

 

Argument	Descriptions
data	8-bit character to transmit

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.23 ToCom2

• Description:

Transmit one character to Com2.
• Declaration:

int ToCom2(char data);
• Input Parameter:

 

Argument	Descriptions
data	8-bit character to transmit

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.24 ToCom3

• Description:

Transmit one character to Com3.
• Declaration:

int ToCom3(char data);
• Input Parameter:

 

Argument	Descriptions
data	8-bit character to transmitnone.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.25 ToCom4

• Description:

Transmit one character to Com4.
• Declaration:

int ToCom4(char data);
• Input Parameter:

 

Argument	Descriptions
data	8-bit character to transmit

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None.

2.26 ToComBufn

• Description:

Send n bytes data to comport.
• Declaration:

int ToComBufn(int port, char *buf, int no);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4
buf	Pointer point to where the data stored.
no	The number of data to be sent.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.27 ToCom1Bufn

• Description:

Send n bytes data to COM1.
• Declaration:

int ToCom1Bufn(char *buf, int no);
• Input Parameter:

 

Argument	Descriptions
buf	Pointer point to where the data stored.none.
no	The number of data to be sent.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.28 ToCom2Bufn

• Description:

Send n bytes data to COM2.
• Declaration:

int ToCom2Bufn(char *buf, int no);
• Input Parameter:

 

Argument	Descriptions
buf	Pointer point to where the data stored.
no	The number of data to be sent.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.29 ToCom3Bufn

• Description:

Send n bytes data to COM3.
• Declaration:

int ToCom3Bufn(char *buf, int no);
• Input Parameter:

 

Argument	Descriptions
buf	Pointer point to where the data stored.
no	The number of data to be sent.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.30 ToCom4Bufn

• Description:

Send n bytes data to COM4.
• Declaration:

int ToCom4Bufn(char *buf, int no);
• Input Parameter:

 

Argument	Descriptions
buf	Pointer point to where the data stored.
no	The number of data to be sent.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.31 ToComStr

• Description:

Send a string to comport.
• Declaration:

int ToComStr(int port, char *str);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4none.
str	Pointer point to where the data stored.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.32 ToCom1Str

• Description:

Send a string to COM1.
• Declaration:

int ToCom1Str(char *str);
• Input Parameter:

 

Argument	Descriptions
str	Pointer point to where the data stored.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.33 ToCom2Str

• Description:

Send a string to COM2.
• Declaration:

int ToCom2Str(char *str);
• Input Parameter:

 

Argument	Descriptions
str	Pointer point to where the data stored.none.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.33 ToCom2Str

• Description:

Send a string to COM3.
• Declaration:

int ToCom3Str(char *str);
• Input Parameter:

 

Argument	Descriptions
str	Pointer point to where the data stored.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.35 ToCom4Str

• Description:

Send a string to COM4.
• Declaration:

int ToCom4Str(char *str);
• Input Parameter:

 

Argument	Descriptions
str	Pointer point to where the data stored.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

None

2.36 ClearCom

• Description:

Clear the input QUEUE buffer of comport .
• Declaration:

int ClearCom(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none

2.37 ClearCom1

• Description:

Clear the input QUEUE buffer of COM1 .
• Declaration:

int ClearCom1(void);
• Input Parameter:

none
• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none

2.38 ClearCom2

• Description:

Clear the input QUEUE buffer of COM2 .
• Declaration:

int ClearCom2(void);
• Input Parameter:

none
• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none

2.39 ClearCom3

• Description:

Clear the input QUEUE buffer of COM3 .
• Declaration:

int ClearCom3(void);
• Input Parameter:

none
• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none

2.40 ClearCom4

• Description:

Clear the input QUEUE buffer of COM4 .
• Declaration:

int ClearCom4(void);
• Input Parameter:

none
• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none

2.41 WaitTransmitOver

• Description:

The COM1 & COM2 of 7188 can be used as RS-485 Com port. The RS-485 COM port of 7188 is 2-wire & half-duplex. Therefore the user has to control the direction of RS-485 for transmit/receive data. This function is used to detect the transmit over status, then the program can change the RS-485 from transmit-direction to receive-direction.
• Declaration:

int WaitTransmitOver(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2/3/4 for COM 1/2/3/4

• Return Value:

NoError: --> transmit over
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo3.c

2.42 WaitTransmitOver1

• Description:

The COM1 of 7188 can be used as RS-485 Com port. The RS-485 COM port of 7188 is 2-wire & half-duplex. Therefore the user has to control the direction of RS-485 for transmit/receive data. This function is used to detect the transmit over status, then the program can change the RS-485 from transmit-direction to receive-direction.
• Declaration:

int WaitTransmitOver1(void);
• Input Parameter:

none
• Return Value:

NoError: --> transmit over
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.43 WaitTransmitOver2

• Description:

The COM2 of 7188 is a 2-wire & half-duplex RS-485 Com port. Therefore the user has to control the direction of RS-485 for transmit/receive data. This function is used to detect the transmit over status, then the program can change the RS-485 from transmit-direction to receive-direction.
• Declaration:

int WaitTransmitOver2(void);
• Input Parameter:

none
• Return Value:

NoError: --> transmit over
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.44 WaitTransmitOver3

• Description:

The COM3 of 7188 is a RS-232 port. RS-232 is full-duplex so user need not to control the direction of RS-232. This function is used to detect the transmit over status, then the program can know the data has beed sent out.
• Declaration:

int WaitTransmitOver3(void);
• Input Parameter:

none
• Return Value:

NoError: --> transmit over
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.45 WaitTransmitOver4

• Description:

The COM4 of 7188 is a RS-232 port. RS-232 is full-duplex so user need not to control the direction of RS-232. This function is used to detect the transmit over status, then the program can know the data has beed sent out.
• Declaration:

int WaitTransmitOver4(void);
• Input Parameter:

none
• Return Value:

NoError: --> transmit over
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.46 Set485DirToTransmit

• Description:

The COM1 & COM2 of 7188 can be used as RS-485 Com port. The RS-485 COM port of 7188 is 2-wire & half-duplex. Therefore the user has to control the direction of RS-485 for transmit/receive data. This function is used to change the RS-485 to transmit-direction.
• Declaration:

int Set485DirToTransmit(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2 for COM 1/2

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo3.c

2.47 Set485DirToReceive

• Description:

The COM1 & COM2 of 7188 can be used as RS-485 Com port. The RS-485 COM port of 7188 is 2-wire & half-duplex. Therefore the user has to control the direction of RS-485 for transmit/receive data. This function is used to change the RS-485 to receive-direction.
• Declaration:

int Set485DirToReceive(int port);
• Input Parameter:

 

Argument	Descriptions
port	1/2 for COM1/2none.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo Program:

demo3.c

2.48 IsCom3OutBufEmpty

• Description:

Check COM3 output buffer is empty or not. COM3 also use interrupt driver to send data out, user call ToCom3 just store the data on output buffer, and the interrupt routine will send it out, user can call this function to check if all the data in output buffer is send out.
• Declaration:

int IsCom3OutBufEmpty(void);
• Input Parameter:

None.
• Return Value:

When COM3 output buffer is empty return 1, else return 0
• Demo program:

None.

2.49 IsCom4OutBufEmpty

• Description:

Check COM4 output buffer is empty or not. COM4 also use interrupt driver to send data out, user call ToCom4 just store the data on output buffer, and the interrupt routine will send it out, user can call this function to check if all the data in output buffer is send out.
• Declaration:

int IsCom4OutBufEmpty(void);
• Input Parameter:

None.
• Return Value:

When COM4 output buffer is empty return 1, else return 0
• Demo program:

None.

2.50 DataSizeInCom

• Description:

Get the data number in comport input buffer.
• Declaration:

int DataSizeInCom(int port);
• Input Parameter:

 

Argument	What it does
port	1/2/3/4 for COM1/2/3/4

• Return Value:

the data number in comport input buffer.
• Demo program:

none.

2.51 DataSizeInCom1

• Description:

Get the data number in com1 input buffer.
• Declaration:

int DataSizeInCom1(void);
• Input Parameter:

None.
• Return Value:

the data number in com1 input buffer.
• Demo program:

none.

2.52 DataSizeInCom2

• Description:

Get the data number in com2 input buffer.
• Declaration:

int DataSizeInCom2(void);
• Input Parameter:

None.
• Return Value:

the data number in com2 input buffer.
• Demo program:

none.

2.53 DataSizeInCom3

• Description:

Get the data number in com3 input buffer.
• Declaration:

int DataSizeInCom3(void);
• Input Parameter:

None.
• Return Value:

the data number in com3 input buffer.
• Demo program:

none.

2.54 DataSizeInCom4

• Description:

Get the data number in com4 input buffer.
• Declaration:

int DataSizeInCom4(void);
• Input Parameter:

None.
• Return Value:

the data number in com4 input buffer.
• Demo program:

none.

2.55 SendCmdTo7000

• Description:

This function is use to send command to 7000's modules.
• Declaration:

int SendCmdTo7000(int iPort, unsigned char *cCmd, int iChksum);
• Input Parameter:

 

Argument	What it does
port	1 to 4 for COM1 to COM4
cCmd	The address of the command want to be send.The command need not end with the command terminator 0x0d, This function will auto send 0x0d out after send the command and check sum(if check sum is enable).
iChksum	0: check sum disable, 1: check sum enable. If check sum is set to enable, the function will add 2 bytes check sum after the command.

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo12.c

2.56 ReceiveResponseFrom7000

• Description:

This function use to receive response message from 7000's modules. The response message will end with 0x0D. If check sum is enable, the function will check it and remove checksum from the message. This function also remove the terminator code 0x0d.
• Declaration:

int ReceiveResponseFrom7000(int iPort, unsigned char *cCmd, long lTimeout, int iChksum);
• Input Parameter:

 

Argument	What it does
iPort	1 to 4 for COM1 to COM4
cCmd	The address of buffer to save the received message.
lTimeout	This function will check the comport for receive message, if it check lTimeout times,  and do not get a response message(end with 0x0d), it will return TimeOut error.
iChecksum	0: check sum disable, 1: check sum enable.

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo12.c

2.57 LedOff

• Description:

Turn the red-LED off.
• Syntax:

void LedOff(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

demo1.c

2.58 LedOn

• Description:

Turn the red-LED on.
• Syntax:

void LedOn(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

demo1.c

2.59 Init5DigitLed

• Description:

Initial the hardware of 5-digit LED & blank all digits.
• Declaration:

void Init5DigitLed(void);
• Input Parameter:

None
• Return Value:

None.
• Demo program:

demo1.c

2.60 Show5DigitLed

• Description:

Show a character to 5-digit LED.
• Declaration:

int Show5DigitLed(int pos, int value);
• Input Parameter:

 

Argument	What it does
pos	1-5 for position 1-5(from left to right)
value	0 - 9 for show '0'-'9' 10 show 'A' 11 show 'b' 12 show 'c' 13 show 'd' 14 show 'E' 15 show 'F' 16 show ' '(blank or space) 17 show '-' 18 show '.'(dot)

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo1.c , qc4.c

2.61 Show5DigitLedWithDot

• Description:

Show a character to 5-digit LED. Show5DigitLedWithDot show the same character with Show5DigitLed and also show the dot.
• Declaration:

int Show5DigitLedWithDot(int pos, int data);
• Input Parameter:

 

Argument	What it does
pos	1-5 for position 1-5(from left to right)
value	0 - 9 for show '0.'-'9.' 10 show 'A.' 11 show 'b.' 12 show 'c.' 13 show 'd.' 14 show 'E.' 15 show 'F.' 16 show ' .'(blank or space) 17 show '-.' 18 show '.'(dot)

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

qc4.c

2.62 Show5DigitLedSeg

• Description:

Show a seven-segment pattern to 5-digit LED. Use this function user can control every segment and the dot of 5-digit LED.
• Declaration:

int Show5DigitLedSeg(int pos, unsigned char data);
• Input Parameter:

 

Argument	What it does
pos	1-5 for position 1-5(from left to right)
value	Each bit of value control one segment of 7-segment led and the Dot. (see the left picture.) the bit is 1 will let the segment light, the bit is 0 will dark the segment. For example we want to show "1.", so must light segment 4,5,and 7, the value must be 0xB0.

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

qc4.c

2.63 Set5DigitLedTestMode

• Description:

This function can set 5-Digit LED into test mode(mode=1), all segment will light, and can set back to normal mode(mode=0).
• Declaration:

void Set5DigitLedTestMode(int mode);
• Input Parameter:

 

Argument	What it does
mode	0: normal mode. 1: set to test mode. On test mode all the segment will light.

• Return Value:

None
• Demo program:

qc4.c

2.64 Set5DigitLedIntensity

• Description:

This function can set the intensity of 5-Digit LED.
• Declaration:

void Set5DigitLedIntensity(int mode);
• Input Parameter:

 

Argument	What it does
mode	0-15. Whem call Init5DigitLed the intensity will set to 7. Mode=15 is the most bright, mode=0 is the most dark.

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

qc4.c

2.65 Disable5DigitLed

• Description:

Call Disable5DigitLed will blank all 5-Digit LED. Must call Enable5Digitled to back to normal mode.
• Declaration:

void Disable5DigitLed(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

QC4.c

2.66 Enable5DigitLed

• Description:

After call Disable5DigitLed must call Enable5DigitLed if want set the 5-Digit LED back to normal mode.
• Declaration:

void Enable5DigitLed(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

QC4.C

2.67 ReadNVRAM

• Description:

Read the content of the NVRAM. Total size of NVRAM is 31 bytes.
• Declaration:

int ReadNVRAM(int addr);
• Input Parameter:

 

Argument	What it does
addr	0 to 30.

• Return Value:

positive: --> 8-bit NVRAM data
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo5.c

2.68 WriteNVRAM

• Description:

Write one byte data to NVRAM.
• Declaration:

int WriteNVRAM(int addr, int data);
• Input Parameter:

 

Argument	What it does
addr	0 to 30
data	0 to 255(8-bit data)

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo5.c

2.69 WriteEEP

• Description:

Write one byte data to EEPROM. EEPROM has 8 blocks, every block has 256 bytes, so total size is 2K bytes.
• Declaration:

int WriteEEP(int block, int addr, int data);
• Input Parameter:

 

Argument	What it does
block	0 to 7(total 8 blocks)
addr	0 to 255(every block has 256 bytes).
data	0 to 255(8-bit data)

• Return Value:

NoError: --> OK
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo6.c

2.70 ReadEEP

• Description:

Read one byte data from EEPROM.
• Declaration:

int ReadEEP(int block, int addr);
• Input Parameter:

 

Argument	What it does
block	0 to 7(total 8 blocks)
addr	0 to 255(every block has 256 bytes)

• Return Value:

Positive : -->8-bit data read from EEPROM
Others: --> Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo6.c

2.71 EnableEEP

• Description:

Enable the EEPROM for the write operation. The EEPROM is in the write-protect state since the first power on. The application program has to enable the EEPROM before any write operation. The EEPROM can be read in any condition.
• Declaration:

void EnableEEP(void);
• Input Parameter:

none
• Return Value:

None.
• Demo program:

demo6.c
• Example:

EnableEEP(); /* enable before write to EEPROM */
WriteEEP(block,addr,data);
ProtectEEP(); /* protect EEPROM after write operation */

2.72 ProtectEEP

• Description:

Protect the EEPROM to inhabit the write operation. The EEPROM is in the write-protect state since the first power on. The application program has to enable the EEPROM before any write operation. The EEPROM can be read in any condition.
• Declaration:

void ProtectEEP(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

demo6.c

2.73 FlashReadId

• Description:

Use to check flash memory size. Is7188 will call this function to decide the flash memory size is 256K or 512K.
• Declaration:

int FlashReadId(void);
• Input Parameter:

None.
• Return Value:

High byte return the flash type, and low byte return the manufacture number. 256K type will return 0xb001, 512K type will return 0xA401. The manufacture number 1 is AMD.
• Demo program:

None

2.74 FlashWrite

• Description:

When want save data to Flash memory just call this function and give the address( segment and offset ) and data. Every time call FlashWrite just write one byte data to Flash memory. The data on flash memory only can be write from 1 to 0, if current value is 0xFF, that is every bit is 1, so it can be write to any value, if current value is 0x01 , only the bit 0 is 1, so only can write bit 0 to 0, that is only can write 0 to it, if want write other value to it, must erase flash memory first, erase flash memory will erase all the data bit to 1.
• Declaration:

int FlashWrite(unsigned int seg, unsigned int offset, char data);
• Input Parameter:

 

Argument	What it does
seg	seg can be 0xc000 or 0xd000 od 0xe000 for 256K type, and can be 0x8000 to 0xe000 for 512K type.
offset	Range is 0 to 0xFFFF
data	Range is 0 to 0xFF

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

torom.c

2.75 FlashErase

• Description:

FlashErase is used to erase a sector of flash memory. The sector size of Flash memory is 64K bytes, just map to a segment of 7188(D). The 256K type 7188 has three segments can be erase, these segments are 0xc000, 0xd000, 0xe000. The segment 0xF000 has bios and ROM-DOS so user must not erase it. The 512K type has the segments from 0x8000 to 0xe000 can be erased. In generally the first segment of Flash memory is used by the ROM-DISK, so only when user want to download the new ROM-DISK image file will erase the first segment, for example TOROM.EXE will erase the first segment of Flash memory. After erase all the data on that Flash sector (segment) will be 0xFF, and then it can be write to any other value. When the value is write to another value, it must be erase again for write another value to it.
• Declaration:

int FlashErase(unsigned int seg);
• Input Parameter:

 

Argument	What it does
seg	seg can be 0xc000 or 0xd000 od 0xe000 for 256K type, and can be 0x8000 to 0xe000 for 512K type.

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

torom.c

2.76 FlashRead

• Description:

FalshRead is used to read one byte data from Flash Memory. This function is the same as the function peekb of TC(BC++). FlashRead also can read the memory locate on SRAM.
• Declaration:

int FlashRead(unsigned int seg, unsigned int offset);
• Input Parameter:

 

Argument	What it does
seg	Segment of flash memory
offset	Offset of flash memory

• Return Value:

Return the byte at the memory location addressed by seg:offset .
• Demo program:

None.

2.77 EnableWDT

• Description:

This function will enable the watchdog.
The watchdog timer is fixed in 1.6 sec. If the watchdog is enable, the application program should refresh the watchdog timer before the 1.6 sec timer up.
If the watchdog timer is up, the 7188 will be reset by the hardware circuit.
• Declaration:

void EnableWDT(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

demo7.c

2.78 RefreshWDT

• Description:

This function is used to refresh the watchdog.
The watchdog timer is fixed in 1.6 sec. If the watchdog is enable, the application program should refresh the watchdog timer before the 1.6 sec timer up.
If the watchdog timer is up, the 7188 will be reset by the hardware circuit.
• Declaration:

void RefreshWDT(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

None.

2.79 DisableWDT

• Description:

This function can disable the watchdog.
The watchdog timer is fixed in 1.6 sec. If the watchdog is enable, the application program should refresh the watchdog timer before the 1.6 sec timer up.
If the watchdog timer is up, the 7188(D)/DOS will be reset by the hardware circuit.
• Declaration:

void DisableWDT(void);
• Input Parameter:

None.
• Return Value:

None.
• Demo program:

demo7.c

2.80 IsResetByWatchDogTimer

• Description:

To check if 7188(D)/DOS is reset by. The function is used when 7188(D)/DOS is reset and the program is excute again, to check if the reset is according to WatchDog Timer power off or other reasons(reset by power off or just the program excute a far jmp to 0xFFFF:0000 or call int 19H).
• Declaration:

int IsResetByWatchDogTimer(void);
• Input Parameter:

None.
• Return Value:

Return NoError (0) When 7188 is not reset by WatchDig Timer since last time call IsResetByWatchDogTimer.
Return 1 When 7188 is reset by WatchDog Timer since last time call IsResetByWatchDogTimer. If call IsResetByWatchDogTimer again ,it will return 0.
• Demo program:

None.

2.81 IsResetByPowerOff

• Description:

To check if 7188(D)/DOS is reset by power off. The function is used when 7188(D)/DOS is reset and the program is excute again, to check if the reset is according to power off or other reasons(reset by watchdog timer or just the program excute a far jmp to 0xFFFF:0000 or call int 19H).
• Declaration:

int IsResetByPowerOff(void);
• Input Parameter:

None.
• Return Value:

Return NoError (0) When 7188 is not reset by power off since last time call IsResetByPowerOff.
Return 1 When 7188 is reset by power off since last time call IsResetByPowerOff. If call IsResetByPowerOff again ,it will return 0.
• Demo program:

None.

2.82 TimerOpen

• Description:

Install the timer function of 7188(D)/DOS. It support one timer ticks, 8 stopwatch timer and 8 countdown timer. Before use these timer functions must call TimerOpen.
• Declaration:

int TimerOpen(void);
• Input Parameter:

none.
• Return Value:

When install success return NoError.
Return 1 if timer function is already installed
• Demo program:

demo90.C.

2.83 TimerClose

• Description:

Uninstall the timer function.
• Declaration:

int TimerClose(void);
• Input Parameter:

none.
• Return Value:

Always return NoError.
• Demo program:

demo90.C

2.84 TimerResetValue

• Description:

Reset the timer tick value of timer to 0.
• Declaration:

void TimerResetValue(void);
• Input Parameter:

none.
• Return Value:

none
• Demo program:

demo90.c

2.85 TimerReadValue

• Description:

Read the timer ticks, unit is ms. Before call this function must call TimerOpen to install Timer driver.
• Declaration:

unsigned long TimerReadValue(void);
• Input Parameter:

none.
• Return Value:

Return the current value of timer ticks
• Demo program:

demo90.c

2.86 StopWatchReset

• Description:

Reset the stopwatch value. The timer driver support 8 StopWatch.
• Declaration:

int StopWatchReset(int channel);
• Input Parameter:

 

Argument	What it does
channel	The range is 0-7

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.87 StopWatchStart

• Description:

Set the StopWatch start to count time from 0. After this setting, the StopWatch timer will increment 1 every 1 ms.
• Declaration:

int StopWatchStart(int channel);
• Input Parameter:

 

Argument	What it does
channel	The range is 0-7

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

demo92.c

2.88 StopWatchStop

• Description:

After call StopWatchStart, when need not to use it,call this function to stop use the StopWatch Timer.
• Declaration:

int StopWatchStop(int channel);
• Input Parameter:

 

Argument	What it does
channel	The range is 0-7

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.89 StopWatchPause

• Description:

Pause the StopWatch timer.
• Declaration:

int StopWatchPause(int channel);
• Input Parameter:

 

Argument	What it does
channel	The range is 0-7

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.

2.90 StopWatchContinue

• Description:

After call StopWatchPause, use this function to continue the StopWatch Timer.
• Declaration:

int StopWatchContinue(int channel);
• Input Parameter:

 

Argument	What it does
channel	The range is 0-7

• Return Value:

When success return NoError.
Others: return Error code(negative value, Refer to Sec. 1.1)
• Demo program:

none.