/*#*
*#* $Log$
+ *#* Revision 1.5 2006/07/19 12:56:25 bernie
+ *#* Convert to new Doxygen style.
+ *#*
+ *#* Revision 1.4 2006/04/27 05:40:11 bernie
+ *#* Naming convention fixes; Partial merge from project_grl.
+ *#*
+ *#* Revision 1.3 2006/02/10 12:35:31 bernie
+ *#* Enforce CONFIG_* definitions.
+ *#*
*#* Revision 1.2 2006/01/23 23:11:27 bernie
*#* Use RASTER_SIZE() to compute... err... the raster size.
*#*
#include <stdbool.h>
#include <inttypes.h>
-#ifdef CONFIG_LCD_SOFTINT_REFRESH
+/* Configuration sanity checks */
+#if !defined(CONFIG_LCD_SOFTINT_REFRESH) || (CONFIG_LCD_SOFTINT_REFRESH != 0 && CONFIG_LCD_SOFTINT_REFRESH != 1)
+ #error CONFIG_LCD_SOFTINT_REFRESH must be defined to either 0 or 1
+#endif
+#if !defined(CONFIG_LCD_SOFTINT_REFRESH) || (CONFIG_LCD_SOFTINT_REFRESH != 0 && CONFIG_LCD_SOFTINT_REFRESH != 1)
+ #error CONFIG_LCD_SOFTINT_REFRESH must be defined to either 0 or 1
+#endif
- /*! Interval between softint driven lcd refresh */
+
+#if CONFIG_LCD_SOFTINT_REFRESH
+
+ /** Interval between softint driven lcd refresh */
# define LCD_REFRESH_INTERVAL 20 /* 20ms -> 50fps */
#endif /* CONFIG_LCD_SOFTINT_REFRESH */
-/*! Number of LCD pages */
+/** Number of LCD pages */
#define LCD_PAGES 4
-/*! Width of an LCD page */
+/** Width of an LCD page */
#define LCD_PAGESIZE (LCD_WIDTH / 2)
-/*!
+/**
* \name LCD I/O pins/ports
* @{
*/
#define LCD_PE_E2 PE6
/*@}*/
-/*!
+/**
* \name DB high nibble (DB[4-7])
* @{
*/
#define LCD_DATA_HI_MASK 0xF0
/*@}*/
-/*!
+/**
* \name DB low nibble (DB[0-3])
* @{
*/
#define LCD_DATA_LO_MASK 0xF0
/*@}*/
-/*!
+/**
* \name LCD bus control macros
* @{
*/
#define LCD_CLR_E(x) (PORTE &= ~(x))
/*@}*/
-/*!
+/**
* \name Chip select bits for LCD_SET_E()
* @{
*/
#define LCDF_E2 (BV(LCD_PE_E2))
/*@}*/
-/*! Read from the LCD data bus (DB[0-7]) */
+/** Read from the LCD data bus (DB[0-7]) */
#define LCD_READ ( \
((LCD_DATA_LO_PIN & LCD_DATA_LO_MASK) >> LCD_DATA_LO_SHIFT) | \
((LCD_DATA_HI_PIN & LCD_DATA_HI_MASK) >> LCD_DATA_HI_SHIFT) \
)
-/*! Write to the LCD data bus (DB[0-7]) */
+/** Write to the LCD data bus (DB[0-7]) */
#define LCD_WRITE(d) \
do { \
LCD_DATA_LO_PORT = (LCD_DATA_LO_PORT & ~LCD_DATA_LO_MASK) | (((d)<<LCD_DATA_LO_SHIFT) & LCD_DATA_LO_MASK); \
LCD_DATA_HI_PORT = (LCD_DATA_HI_PORT & ~LCD_DATA_HI_MASK) | (((d)<<LCD_DATA_HI_SHIFT) & LCD_DATA_HI_MASK); \
} while (0)
-/*! Set data bus direction to output (write to display) */
+/** Set data bus direction to output (write to display) */
#define LCD_DB_OUT \
do { \
LCD_DATA_LO_DDR |= LCD_DATA_LO_MASK; \
LCD_DATA_HI_DDR |= LCD_DATA_HI_MASK; \
} while (0)
-/*! Set data bus direction to input (read from display) */
+/** Set data bus direction to input (read from display) */
#define LCD_DB_IN \
do { \
LCD_DATA_LO_DDR &= ~LCD_DATA_LO_MASK; \
LCD_DATA_HI_DDR &= ~LCD_DATA_HI_MASK; \
} while (0)
-/*! Delay for tEW (160ns) */
+/** Delay for tEW (160ns) */
#define LCD_DELAY_WRITE \
do { \
NOP; \
NOP; \
} while (0)
-/*! Delay for tACC6 (180ns) */
+/** Delay for tACC6 (180ns) */
#define LCD_DELAY_READ \
do { \
NOP; \
} while (0)
-/*!
+/**
* \name 32122A Commands
* @{
*/
#define LCD_CMD_RESET 0xE2
/*@}*/
+MOD_DEFINE(lcd)
+
+
/* Status flags */
#define LCDF_BUSY BV(7)
-#ifdef CONFIG_LCD_WAIT
-/*!
+#if CONFIG_LCD_WAIT
+/**
* \code
* __ __
* RS __\____________/__
#endif /* CONFIG_LCD_WAIT */
-/*!
+/**
* Raster buffer to draw into.
*
* Bits in the bitmap bytes have vertical orientation,
static uint8_t lcd_raster[RASTER_SIZE(LCD_WIDTH, LCD_HEIGHT)];
DECLARE_WALL(wall_after_raster, WALL_SIZE)
-/*! Default LCD bitmap */
+/** Default LCD bitmap */
struct Bitmap lcd_bitmap;
-#ifdef CONFIG_LCD_SOFTINT_REFRESH
+#if CONFIG_LCD_SOFTINT_REFRESH
-/*! Timer for regular LCD refresh */
+/** Timer for regular LCD refresh */
static Timer *lcd_refresh_timer;
#endif /* CONFIG_LCD_SOFTINT_REFRESH */
WAIT_LCD;
- /*!
+ /**
* \code
* __________________
* A0 __/ \__
{
WAIT_LCD;
- /*!
+ /**
* \code
* __________________
* A0 ___/ \___
}
-/*!
+/**
* Set LCD contrast PWM.
*/
-void lcd_setpwm(int duty)
+void lcd_setPwm(int duty)
{
ASSERT(duty >= LCD_MIN_PWM);
ASSERT(duty <= LCD_MAX_PWM);
}
-static void lcd_writeraster(const uint8_t *raster)
+static void lcd_writeRaster(const uint8_t *raster)
{
uint8_t page, rows;
const uint8_t *right_raster;
}
}
-
-void lcd_blit_bitmap(Bitmap *bm)
+/**
+ * Update the LCD display with data from the provided bitmap.
+ */
+void lcd_blitBitmap(Bitmap *bm)
{
- lcd_writeraster(bm->raster);
+ MOD_CHECK(lcd);
+ lcd_writeRaster(bm->raster);
}
-#ifdef CONFIG_LCD_SOFTINT_REFRESH
+#if CONFIG_LCD_SOFTINT_REFRESH
-static void lcd_refresh_softint(void)
+static void lcd_refreshSoftint(void)
{
lcd_blit_bitmap(&lcd_bitmap);
timer_add(lcd_refresh_timer);
#endif /* CONFIG_LCD_SOFTINT_REFRESH */
-/*!
+/**
* Initialize LCD subsystem.
*
* \note The PWM used for LCD contrast is initialized in drv/pwm.c
*/
void lcd_init(void)
{
+ MOD_CHECK(timer);
+
// FIXME: interrupts are already disabled when we get here?!?
cpuflags_t flags;
IRQ_SAVE_DISABLE(flags);
gfx_bitmapInit(&lcd_bitmap, lcd_raster, LCD_WIDTH, LCD_HEIGHT);
gfx_bitmapClear(&lcd_bitmap);
-#ifdef CONFIG_LCD_SOFTINT_REFRESH
+#if CONFIG_LCD_SOFTINT_REFRESH
/* Init IRQ driven LCD refresh */
lcd_refresh_timer = timer_new();
timer_add(lcd_refresh_timer);
#endif /* CONFIG_LCD_SOFTINT_REFRESH */
+
+ MOD_INIT(lcd);
}