sub_get_product_id

 Top  Previous  Next
Got to SUB-20 page

Synopsis

int sub_lcd_write( sub_handle hndl, char* str );

 

This function will work only on SUB-20 configurations with LCD.

Characters from *str are written to the LCD beginning from the current LCD position. Special characters and sequences listed below are used to format LCD output and control current position.

 

ANSI C notation

Hex value

Description

Example

\f

0x0C

Clear LCD and go to first position

"\fHello"

\r

0x0D

Go to first position

"\r0123"

\n

0x0A

Go to next string

"\rHello\nWorld"

\eXY

0x1B X Y

Go to position X,Y

"\e00Hello\e01World"

 

Every string written to LCD will be space padded till the end of the string.

Parameters

•*str - LCD string

Return value

On success function returns 0. If LCD is not supported function will return "Feature not supported".

Example

sub_lcd_write( hndl, "\fHello\nWorld" );

Hello   
World   

sub_lcd_write( hndl, "\f\e20Hello\e21World" );

  Hello 
  World 

sub_lcd_write( hndl, "\r1\n2" );

1       
2       

sub_lcd_write( hndl, "\fT:\nR:" );
sub_lcd_write( hndl, "\e20abc\e21def" );

 

T:abc   
R:def   

Compatibility

•Required firmware version > 0.0.4
•Required DLL version > 0.1.12.2