General header for the STM32-circle projects. More...

Data Structures
struct	tMEMS_Info
	MEMS state description. More...

struct	tPointer_Info
	Pointer position description. More...

struct	tCX_USART_Config
	USART extension configuration. More...

struct	tCX_SPI_Config
	SPI extension configuration. More...

struct	tFontDef

struct	tFontTable

struct	tTrans

struct	tMenuItem
	Menu item description. More...

struct	tMenu
	Menu description. More...

struct	tToolbarItem
	Toolbar item description. More...

struct	tToolbar
	Toolbar description. More...

struct	tListItem
	List item description. More...

struct	tList
	List description. More...

struct	_tagVOLINFO
	Volume information structure. More...

struct	_tagDIRENT
	Directory entry structure. More...

struct	_tagDIRINFO
	Directory search structure. More...

struct	_tagFILEINFO
	File handle structure. More...

Macros
#define	CX_GPIO_LOW (0)

#define	CX_GPIO_HIGH (1)

#define	CX_NO_ERROR 0

#define	CX_USART_PARITYERR 0x01

#define	CX_USART_FRAMEERR 0x02

#define	CX_USART_NOISEERR 0x04

#define	CX_USART_OVERRUN 0x08

#define	CX_SPI_OVERRUN 0x20

#define	CX_SPI_MODF 0x40

#define	CX_SPI_MODE_SLAVE 0

#define	CX_SPI_MODE_MASTER 1

#define	CX_SPI_POL_LOW 0

#define	CX_SPI_POL_HIGH 1

#define	CX_SPI_PHA_FIRST 0

#define	CX_SPI_PHA_SECOND 1

#define	CX_SPI_MSBFIRST 0

#define	CX_SPI_LSBFIRST 1

#define	CX_SPI_8_Bits 0

#define	CX_SPI_16_Bits 1

#define	CX_SPI_Soft 0

#define	CX_SPI_Hard 1

#define	RGB_MAKE(xR, xG, xB)

#define	RGB_RED RGB_MAKE(0xFF, 0x00, 0x00)

#define	RGB_GREEN RGB_MAKE(0x00, 0xFF, 0x00)

#define	RGB_PASTELGREEN RGB_MAKE(0x00, 0xFF, 0x00)

#define	RGB_LIGHTBLUE RGB_MAKE(0x00, 0x00, 0xFF)

#define	RGB_BLUE RGB_MAKE(0x00, 0x00, 0xFF)

#define	RGB_BLACK RGB_MAKE(0x00, 0x00, 0x00)

#define	RGB_WHITE RGB_MAKE(0xFF, 0xFF, 0xFF)

#define	RGB_YELLOW RGB_MAKE(0xFF, 0xFF, 0x00)

#define	RGB_MAGENTA RGB_MAKE(0xFF, 0x00, 0xFF)

#define	RGB_TURQUOISE RGB_MAKE(0x00, 0xFF, 0xFF)

#define	RGB_ORANGE RGB_MAKE(0xFF, 0x80, 0x40)

#define	RGB_PINK RGB_MAKE(0xFF, 0x3F, 0xFF)

#define	RGB_LIGHTGREY RGB_MAKE(0xC0, 0xC0, 0xC0)

#define	RGB_DARKGREY RGB_MAKE(0x80, 0x80, 0x80)

#define	RGB_DARKBLUE RGB_MAKE(0x00, 0x00, 0xA0)

#define	RGB_LIGHTPURPLE RGB_MAKE(0xFF, 0x00, 0x80)

#define	RGB_DARKPURPLE RGB_MAKE(0x80, 0x00, 0x80)

#define	RGB_BROWN RGB_MAKE(0x80, 0x40, 0x00)

#define	RGB_BURGUNDY RGB_MAKE(0x80, 0x00, 0x00)

#define	RGB_FORESTGREEN RGB_MAKE(0x80, 0x80, 0x00)

#define	RGB_GRASSGREEN RGB_MAKE(0x40, 0x80, 0x80)

#define	BACKLIGHTMIN 0x1000

#define	DEFAULT_CCR_BACKLIGHTSTART 0x8000

#define	CHAR_WIDTH 7

#define	CHAR_HEIGHT 14

#define	MAX_FONT_NB 20

#define	INVERTED_TEXT 1

#define	NORMAL_TEXT 0

#define	ALL_SCREEN -1 /< To center the text in the screen for draw functions. /

#define	REMOVE_MENU 0x01

#define	APP_MENU 0x02

#define	MENU_MAXITEM 8

#define	BKP_SYS1 1

#define	BKP_SYS2 2

#define	BKP_SYS3 3

#define	BKP_SYS4 4

#define	BKP_SYS5 5

#define	BKP_SYS6 6

#define	BKP_SYS7 11

#define	BKP_SYS8 12

#define	BKP_SYS9 13

#define	BKP_SYS10 14

#define	BKP_SYS11 15

#define	BKP_SYS12 16

#define	BKP_SYS13 17

#define	BKP_SYS14 18

#define	BKP_USER1 7

#define	BKP_USER2 8

#define	BKP_USER3 9

#define	BKP_USER4 10

#define	TOOLBAR_MAXITEMS 4

#define	LIST_MAXITEM 64

#define	MAX_PATH_LENGTH 200

#define	FS_OK 0

#define	FS_EOF 1

#define	FS_WRITEPROT 2

#define	FS_NOTFOUND 3

#define	FS_PATHLEN 4

#define	FS_ALLOCNEW 5

#define	FS_ERRMISC 0xffffffff

#define	FS_OPEN_EXISTING 0x00

#define	FS_READ 0x01

#define	FS_WRITE 0x02

#define	FS_CREATE_NEW 0x04

#define	FS_CREATE_ALWAYS 0x08

#define	FS_OPEN_ALWAYS 0x10

#define	FS_ATTR_READ_ONLY 0x01

#define	FS_ATTR_HIDDEN 0x02

#define	FS_ATTR_SYSTEM 0x04

#define	FS_ATTR_VOLUME_ID 0x08

#define	FS_ATTR_DIRECTORY 0x10

#define	FS_ATTR_ARCHIVE 0x20

#define	FS_ATTR_LONG_NAME (FS_ATTR_READ_ONLY \| FS_ATTR_HIDDEN \| FS_ATTR_SYSTEM \| FS_ATTR_VOLUME_ID)

Typedefs
typedef int(*	tFctXY )(int x, int y)

typedef s8	sound_type

typedef enum STORAGE_device	eSTORAGE_device

typedef struct _tagVOLINFO	VOLINFO

typedef struct _tagVOLINFO *	PVOLINFO

typedef struct _tagDIRENT	DIRENT

typedef struct _tagDIRENT *	PDIRENT

typedef struct _tagDIRINFO	DIRINFO

typedef struct _tagDIRINFO *	PDIRINFO

typedef struct _tagFILEINFO	FILEINFO

typedef struct _tagFILEINFO *	PFILEINFO

typedef void(*	tAppPtrMgr )(coord_t sposX, coord_t sposY)

Enumerations
enum	eSpeed { SPEED_VERY_LOW = 1, SPEED_LOW = 2, SPEED_MEDIUM = 3, SPEED_HIGH = 4, SPEED_VERY_HIGH = 5 }
	Clock speeds. More...

enum	eSchHandler { MEMS_SCHHDL_ID = 0, LED_SCHHDL_ID = 1, BUTTON_SCHHDL_ID = 2, BUZZER_SCHHDL_ID = 3, MENU_SCHHDL_ID = 4, POINTER_SCHHDL_ID = 5, LCD_SCHHDL_ID = 6, DRAW_SCHHDL_ID = 7, RTC_SCHHDL_ID = 8, AUDIO_SCHHDL_ID = 9, TOUCHSCR_SCHHDL_ID = 10, TOOLBAR_SCHHDL_ID = 11, POWER_SCHHDL_ID = 12, UNUSED5_SCHHDL_ID = 13, UNUSED6_SCHHDL_ID = 14, UNUSED7_SCHHDL_ID = 15, UNUSED8_SCHHDL_ID = 16 }

enum	Rotate_H12_V_Match_TypeDef { V12 = 0, V3 = 1, V6 = 2, V9 = 3, V12BMP = 4, V3BMP = 5, V6BMP = 6, V9BMP = 7 }
	The 4 possible rotations. More...

enum	POINTER_mode { POINTER_UNDEF = -1, POINTER_OFF = 0, POINTER_ON = 1, POINTER_MENU = 2, POINTER_APPLICATION = 3, POINTER_RESTORE_LESS = 4 }
	Available pointer modes. More...

enum	POINTER_state { POINTER_S_UNDEF = -1, POINTER_S_DISABLED = 0, POINTER_S_ENABLED = 1 }
	The different pointer modes. More...

enum	BUTTON_mode { BUTTON_DISABLED = -1, BUTTON_ONOFF = 0, BUTTON_ONOFF_FORMAIN = 1, BUTTON_WITHCLICK = 2 }
	Available button modes. More...

enum	BUTTON_state { BUTTON_UNDEF = -1, BUTTON_RELEASED = 0, BUTTON_PUSHED = 1, BUTTON_PUSHED_FORMAIN = 2, BUTTON_CLICK = 3, BUTTON_DBLCLICK = 4 }
	CircleOS button states. More...

enum	JOYSTICK_state { JOYSTICK_UNDEF = -1, JOYSTICK_RELEASED = 0, JOYSTICK_LEFT = 1, JOYSTICK_UP = 2, JOYSTICK_RIGHT = 3, JOYSTICK_DOWN = 4, JOYSTICK_RIGHT_UP = 11, JOYSTICK_LEFT_UP = 5, JOYSTICK_RIGHT_DOWN = 13, JOYSTICK_LEFT_DOWN = 7 }
	CircleOS joystick states. More...

enum	tCX_ID { CX_GPIO_PIN3 = 3, CX_GPIO_PIN4 = 4, CX_GPIO_PIN5 = 5, CX_GPIO_PIN6 = 6, CX_GPIO_PIN7 = 7, CX_GPIO_PIN8 = 8, CX_GPIO_PIN9 = 9, CX_GPIO_PIN10 = 10, CX_GPIO_PIN11 = 11, CX_GPIO_PIN12 = 12, CX_GPIO_PIN13 = 13, CX_GPIO_PIN14 = 14, CX_GPIO_PIN15 = 15, CX_GPIO_PIN16 = 16, CX_GPIO_PIN17 = 17, CX_GPIO_PIN18 = 18, CX_USART = 0x20, CX_SPI = 0x21, CX_I2C = 0x22, CX_ADC1 = 0x23, CX_ADC2 = 0x24 }
	Extension connector pin configuration. More...

enum	tCX_GPIO_Mode { CX_GPIO_Mode_IN_HIZ = 0, CX_GPIO_Mode_IN_PD = 1, CX_GPIO_Mode_IN_PU = 2, CX_GPIO_Mode_OUT_OD = 3, CX_GPIO_Mode_OUT_PP = 4 }
	GPIO extension modes. More...

enum	tCX_SPI_Speed { CX_SPI_Speed_standard = 0, CX_SPI_Speed_VeryLow = 1, CX_SPI_Speed_Low = 2, CX_SPI_Mode_High = 3, CX_SPI_Mode_VeryHigh = 4 }
	SPI extension speed configuration. More...

enum	ENUM_FontID { FONT_PRIMER = 0, FONT_PRIMERX2 = 1, FONT_MEDIUM = 2, FONT_MEDIUMX2 = 3, FONT_NUMBERS = 4 }

enum	Align { LEFT = 0, CENTER = 1, RIGHT = 2 }

enum	SELECT_MODE { SELNONE = 0, SELADDR = 1, SELDISP = 2, SELFULL = 3, SELNONE = 0, SELADDR = 1, SELDISP = 2, SELFULL = 3 }

enum	BUZZER_mode { BUZZER_UNDEF = -1, BUZZER_OFF = 0, BUZZER_ON = 1, BUZZER_SHORTBEEP = 2, BUZZER_LONGBEEP = 3, BUZZER_PLAYMUSIC = 4 }
	CircleOS buzzer modes. More...

enum	MENU_code { MENU_LEAVE = 0, MENU_CONTINUE = 1, MENU_REFRESH = 2, MENU_CHANGE = 3, MENU_CONTINUE_COMMAND = 4, MENU_LEAVE_AS_IT = 5, MENU_RESTORE_COMMAND = 6 }
	Application return values. More...

enum	LED_mode { LED_UNDEF = -1, LED_OFF = 0, LED_ON = 1, LED_BLINKING_LF = 2, LED_BLINKING_HF = 3 }
	LED modes. More...

enum	LED_id { LED_GREEN = 0, LED_RED = 1 }
	Available LEDs. More...

enum	TOUCHSCR_Mode_enum { TS_NORMAL, TS_DRAWING, TS_CALIBRATION }

enum	ON_OFF_enum { OFF, ON }

enum	AUDIO_DeviceMode_enum { AUDIO_MODE, VOICE_MODE, AUDIO_CIRCULAR_MODE, VOICE_CIRCULAR_MODE }

enum	AUDIO_Playback_status_enum { NO_SOUND, IS_PLAYING }

enum	AUDIO_Recording_status_enum { NO_RECORD, IS_RECORDING }

enum	AUDIO_Length_enum { LG_8_BITS, LG_16_BITS }

enum	AUDIO_Frequency_enum { FRQ_48KHZ, FRQ_44KHZ, FRQ_22KHZ, FRQ_16KHZ, FRQ_8KHZ }

enum	AUDIO_Format_enum { MONO, STEREO }

enum	AUDIO_PlaybackBuffer_Status { FULL = 0, LOW_EMPTY = 1, HIGH_EMPTY = 2 }

enum	AUDIO_RecordBuffer_Status { EMPTY = 0, LOW_FULL = 1, HIGH_FULL = 2 }

enum	STORAGE_device { MMCSD_SDIO, INTERNAL_FLASH }

Variables
enum eSpeed	CurrentSpeed

Detailed Description

Author: FL

Date: 07/2007

Version: 1.2

Date: 10/2007

Version: 1.5 types of OutX_F64 and OutX_F256 changed to u32 (same for Y and Z)

Date: 10/2007

Version: 1.6 Add the IRQ handler replacement; 1.7 With vectorized scheduler handler; 3.0 Add Primer2 management and ST lib v2.0.3

Date: 10/2008

Version: 3.8 CMSIS compliance and ST lib v3.1.0

Date: 08/2009

Version: 4.0 OPEN4 support

Date: 05/2010

Version: 4.1 Fonts, transparency and application full screen support

Date: 08/2010

Version: 4.2 Add STM32L platform

Date: 04/2011

Version: 4.3 Add STM3220G platform

Date: 10/2012

Version: 4.4 add CX, UTIL_GetBatStatus, UTIL_SaveScreenBMP and UTIL_SetTimer functions and more FS functions

Date: 07/2013

Version: 4.5 changed file system, settable handler dividers, add UTIL_SaveScreenBMP, deployed Cx functions

Date: 08/2013

Version: 4.6 added DMA_2D functions

It contains the list of the utilities functions organized by sections (MEMS, LCD, POINTER, ...)

Definition in file circle_api.h.

Macro Definition Documentation

#define ALL_SCREEN -1 /*< To center the text in the screen for draw functions. */

Definition at line 718 of file circle_api.h.

#define APP_MENU 0x02

Menu flag: item is an application.

Definition at line 908 of file circle_api.h.

#define BACKLIGHTMIN 0x1000

Minimal PWM rate.

Definition at line 609 of file circle_api.h.

#define BKP_SYS1 1