AMOLED Datasheet

Datasheet & Application Note | Rev.A | July 2010 Release

AIS CUBE 2.83” AMOLED DISPLAY

TECHNICAL OVERVIEW

Diagonal Size 2.83”

Driving Mode Active Matrix

Colour Mode 16bit RGB 5/6/5 262K Colours

Interface Mode 16bit RGB Interface

(One Transfer per Pixel)

Driver IC S6E63D6

Resolution 320 x RGB x 240

Pixel Pitch 0.06 x 0.18 mm

Active Area 43.2 x 57.6 mm

Outline Area 49.1 x 67.3 mm

Thickness 1.75mm (Typical)

Weight 16g

Touch Screen 4-wire Resistive

Pin Name Description

1 AR_VDD Positive Voltage for OLED (+4.6V)

2 AR_VSS Negative Voltage for OLED (-4.6V)

3 VCI Power Supply for Analogue Circuit (2.5V-3.3V)

4 VCI1 A reference voltage for 1st booster(Connect a 1uF/10v capacitance to Gnd)

5 GND Ground

6 C12M External capacitance connect pin between C12M and C12P (1uF/10V)

7 C12P

8 C11M External capacitance connect pin between C11M and C11P

9 C11P

10 VLOUT1 1st booster output pin. (1uF/10V)

11 C31P External capacitance connect pin between C31M and C31P (1uF/10V)

12 C31M

13 C32P External capacitance connect pin between C32M and C32P (1uF/10V)

14 C32M

15 VLOUT3 3rd booster output pin. (1uF/16V)

16 VLOUT2 2nd booster output pin. (1uF/16V)

17 C21P External capacitance connect pin between C21M and C21P. (1uF/10V)

18 C21M

19 VGS A reference level for the grayscale voltage generation circuit. (Connect to Gnd)

20 IOVCC I/O power supply

21 SPB Select the CPU interface mode.

(0=parallel interface 1=serial interface)

22 ID_MIB Select the CPU type

(0=Intel 80x-system 1=Motorola 68x-system)

23 DB17

Bi-Directional Data bus.

BlazingCore Usage: 16bit CPU Interface

Connection Pins: DB17 - DB10, DB8 - DB1

24 DB16

25 DB15

26 DB14

27 DB13

28 DB12

29 DB11

30 DB10

31 DB9

32 DB8

33 DB7

34 DB6

35 DB5

36 DB4

37 DB3

38 DB2

39 DB1

40 DB0

oled pin assignment

41 VSYNC

Frame-synchronizing signal.

(VSPL=0 Low active, VSPL=1 High active)

FIX this pin at VSS level if the pin is not used

42 HSYNC

Line-synchronizing signal.

(HSPL=0 Low active, HSPL=1 High active)

FIX this pin at VSS level if the pin is not used

43 DOTCLK

Input pin for clock signal of external interface: dot clock.

DPL=0 Display data is fetched at DOTCLK’s rising edge

DPL=1 Display data is fetched at DOTCLK’s falling edge

Fix this pin at VSS level if the pin is not used.

44 ENABLE

Data enable signal pin for RGB interface.

EPL ENABLE GRAM write GRAM address

0 0 Valid Updated

0 1 Invalid Held

1 0 Invalid Held

1 1 Valid Updated

45 SDI For a serial peripheral interface (SPI), input data is fetched at the rising edge of the SCL signal,

Fix SDI pin at VSS level if the pin is not used.

46 SDO For a serial peripheral interface (SPI), serves as the serial data output pin (SDO), Successive bits

are output at the falling edge of the SCL signal.

47 CSB

(CS/NCS)

Chip select signal input pin.

0= driver IC is selected and can be accessed.

1= driver IC is not selected and cannot be accessed.

48 RW_WRB

(SCL)

Pin Function CPU Type Pin Description

RW 68-System Read/Write operation selection pin

0=write 1=read

WRB 80-System Write strobe signal (Input pin)

Data is fetched at the rising edge.

SCL SPI The synchronous clock signal

49 RS

Register select pin.

0=Index/status, 1=instruction parameter, GRAM data

Must be fixed at VDD3 level when not used.

50 E_RDB

Pin Function CPU Type Pin Description

E 68-System Read/Write operation enable pin

RDB 80-system Read strobe signal.

Read out data at the low level

When SPI mode is selected, fix this pin at VDD3 level

51 RESETB Reset pin initializes the IC when low. Should be reset after power-on.

52 MVDD Internal power for RAM. Connect a capacitance (1u/10v) to Gnd.

53 VREG1OUT A reference level for the grayscale voltage. Connect a capacitance (1u/10v) to Gnd.

54 VCI Power supply for analogue circuit(2.5v~3.3v)

55 VGH The positive voltage used in the gate driver. Connect a capacitance(1u/10v) to Gnd.

56 VGL The negative voltage used in the gate driver. Connect a capacitance(1u/10v) to Gnd.

57 GND Ground

58 X- (Touch Screen)

59 Y- (Touch Screen)

60 X+ (Touch Screen)

61 Y+ (Touch Screen)

oled pin assignment

Electrical characteristics

Dc characteristics

Electrical characteristics

Dc characteristics (Cont’d)

Absolute maximum ratings

Environmental absolute ratings

Item Symbol Temperature

Unit Remarks Min. Max.

Storage Temperature TST -40 +80 ºC

The storage duration for both

critical temperatures (-40 & 80 ºC)

meet reliability test criteria.

Operating Ambient

Temperature TOP -20 +60 ºC

The operating duration for both

critical temperatures (-20 & 60 ºC)

meet reliability test criteria.

electrical absolute ratings

Item Symbol Value Unit

Power Supply Voltage 1 AR_Vdd +4.6V ± 0.05 V

Power Supply Voltage 2 AR_Vss -4.4V ± 0.1 V

Power Supply Voltage 3 VCI +2.5 ~ +3.3 V

Power Supply Voltage 4 VDD3 (IOVcc) +1.65 ~ +3.3 V

NoteNoteNoteNote: Stresses above those listed under “Absolute Maximum Ratings” may cause permanent damage to the

device. This is a stress rating only and functional operation of the device at those or any other conditions above

those indicated in the operation listings of this specification is not implied. Exposure to maximum rating

conditions for extended periods may affect device reliability.

Technical drawing

(0,0)

X Axis

Y Axis

oled ORIENTATION

Vertical Horizontal (Default)

Features The OLED interface board comes with the following onboard features:

2.83” Active Matrix OLED Screen with Touch Screen

oled interface board

+/- 5V Regulated DC Power Supply for the OLED

Power Indicator

External Memory Card Support (MMC)

Light Dependent Resistor (LDR)

3-Axis Accelerometer

pinout

Board layout

oled interface board

16BIT

Parallel

BUS

LINE

schematics

The following image illustrates an overview of the full basic setup of what will be needed if using just the

OLED + BCore100 Platform.

*Detailed information of the boards will be covered on the next page.

Interfacing to bcore100

JP1

JP3

JP4

JP2

JP5

LED

1

BU

TT

ON

1

LED

2

BU

TT

ON

2

Re

set

Bu

tto

n

PO

RT

1P

OR

T4

PO

RT

5PO

RT

6P

OR

T3

PO

RT

2

AD

C

PO

RT

7

SC

K2

A

SD

I2A

SD

O2

A

SD

_D

TE

C

CS

_S

D

GN

D

The BCore Series boards are designed to be entirely stackable. You will find that interfacing the OLED board with the BCore100

Board is just a matter stacking the two boards with the use of standard header pins, which at the same time serves as I/O Bus

and Data Connection. Pins should match up as above. Recommended stacking method as shown above, with the BCore100 &

OLED Display both facing outwards.

Interfacing to bcore100

Board stack pin comparison

Pins BCore100 (REV.B) OLED

1 GIO JST1

PORT0

-

2 GIO -

3 GIO JST2

-

4 GIO -

5 GIO JST3

-

6 GIO -

7 GIO JST4

-

8 GIO -

9 GIO

PORT1

-

10 GIO -

11 GIO -

12 GIO -

13 GIO -

14 GIO -

15 GIO -

16 GIO -

17 GIO ADC

PORT2

-

18 GIO ADC -

19 GIO ADC -

20 GIO ADC -

21 GIO ADC -

22 GIO ADC -

23 GIO ADC -

24 GIO ADC -

25 GIO ADC

PORT3

LDR

26 GIO ADC z

Accelerometer 27 GIO ADC Y

28 GIO ADC X

29 GIO ADC X-

Touch

Screen

30 GIO ADC Y-

31 GIO ADC X+

32 GIO ADC Y+

33 GIO

PORT4

D8

16bit

Data

Bus Line

34 GIO D7

35 GIO D6

36 GIO D5

37 GIO D4

38 GIO D3

39 GIO D2

40 GIO (SPI1) SDO1 D1

41 GIO

PORT5

D10

42 GIO (SPI1) SS1 D11

43 GIO (SPI1) SCK1 D12

44 GIO D13

45 GIO D14

46 GIO D15

47 GIO (SPIx) SS1A D16

48 GIO (SPIx)SCK1A D17

Pins BCore100 (REV.B) OLED

49 GIO

PORT6

RESETB

50 GIO E-RDB

51 GIO RS

52 GIO RW_WRB

53 GIO CSB

54 GIO

PORT7

-

55 GIO -

56 GIO -

57 GIO -

58 GIO -

59 GIO -

60 LED1 -

61 BUTTON1 -

62 GIO -

63 GIO -

64 GIO -

65 GIO -

66 LED2 -

67 BUTTON2 -

BlazingCore oLEDoLEDoLEDoLED command REFERENCE

OLED

OLED command reference

The following pages list the members in the library available to interface with the OLED Display. Ready methods

like printing text to screen, drawing primitives or even placing bitmaps to the screen are available for immediate

usage. Examples of use are al

OLED Part of the BCoreIDE library consists of optimized methods to control the OLED natively to ensure efficiency and

speed of data transfer to the OLED Driver.

Method

Accel

Background

Clear()

Cursor

Draw

FontType

Foreground

GRAM

Init()

LDR

Orientation

Print

ReadRegister

SetColour

Touch

WriteRegister

¹ Please refer to S6E63D6 Driver IC Datasheet for full register listing.

.accel Provides Access to methods for reading values from the onboard accelerometer.

Member

X

Y

Z

<variable>

Code:

01.

02.

03.

04.

05.

06.

07.

08.

09.

10.

11.

12.




usage. Examples of use are al

OLED Part of the BCoreIDE library consists of optimized methods to control the OLED natively to ensure efficiency and


Method

Accel

Background

Clear()

Cursor

Draw

FontType

Foreground

GRAM

Init()

LDR

Orientation

Print

ReadRegister

SetColour

Touch

WriteRegister

Please refer to S6E63D6 Driver IC Datasheet for full register listing.

Provides Access to methods for reading values from the onboard accelerometer.

Member Description

Get X axis reading

Get Y axis reading

Get Z axis reading

variable> = OLED.Accel.X()

Public X,Y,Z

Public Sub

Do

Loop

End Sub




usage. Examples of use are also included.

Part of the BCoreIDE library consists of optimized methods to control the OLED natively to ensure efficiency and


Description

Provides Access to reading values from the onboard accelerometer

Set Background colour

Clears the screen

Get or Set the Cursor Position

Graphic library for drawing Primitives and Bitmaps to Screen *

Set the Font Size

Set Foreground colour

Provides Read

Does the necessary one

Provides access to

Set the orientation of the screen to portrait or landscape

Print text to OLED

Provides read abilities to the OLED driver (

Set foreground and background colours

Provides access to reading values from the touch screen

WriteRegister Provides write abilities to the OLED driver (



Description

Get X axis reading

Get Y axis reading

Get Z axis reading

= OLED.Accel.X()

X,Y,Z as Integer

Sub Main()

Do

X = OLED.Accel.X

Y = OLED.Accel.Y

Z = OLED.Accel.Z

Debug

Delay

Loop




so included.



Description


Set Background colour

Clears the screen



Set the Font Size

Set Foreground colour

Provides Read-Only Access to the Graphics RAM

Does the necessary one-time initialization of the OLED with a specified colour

Provides access to reading values from the onboard Light Dependent Resistor (LDR)


Print text to OLED




Provides write abilities to the OLED driver (



Integer

OLED.Accel.X

OLED.Accel.Y

OLED.Accel.Z

Debug.Print Cstr

Delay(200)







Only Access to the Graphics RAM

time initialization of the OLED with a specified colour

reading values from the onboard Light Dependent Resistor (LDR)








OLED.Accel.X()

OLED.Accel.Y()

OLED.Accel.Z()

Cstr(X);" ";Cstr






Only Access to the Graphics RAM




Provides read abilities to the OLED driver (S6E63D6) registers


Provides write abilities to the OLED driver (S6E63D6) registers


Cstr(Y);" ";Cstr





Graphic library for drawing Primitives and Bitmaps to Screen *refer to




registers¹


registers¹

Cstr(Z)




refer to subtopic for details.






subtopic for details.

OLED

OLED command Reference

.background Set the background colour of the OLED.

OLED.Background.COLOUR

Code:

01.

02.

03.

04.

05.

06.

07.

.Clear() Clears the screen.

OLED.Clear

.cursor Get or Set the Cursor Position

Member

X

Y

Home

To set the cursor position;OLED.Cursor

OLED.Cursor

OLED.Cursor

Value: Any literal, constant, or expression

To get the cursor value = OLED.Cursor

value = OLED.Cursor

.DRAW Uses inbuilt native libraries in BCore to draw primitives and bitmaps on to the screen.

All primitives are drawn using the specified foreground colour.

Member

Point

Points

Line

Lines

Rectangle

FillRectangle

Circle

BitmapFromDFlash

BitmapFromMemCard


.background Set the background colour of the OLED.


'CODE1

Public Sub

'INIT THE OLED AND SET THE BACKGROUND COLOUR TO BLACK

OLED.Init

‘CHANGE THE BACKGROUND COLOUR TO FUSCHIA

OLED.Background.Colour =

End Sub

Clears the screen.

OLED.Clear()

.cursor Get or Set the Cursor Position

Member Description

Set X coordinate of cursor

Set Y coordinate of cursor

Sets the cursor to (0,0) position

To set the cursor position;OLED.Cursor.X = value

OLED.Cursor.Y = value

OLED.Cursor.Home()

Any literal, constant, or expression

To get the cursor position;= OLED.Cursor.X

= OLED.Cursor.Y

Uses inbuilt native libraries in BCore to draw primitives and bitmaps on to the screen.


Member

Rectangle

FillRectangle

BitmapFromDFlash

BitmapFromMemCard


Set the background colour of the OLED.


Sub Main()


OLED.Init(BCK.COLOUR.BLACK


OLED.Background.Colour =


Description




To set the cursor position; value

value


position; .X

.Y



Description

Plots a pixel at a specified point on the OLED Screen

Plots an array of points.

Draws a Line.

Draws an array of Lines.

Draws a Rectangle of specified sizing at a specified position.

Draws a Filled Rectangle of

Draws a Circle of specified sizing at a specified position.

Draws a bitmap file from the data flash memory chip.

Draws a bitmap from External Memory Card (MMC) to the


Set the background colour of the OLED.


BCK.COLOUR.BLACK)


OLED.Background.Colour = BCK.COLOUR







pixel at a specified point on the OLED Screen

Plots an array of points.

Draws a Line.

Draws an array of Lines.


Draws a Filled Rectangle of specified sizing at a specified position.






COLOUR.Fuschia





specified sizing at a specified position.





Fuschia











Draws a bitmap from External Memory Card (MMC) to the Screen

OLED | D

raw | Prim

itives


.POINT Plots a single pixel at a specified point on the OLED Screen.

OLED.Draw.Point

.POINTs Plots an array of pixels.

Parameters:

• Points()

• Zero

• Number of points

OLED.Draw.Points

.LINE Draws a Line from

OLED.Draw.Line

.LINEs Draws an array of points as a continuous connected line.

Parameters:

• Points()

• Zero

• Number of points

OLED.Draw.Lines

.Rectangle Draws a Rectangle using 2 points.

OLED.Draw.Rectangle

.fillrectangleDraws a solid/filled rectangle of foreground colour from

OLED.Draw.FillRectangle

.circle Draws a circle. Parameters accept center

OLED.Draw.Circle

OLED command ReferenceOLED command Reference

Plots a single pixel at a specified point on the OLED Screen.

OLED.Draw.Point(point

Plots an array of pixels.

Parameters:

Points() = point array;

Zero-offset start

Number of points

OLED.Draw.Points(points(),zero

Draws a Line from point1

OLED.Draw.Line(point1, point2

Draws an array of points as a continuous connected line.

Parameters:

Points() = point array;

Zero-offset start

Number of points

OLED.Draw.Lines(points(),zero

.Rectangle Draws a Rectangle using 2 points.

OLED.Draw.Rectangle

ectangle Draws a solid/filled rectangle of foreground colour from

OLED.Draw.FillRectangle

Draws a circle. Parameters accept center

OLED.Draw.Circle(center



point)

= point array;

offset start = zero-offset start index of point array to start plotting from;

Number of points = number of points to plot.

points(),zero

to point2 on the OLED Screen.

point1, point2


= point array;

offset start = zero-offset start index of point array to start plotting from;

Number of points = number of points to plot.

points(),zero

Draws a Rectangle using 2 points.

OLED.Draw.Rectangle(point1, point2

Draws a solid/filled rectangle of foreground colour from

OLED.Draw.FillRectangle(point1, point2

Draws a circle. Parameters accept center

center-point, radius



offset start index of point array to start plotting from;

= number of points to plot.

points(),zero-offset start, number of points

on the OLED Screen.

point1, point2)




points(),zero-offset start, number of points

point1, point2)

Draws a solid/filled rectangle of foreground colour from

point1, point2

Draws a circle. Parameters accept center point position and radius of circle.

point, radius





offset start, number of points

on the OLED Screen.





Draws a solid/filled rectangle of foreground colour from point1

point1, point2)

point position and radius of circle.

point, radius)





point1 to point2 on the OLED Screen.

point position and radius of circle.


offset start, number of points)


offset start, number of points)

on the OLED Screen.

Point1 <x1, y1>x

Point1 <x1, y1>

Points(0) <x

Points(0)

on the OLED Screen.

Point2 <x2, y2>

Point1 <x1, y1> x

Point2 <x2, y2>

Point1 <x1, y1>

Point1 <x1, y1>x

Point1 <x1, y1>

<x0, y0>

Points(1)

s(0) <x0, y0>

Point

Center-point

<x,y> R

Point2 <x2, y2> x

Point2 <x2, y2>

Point2 <x2, y2>

Point1 <x1, y1>

x

Point1 <x1, y1>

Points(2) <x2, y2

s(1) <x1, y1>

Points(3) <x3, y3

Points(2) <x2, y

Points(1) <x1, y1>

Points(3) <x3, y

Point2 <x2, y2>

2>

3>

, y2>

, y3>

Bitm

aps

Drawing Bitmaps to screenStorage and Rendering of Bitmap files are supported by the BCore OS.

However, due to the nature of bitmap files, they tend to require a large amount of memory. As such, Bitmaps are only allowed

to be stored on External Memory Cards (like MMC Cards), or the external DataFlash chip.

Depending on where you store your Bitmap F

OLED screen, provided it is given the correct information.

Please note:

This value

Value ‘0’: Successful

Value ‘1’: Error

Note: ¹Bitmaps must be in Windows® Bitmap .bmp format.

²

³

converted to the 16bit 565 RGB Format before importing it into the storage media for the BCore to access, since

24b

thereby imposing a limitation to the update rate from the BCore to the OLED Display.

.BitmapfromDraws a bitmap on the OLED screen from a .bm

Code: 01.

02.

03.

04.

05.

06.

07.

08.

09.

10.

11.

12.

Note: Please refer to

.BitmapfromDraws a bitmap on the OLED screen from a .bmp file stored in the

OLED.Draw.BitmapFromMemCard

Parameters:

• FileName

• Position

Code: 01.

02.

03.

04.

05.

06.

07.

08.

09.

10.

11.

12.


. Drawing Bitmaps to screenStorage and Rendering of Bitmap files are supported by the BCore OS.





Please note: The commands to draw bitmaps to screen returns a value and must be assigned to a variable.

will indicate if there has been any error during file fetching and/or drawing to the screen.

Value ‘0’: Successful

Value ‘1’: Error

Bitmaps must be in Windows® Bitmap .bmp format.

²Bitmaps of bit depth 16bit 565 Mode,

³For applications that require the OLED to update images really quickly, we recommend that the bitmaps are first


24bpp and 32bpp files are converted by the chip to the 16bit 565 format before sending to the OLED Display,


romdflash Draws a bitmap on the OLED screen from a .bm

Dim P1 As Point

Public Sub

Dim I1 As

DEBUG.PRINT

DELAY(200

OLED.INIT

OLED.SETCOLOUR.FOREGROUND

I1 = ADDRESSOF

P1.X = 50

P1.Y = 20

OLED.DRAW.BitmapFromDFlash

End Sub

: Please refer to APPENDIX A

romMemCard Draws a bitmap on the OLED screen from a .bmp file stored in the


Parameters:

FileName: Name of Bitmap File in

Position: Point XY location to draw bitmap

Dim P1 As Point

Public Sub

Dim I As

Dim STR1

OLED.INIT


I = OS.MEMCARD.INIT

STR1 = "B_PLAYER.BMP"

P1.X = 50

P1.Y = 20

I = OLED.DRAW.BITMAPFROMMEMCARD(STR1, P1)

End Sub


Drawing Bitmaps to screenStorage and Rendering of Bitmap files are supported by the BCore OS.





The commands to draw bitmaps to screen returns a value and must be assigned to a variable.



Bitmaps of bit depth 16bit 565 Mode,

For applications that require the OLED to update images really quickly, we recommend that the bitmaps are first


pp and 32bpp files are converted by the chip to the 16bit 565 format before sending to the OLED Display,


Draws a bitmap on the OLED screen from a .bm

As Point

Sub Main()

As Integer

DEBUG.PRINT "OLED -

200)

OLED.INIT(0)


ADDRESSOF(DATA1.B_PLAYER)

50

20

OLED.DRAW.BitmapFromDFlash

APPENDIX A for more details on transferring Bitmap Files from the PC to the BCore’s External

ard Draws a bitmap on the OLED screen from a .bmp file stored in the


: Name of Bitmap File in

XY location to draw bitmap

As Point

Sub Main()

Integer

STR1 AS STRING

OLED.INIT(0)


OS.MEMCARD.INIT()

"B_PLAYER.BMP"

50

20



Drawing Bitmaps to screen Storage and Rendering of Bitmap files are supported by the BCore OS.



Depending on where you store your Bitmap Files, a single line command is able to fetch the image file and draw it onto the





Bitmaps of bit depth 16bit 565 Mode, 24bpp, 32bpp are supported.





Draws a bitmap on the OLED screen from a .bmp file stored in the external DataFlash chip.

BITMAP"

OLED.SETCOLOUR.FOREGROUND(31)

(DATA1.B_PLAYER)

OLED.DRAW.BitmapFromDFlash(P1, I1)

for more details on transferring Bitmap Files from the PC to the BCore’s External

Draws a bitmap on the OLED screen from a .bmp file stored in the

(FileName,Position)

: Name of Bitmap File in String

XY location to draw bitmap

OLED.SETCOLOUR.FOREGROUND(31)

()

"B_PLAYER.BMP"



Storage and Rendering of Bitmap files are supported by the BCore OS.



iles, a single line command is able to fetch the image file and draw it onto the





24bpp, 32bpp are supported.





p file stored in the external DataFlash chip.

(P1, I1)


Draws a bitmap on the OLED screen from a .bmp file stored in the

(FileName,Position)


Storage and Rendering of Bitmap files are supported by the BCore OS.






24bpp, 32bpp are supported.







Draws a bitmap on the OLED screen from a .bmp file stored in the External Memory Card (MMC / SD Compatible)












External Memory Card (MMC / SD Compatible)










External Memory Card (MMC / SD Compatible)






for more details on transferring Bitmap Files from the PC to the BCore’s External DataFlash.

External Memory Card (MMC / SD Compatible).


fonttype Sets the font size of text printed to the screen.

Available font sizes are 8x8, 10x12, 16x16 pixels

OLED.FontType

Assignment

• OLED.FontType

A BCore Constant that stores the font size values is available to make the code more readable.

The following shows a code comparison on how to set the font size using direct assignment of values and using the BCore

Constants. Both codes achieve the same effect.

Code:

01.

02.

03.

.foreground Set the foreground colour of the OLED.

OLED.Foreground.Colour

Code:

01.

02.

03.

04.

05.

06.

07.


ype Sets the font size of text printed to the screen.


OLED.FontType

Assignment

OLED.FontType

� 0 = 8x8 pixel;

� 1 =10x12 pixel;

� 2 = 16x16 pixel




OLED.FontType

OLED.FontType

OLED.FontType

.foreground Set the foreground colour of the OLED.


'CODE1

Public Sub


OLED.Init(

OLED.Foreground.Colour =

OLED.Print

End Sub


Sets the font size of text printed to the screen.


OLED.FontType = font size;

= 8x8 pixel;

10x12 pixel;

16x16 pixel




OLED.FontType = 0

OLED.FontType = 1

OLED.FontType = 2

Set the foreground colour of the OLED.


Sub Main()

THE OLED AND SET THE BACKGROUND COLOUR TO BLACK

(BCK.COLOUR.BLACK

OLED.Foreground.Colour =

OLED.Print “Hello World!”


Sets the font size of text printed to the screen.


= font size;




Set the foreground colour of the OLED.


BCK.COLOUR.BLACK)

OLED.Foreground.Colour = BCK.COLOUR

“Hello World!”



Code:

01.

02.

03.


COLOUR.Fuschia



Code:

OLED.FontType

OLED.FontType

OLED.FontType


Fuschia



OLED.FontType = BCK.Font.Small

OLED.FontType = BCK.Font.Medium

OLED.FontType = BCK.Font.Large


BCK.Font.Small

BCK.Font.Medium

BCK.Font.Large


BCK.Font.Small

BCK.Font.Medium

BCK.Font.Large

GRAM | In

itialize

OLED | LD

R


.GRAM The pixels displayed on the OLED screen correspond to the image data stored in the Graphics RAM (GRAM).

Read access to the OLED GRAM is provided to the user.

Read the colour data direct from GRAM, by providing the position to read.

Read command returns the colour in 16bit 565 RGB Integer format.

MemberRead

OLED.GRAM.Read.Point

OLED.GRAM.Read.Rectangle

Parameter/s:

� memoryArr();

� point1

� point2

.Init() Does the necessary one

OLED screen to be initialised with.

*Note: Colour listing available. Please refer to the page on using colour constants.

OLED.Init

Code:

01.

02.

03.

04.

05.

.LDR Provides access to reading values from the onboard Light Dependent Resistor (LDR)

OLED.LDR.Read

Code:

01.

02.

03.

04.

05.

06.

07.

08.


The pixels displayed on the OLED screen correspond to the image data stored in the Graphics RAM (GRAM).




Member Submember

Point

Rectangle

OLED.GRAM.Read.Point

OLED.GRAM.Read.Rectangle

Parameter/s:

memoryArr();

� User declared single or

� Users are expected to ensure that the memory allocation of the Integer Array is sufficient to store the total

number of points being read to it

� Data from specified area will be store

(applicable only to 2 dimensional arrays) will be automatically done.

point1

� Starting point of Rectangle

point2

� Ending point of Rectangle

Does the necessary one-time initialising required for the OLED to be controlled thereafter. Parameter accepts colour for the

OLED screen to be initialised with.

: Colour listing available. Please refer to the page on using colour constants.

it(colour)

'CODE1

Public Sub


OLED.Init

End Sub


OLED.LDR.Read()

Public LDR

Public Sub

Do

Loop

End Sub






Submember Description

Returns the colour value from a single point in the GRAM

Rectangle Returns the colour values from a specified rectangular area in the GRAM

into a specified user declared integer array.

OLED.GRAM.Read.Point(point)

OLED.GRAM.Read.Rectangle(memoryArr(),point1,point2

User declared single or

Users are expected to ensure that the memory allocation of the Integer Array is sufficient to store the total


Data from specified area will be store


Starting point of Rectangle

Ending point of Rectangle

time initialising required for the OLED to be controlled thereafter. Parameter accepts colour for the

OLED screen to be initialised with. : Colour listing available. Please refer to the page on using colour constants.

Sub Main()


OLED.Init(BCK.COLOUR.BLACK


LDR as Integer

Sub Main()

Do

LDR =

Debug

Delay

Loop






Description


Returns the colour values from a specified rectangular area in the GRAM


memoryArr(),point1,point2

User declared single or 2 dimensional integer array to store the colour values read from the GRAM



Data from specified area will be store


Starting point of Rectangle

Ending point of Rectangle




BCK.COLOUR.BLACK)


Integer

= OLED.LDR.READ

Debug.Print Cstr

Delay(200)








memoryArr(),point1,point2

2 dimensional integer array to store the colour values read from the GRAM


Data from specified area will be stored in a continuous stream inside the integer array. Any row alignments






OLED.LDR.READ()

Cstr(LDR)







memoryArr(),point1,point2)



d in a continuous stream inside the integer array. Any row alignments






(0,0)

Y Axis









X Axis

LDR







GRAM

(0,0)

(0,240)

……

.






GRAM

(320

…….

320,0)

.ORIENTATION Set the orientation of the OLED screen to portrait or landscape.

OLED.Orientation

Parameter/s:

�

.print Prints text to screen using specified foreground colour. Works just like

*Note: Default text size is 8x8pixels.

OLED.Print

*Full set of 256 ASCII characters supported.

.READRegister Returns the contents of the OLED driver (

OLED.ReadRegister(

.WriteRProvides write abilities to the OLED driver (

¹ Please refer to S6E63D6 Driver IC Datasheet for full register listing.

OLED.WriteRegister

.Setcolour Set foreground and background colours

OLED.SetColour.Background = <colour>

OLED.SetColour.Foreground = <colour>

<Colour>:

*Refer to BCore Constants (BCK) for list of preset colours.


Member

Background

Foreground

.ORIENTATION Set the orientation of the OLED screen to portrait or landscape.

OLED.Orientation(

Parameter/s:

Orientation;

� 0: Landscape (Default)

� 1: Portrait

Prints text to screen using specified foreground colour. Works just like

: Default text size is 8x8pixels.

OLED.Print “[string]”


egister Returns the contents of the OLED driver (

OLED.ReadRegister(

Register Provides write abilities to the OLED driver (


OLED.WriteRegister

.Setcolour Set foreground and background colours





Member Description

Background Set Background Colour

Foreground Set Foreground Colour

Set the orientation of the OLED screen to portrait or landscape.

(Orientation

: Landscape (Default)

: Portrait


: Default text size is 8x8pixels.

“[string]” | String Variable | String Const


Returns the contents of the OLED driver (

OLED.ReadRegister(Address)



OLED.WriteRegister(Address, Value






Description

Set Background Colour

Set Foreground Colour


Orientation)


| String Variable | String Const

Returns the contents of the OLED driver (S6E63D6) register

Provides write abilities to the OLED driver (S6E63D6) registers


Address, Value)






Set Background Colour

Set Foreground Colour




register at a specified address.

registers



Prints text to screen using specified foreground colour. Works just like Debug.Print


at a specified address.

Debug.Print.

Touch Sc

reen


.Touch Provides access to touch screen methods.

Member

X

Y

Raw

X Returns calculated X coordinate of a touch on the touch screen.

OLED.Touch.X

Y Returns calculated Y coordinate of a touch on the touch screen.

OLED.Touch.Y

Code:

01.

02.

03.

04.

05.

06.

07.

08.

09.

10.

11.

X.raw Returns raw X coordinate of a touch on the touch screen.

OLED.Touch.X.Raw

Y.raw Returns raw Y coordinate of a touch on the touch screen.

OLED.Touch.Y.Raw


Provides access to touch screen methods.

Member Description

Returns optimized X coordinate of touch

Returns optimized Y coordinate of touch

X

Y

Returns calculated X coordinate of a touch on the touch screen.

OLED.Touch.X()

calculated Y coordinate of a touch on the touch screen.

OLED.Touch.Y()

Public X,Y

Public Sub

Do

Loop

End Sub

Returns raw X coordinate of a touch on the touch screen.

OLED.Touch.X.Raw()

Returns raw Y coordinate of a touch on the touch screen.

OLED.Touch.Y.Raw()



Description



Returns Raw Value of X

Returns Raw Value of Y



X,Y as Integer

Sub Main()

Do

X = OLED.Touch.X()

Y = OLED.Touch.Y()

Debug

Delay

Loop


()


()

0,0

0,240





Returns Raw Value of X

Returns Raw Value of Y



Integer

OLED.Touch.X()

OLED.Touch.Y()

Debug.Print Cstr

Delay(200)



320

240,320

Optimized Valu





OLED.Touch.X()

OLED.Touch.Y()

Cstr(X);" ";Cstr



320,0

320

Raw ValueValues

Cstr(Y)

~100,120

~100,910

Raw Values

~950,120

~950,910

BlazingCore Constants

Blazing

BCKBCore constants are constants that hold values meant to be used in conjunction with certain method and

property types within the BCore command set. Currently, it holds values for use mainly with the OLED library.

Method

Colour

Font

colour/COLORContains list of colours that represent valid 16bit (5/6/5) RGB values.

Member Aqua

Black

Blue

Fuschia

Grey

Green

Lime

Maroon

Navy

Olive

Purple

Red

Silver

Teal

White

Yellow

BCK.Colour

BCK.Color

Note: � Where “BCK” represents “BlazingCore Constants”

� Each member of “Colour” contains a constant value representing a

� Naming conventions “Colour” and “Color”, “Grey” and “Gray” are both supported.

Font Contains values to set font sizing.


Size

Small

Medium

Large

BCK.Font

lazingCore

BCK constants are constants that hold values meant to be used in conjunction with certain method and


Method Description

Colour Contains list of colours that represent valid 16bit (5/6/5) RGB values.

Font Contains values to set font sizing

colour/COLOR Contains list of colours that represent valid 16bit (5/6/5) RGB values.

Member Aqua

Black

Blue

Fuschia

Grey

Green

Lime

Maroon

Navy

Olive

Purple

Red

Silver

Teal

White

Yellow

Colour.<colour

Color.<color>

Where “BCK” represents “BlazingCore Constants”

Each member of “Colour” contains a constant value representing a

Naming conventions “Colour” and “Color”, “Grey” and “Gray” are both supported.

Contains values to set font sizing.


Size Description

Small 8x8

Medium 10x12

Large 16x16

Font.<size>

ore Constants

constants are constants that hold values meant to be used in conjunction with certain method and


Description

Contains list of colours that represent valid 16bit (5/6/5) RGB values.

Contains values to set font sizing


colour>




Contains values to set font sizing.


Description

10x12

16x16

Constants




Contains values to set font sizing
















Each member of “Colour” contains a constant value representing a 16bit 565 mode RGB colour.





16bit 565 mode RGB colour.




16bit 565 mode RGB colour.



Appendices

APPENDIX A

Transfe

rring Bitm

ap File

s

Transferring Bitmap Files from PC to BCore Store the Bitmap Files in your BCore Project’s Resource Folder, and import it using the Resource Page in BCoreIDE.

Files may be imported and downloaded into an external memory chip (DataFlash) or external memory card (MMC).

Example code to draw bitmap files to the OLED from both external memory methods are available under its respective

instruction set.

External DataFlash

1. To store Bitmap files in the External DataFlash, make sure the Bitmap files you want loaded into the DataFlash is

stored in: “Your Project Folder” > Resource > EEPROM

Example view using windows explorer. Note: You may have to create these folders yourself if they do not exist.

2. Next, Select the data file (DATA1) under the DataFlash Resources of your project, and declare an array of type data.

DATA myData(arraySize) FromFile “FileName”

Code:

01. ‘DATA1

02. DATA B_PLAYER(570) FROMFILE "P_PLAYER.bmp"

03. DATA BLUEB16(455) FROMFILE "Blue16.bmp"

The array size should correspond to the size of your bitmap file in bytes (You can find out the size by placing your mouse over

the particular bmp). (Refer to example as shown in figure above)

3. Compile and download the data file (DATA1) into the External DataFlash.

4. BMP files are now programmatically accessible through the use of the variable name (in this case, B_Player) as per

the example code under the OLED.Draw.BitmapDFlash Command.

Note: The data file downloads directly to the external data flash chip, separate from downloading the actual program.

Downloading your program does NOT download the data from the data file to the external data flash chip at the same time.

External Memory Card

1. To store Bitmap files in the External Memory Card (MMC/ SD Compatible), make sure you slot an

MMC card into your card reader on your Laptop/PC and open it up using Windows® Explorer.

2. Drag and Drop your Bitmap files into the External Memory Card.

3. When you’re done, eject the External Memory Card and slot it into the External Memory Card

Socket onboard the OLED interface board.

4. The bitmap files in the External Memory Card are now programmatically accessible using the Bitmap File Name as

per the example code under the OLED.Draw.BitmapFromMemCard Command.

*Please note that the file name length must be kept to 8 characters. Files with names longer than that may fail to

open.

APPENDIX b

ASC

II Chart

Ascii chart The following is a standard extended ascii chart supported by the BCore Font Library.

0 1 2 3 4 5 6 7 8 9

10 11 12 13 14 15 16 17 18 19

20 21 22 23 24 25 26 27 28 29

30 31 32 33 34 35 36 37 38 39

40 41 42 43 44 45 46 47 48 49

50 51 52 53 54 55 56 57 58 59

60 61 62 63 64 65 66 67 68 69

70 71 72 73 74 75 76 77 78 79

80 81 82 83 84 85 86 87 88 89

90 91 92 93 94 95 96 97 98 99

100 101 102 103 104 105 106 107 108 109

110 111 112 113 114 115 116 117 118 119

120 121 122 123 124 125 126 127 128 129

130 131 132 133 134 135 136 137 138 139

140 141 142 143 144 145 146 147 148 149

150 151 152 153 154 155 156 157 158 159

160 161 162 163 164 165 166 167 168 169

170 171 172 173 174 175 176 177 178 179

180 181 182 183 184 185 186 187 188 189

190 191 192 193 194 195 196 197 198 199

200 201 202 203 204 205 206 207 208 209

210 211 212 213 214 215 216 217 218 219

220 221 222 223 224 225 226 227 228 229

230 231 232 233 234 235 236 237 238 239

240 241 242 243 244 245 246 247 248 249

250 251 252 253 254 255

Notes

Latest documentation

All of our documentations are constantly updated to provide accurate and/or new information that we feel

would help you with developing with our products.

The latest documentation may be obtained from our website: http://www.aiscube.com/main/downloads.html

How you can help

You can help us to improve our documentations by emailing to us or posting a thread in our forum, reporting

any mistakes/typos or errata that you might spot while reading our documentation.

Email: [email protected]

Forum: http://forum.aiscube.com/index.php

Disclaimer

All information in this documentation is provided ‘as-is’ without any warranty of any kind.

The products produced by AIS Cube are meant for rapid prototyping and experimental usage; they are not

intended nor designed for implementation in environments that constitute high risk activities.

AIS Cube shall assume no responsibility or liability for any indirect, specific, incidental or consequential

damages arising out of the use of this documentation or product.

Copyright 2009 - 2010 AIS Cube. All rights reserved.

All product and corporate names appearing in this documentation may or may not be registered trademarks or

copyrights of their respective companies, and are only used for identification or explanation for the owner’s benefit,

with no intent to infringe.

The BlazingCore(BCore) and BCore IDE are trademarks of AIS Cube in Singapore and/or other countries. All images

depicting the Blazingcore or any part of it is copyrighted.

All other trademarks or registered trademarks are the property of their respective owners.

Documents

AMOLED Datasheet