Rename the clip directory to sansa-clip to be consistent with the first (PortalPlayer) Sansa ports

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@18786 a1c6a512-1295-4272-9138-f99709370657

7 files changed, 591 insertions, 0 deletions

diff --git a/firmware/target/arm/as3525/sansa-clip/adc-target.h b/firmware/target/arm/as3525/sansa-clip/adc-target.h
new file mode 100644
index 0000000000..bea0272496
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/adc-target.h
@@ -0,0 +1,24 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2008 ??
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+#ifndef _ADC_TARGET_H_
+#define _ADC_TARGET_H_
+
+#endif /* _ADC_TARGET_H_ */
diff --git a/firmware/target/arm/as3525/sansa-clip/backlight-target.h b/firmware/target/arm/as3525/sansa-clip/backlight-target.h
new file mode 100644
index 0000000000..9533d0a6b5
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/backlight-target.h
@@ -0,0 +1,37 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2008 ??
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+#ifndef BACKLIGHT_TARGET_H
+#define BACKLIGHT_TARGET_H
+
+static inline bool _backlight_init(void)
+{
+    return true;
+}
+
+static inline void _backlight_on(void)
+{
+}
+
+static inline void _backlight_off(void)
+{
+}
+
+#endif
diff --git a/firmware/target/arm/as3525/sansa-clip/button-clip.c b/firmware/target/arm/as3525/sansa-clip/button-clip.c
new file mode 100644
index 0000000000..faed075c65
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/button-clip.c
@@ -0,0 +1,92 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2008 François Dinel
+ * Copyright (C) 2008 Rafaël Carré
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+#include "button-target.h"
+#include "as3525.h"
+
+void button_init_device(void)
+{
+    GPIOA_DIR &= ~((1<<7) | (1<<3));
+    GPIOB_DIR &= ~((1<<2) | (1<<1) | (1<<0));
+    GPIOC_PIN(4) = 0x00;
+    GPIOC_PIN(5) = 0x00;
+    GPIOC_PIN(6) = 0x00;
+    GPIOC_DIR |= ((1<<6) | (1<<5) | (1<<4));
+}
+
+int button_read_device(void)
+{
+    int result = 0;
+
+    /* direct GPIO connections */
+
+    if (GPIOA_PIN(7))
+        result |= BUTTON_POWER;
+
+    if (GPIOA_PIN(3))
+        result |= BUTTON_HOLD;
+
+    /* This is a keypad using C4-C6 as columns and B0-B2 as rows */
+    GPIOC_PIN(4) = (1<<4);
+
+    /* C4B0 is unused */
+
+    if (GPIOB_PIN(1))
+        result |= BUTTON_VOLUP;
+
+    if (GPIOB_PIN(2))
+        result |= BUTTON_PLAY;
+
+    GPIOC_PIN(4) = 0x00;
+
+    GPIOC_PIN(5) = (1<<5);
+
+    if (GPIOB_PIN(0))
+        result |= BUTTON_LEFT;
+
+    if (GPIOB_PIN(1))
+        result |= BUTTON_SELECT;
+
+    if (GPIOB_PIN(2))
+        result |= BUTTON_RIGHT;
+
+    GPIOC_PIN(5) = 0x00;
+
+    GPIOC_PIN(6) = (1<<6);
+
+    if (GPIOB_PIN(0))
+        result |= BUTTON_DOWN;
+
+    if (GPIOB_PIN(1))
+        result |= BUTTON_VOLDOWN;
+
+    if (GPIOB_PIN(2))
+        result |= BUTTON_HOME;
+
+    GPIOC_PIN(6) = 0x00;
+
+    return result;
+}
+
+bool button_hold(void)
+{
+    return (GPIOA_PIN(3) != 0);
+}
diff --git a/firmware/target/arm/as3525/sansa-clip/button-target.h b/firmware/target/arm/as3525/sansa-clip/button-target.h
new file mode 100644
index 0000000000..1fb57ae9e9
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/button-target.h
@@ -0,0 +1,60 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2008 François Dinel
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+
+#ifndef _BUTTON_TARGET_H_
+#define _BUTTON_TARGET_H_
+
+#include <stdbool.h>
+#include "config.h"
+
+#define HAS_BUTTON_HOLD
+
+void button_init_device(void);
+int button_read_device(void);
+bool button_hold(void);
+
+/* Main unit's buttons */
+#define BUTTON_HOME         0x00000001
+
+#define BUTTON_VOLUP        0x00000002
+#define BUTTON_VOLDOWN      0x00000004
+
+#define BUTTON_PLAY         0x00000008
+#define BUTTON_DOWN         0x00000010
+#define BUTTON_LEFT         0x00000020
+#define BUTTON_RIGHT        0x00000040
+
+#define BUTTON_SELECT       0x00000080
+
+#define BUTTON_POWER        0x00000100
+#define BUTTON_HOLD         0x00000200
+
+#define BUTTON_MAIN (BUTTON_HOME|BUTTON_VOLUP|BUTTON_VOLDOWN\
+                    |BUTTON_PLAY|BUTTON_DOWN|BUTTON_LEFT|BUTTON_RIGHT\
+                    |BUTTON_SELECT|BUTTON_POWER|BUTTON_HOLD)
+
+#define BUTTON_REMOTE 0
+
+/* Software power-off */
+#define POWEROFF_BUTTON BUTTON_POWER
+#define POWEROFF_COUNT 40
+
+#endif /* _BUTTON_TARGET_H_ */
diff --git a/firmware/target/arm/as3525/sansa-clip/lcd-ssd1303.c b/firmware/target/arm/as3525/sansa-clip/lcd-ssd1303.c
new file mode 100644
index 0000000000..4ae13a5fcc
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/lcd-ssd1303.c
@@ -0,0 +1,312 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2002 by Alan Korr
+ * Copyright (C) 2008 François Dinel
+ * Copyright (C) 2008 Rafaël Carré
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+#include "config.h"
+
+#include "hwcompat.h"
+#include "kernel.h"
+#include "lcd.h"
+#include "system.h"
+#include "cpu.h"
+#include "string.h"
+
+/*** AS3525 specifics ***/
+#include "as3525.h"
+
+/*** definitions ***/
+
+#define LCD_SET_LOWER_COLUMN_ADDRESS              ((char)0x00)
+#define LCD_SET_HIGHER_COLUMN_ADDRESS             ((char)0x10)
+#define LCD_SET_DISPLAY_START_LINE                ((char)0x40)
+#define LCD_SET_CONTRAST_CONTROL_REGISTER         ((char)0x81)
+#define LCD_SET_SEGMENT_REMAP                     ((char)0xA0)
+#define LCD_SET_SEGMENT_REMAP_INV                 ((char)0xA1)
+#define LCD_SET_ENTIRE_DISPLAY_OFF                ((char)0xA4)
+#define LCD_SET_ENTIRE_DISPLAY_ON                 ((char)0xA5)
+#define LCD_SET_NORMAL_DISPLAY                    ((char)0xA6)
+#define LCD_SET_REVERSE_DISPLAY                   ((char)0xA7)
+#define LCD_SET_MULTIPLEX_RATIO                   ((char)0xA8)
+#define LCD_SET_DC_DC                             ((char)0xAD)
+#define LCD_SET_DC_DC_PART2                       ((char)0x8A)
+#define LCD_SET_DISPLAY_OFF                       ((char)0xAE)
+#define LCD_SET_DISPLAY_ON                        ((char)0xAF)
+#define LCD_SET_PAGE_ADDRESS                      ((char)0xB0)
+#define LCD_SET_COM_OUTPUT_SCAN_DIRECTION         ((char)0xC0)
+#define LCD_SET_COM_OUTPUT_SCAN_DIRECTION_INV     ((char)0xC8)
+#define LCD_SET_DISPLAY_CLOCK_AND_OSC_FREQ        ((char)0xD5)
+#define LCD_SET_VCOM_DESELECT_LEVEL               ((char)0xDB)
+#define LCD_SET_PRECHARGE_PERIOD                  ((char)0xD9)
+#define LCD_NOP                                   ((char)0xE3)
+
+/* LCD command codes */
+#define LCD_CNTL_CONTRAST       0x81    /* Contrast */
+#define LCD_CNTL_OUTSCAN        0xc8    /* Output scan direction */
+#define LCD_CNTL_SEGREMAP       0xa1    /* Segment remap */
+#define LCD_CNTL_DISPON         0xaf    /* Display on */
+
+#define LCD_CNTL_PAGE           0xb0    /* Page address */
+#define LCD_CNTL_HIGHCOL        0x10    /* Upper column address */
+#define LCD_CNTL_LOWCOL         0x00    /* Lower column address */
+
+/* DBOP initialisation, do what OF does */
+static void ams3525_dbop_init(void)
+{
+    int clkdiv = 4 - 1;
+
+    CGU_DBOP |= (1<<3) /* clk enable */ | clkdiv /* clkdiv: 3 bits */ ;
+
+    GPIOB_AFSEL = 0x08; /* DBOP on pin 3 */
+    GPIOC_AFSEL = 0x0f; /* DBOP on pins 3:0 */
+
+    DBOP_CTRL      = 0x51008;
+    DBOP_TIMPOL_01 = 0x6E167;
+    DBOP_TIMPOL_23 = 0xA167E06F;
+}
+
+void lcd_write_command(int byte)
+{
+    /* unset D/C# (data or command) */
+    GPIOA_PIN(5) = 0;
+
+    /* Write command */
+    DBOP_DOUT = (byte << 8) | byte;
+
+    /* While push fifo is not empty */
+    while ((DBOP_STAT & (1<<10)) == 0)
+        ;
+}
+
+void lcd_write_data(const fb_data* p_bytes, int count)
+{
+    /* set D/C# (data or command) */
+    GPIOA_PIN(5) = (1<<5);
+
+    while (count--)
+    {
+        /* Write pixels */
+        DBOP_DOUT = (*p_bytes << 8) | *p_bytes;
+
+        p_bytes++; /* next packed pixels */
+
+        /* While push fifo is not empty */
+        while ((DBOP_STAT & (1<<10)) == 0)
+            ;
+    }
+}
+
+
+/** globals **/
+
+static int xoffset; /* needed for flip */
+static bool display_on; /* used by lcd_enable */
+
+/*** hardware configuration ***/
+
+int lcd_default_contrast(void)
+{
+    return 0x1f;
+}
+
+void lcd_set_contrast(int val)
+{
+    lcd_write_command(LCD_CNTL_CONTRAST);
+    lcd_write_command(val);
+}
+
+void lcd_set_invert_display(bool yesno)
+{
+    if (yesno) 
+        lcd_write_command(LCD_SET_REVERSE_DISPLAY);
+    else 
+        lcd_write_command(LCD_SET_NORMAL_DISPLAY);
+}
+
+/* turn the display upside down (call lcd_update() afterwards) */
+void lcd_set_flip(bool yesno)
+{
+    (void)yesno;
+    /* TODO */
+}
+
+void lcd_enable(bool enable)
+{
+    if( (display_on = enable) ) /* simple '=' is not a typo ! */
+        lcd_write_command(LCD_SET_DISPLAY_ON);
+    else
+        lcd_write_command(LCD_SET_DISPLAY_OFF);
+}
+
+bool lcd_enabled(void)
+{
+    return display_on;
+}
+
+
+/* LCD init, largely based on what OF does */
+void lcd_init_device(void)
+{
+    int i;
+#define LCD_FULLSCREEN (128+4)
+    fb_data p_bytes[LCD_FULLSCREEN]; /* framebuffer used to clear the screen */
+
+    ams3525_dbop_init();
+
+    GPIOA_DIR |= 0x33; /* pins 5:4 and 1:0 out */
+    GPIOB_DIR |= 0x60; /* pin 6:5 out */
+
+    GPIOA_PIN(1) = (1<<1);
+    GPIOA_PIN(0) = (1<<0);
+    GPIOA_PIN(4) = 0;
+    GPIOB_PIN(5) = 0;
+    GPIOB_PIN(6) = (1<<6);
+
+    /* Set display clock (divide ratio = 1) and oscillator frequency (1) */
+    lcd_write_command(LCD_SET_DISPLAY_CLOCK_AND_OSC_FREQ);
+    lcd_write_command(0x10);
+
+    /* Set VCOM deselect level to 0.76V */
+    lcd_write_command(LCD_SET_VCOM_DESELECT_LEVEL);
+    lcd_write_command(0x34);
+
+    /* Set pre-charge period (p1period is 2 dclk and p2period is 5 dclk) */
+    lcd_write_command(LCD_SET_PRECHARGE_PERIOD);
+    lcd_write_command(0x25);
+
+    /* Set contrast register to 12% */
+    lcd_set_contrast(lcd_default_contrast());
+
+    /* Disable DC-DC */
+    lcd_write_command(LCD_SET_DC_DC);
+    lcd_write_command(LCD_SET_DC_DC_PART2/*|0*/);
+
+    /* Set starting line as 0 */
+    lcd_write_command(LCD_SET_DISPLAY_START_LINE /*|(0 & 0x3f)*/);
+
+    /* Column 131 is remapped to SEG0 */
+    lcd_write_command(LCD_SET_SEGMENT_REMAP_INV);
+
+    /* Invert COM scan direction (N-1 to 0) */
+    lcd_write_command(LCD_SET_COM_OUTPUT_SCAN_DIRECTION_INV);
+
+    /* Set normal display mode (not every pixel ON) */
+    lcd_write_command(LCD_SET_ENTIRE_DISPLAY_OFF);
+
+    /* Set normal display mode (not inverted) */
+    lcd_write_command(LCD_SET_NORMAL_DISPLAY);
+
+    /* Clear whole framebuffer, including "overscan"
+     * We don't need to handle that out of screen columns in lcd_clear_display()
+     * since we will never write into it anymore
+     */
+    lcd_write_command (LCD_SET_HIGHER_COLUMN_ADDRESS /*| 0*/);
+    lcd_write_command (LCD_SET_LOWER_COLUMN_ADDRESS /*| 0*/);
+
+    memset(p_bytes, 0, sizeof(p_bytes)); /* fills with 0 : pixel off */ 
+
+    for(i = 0; i < 8; i++)
+    {
+        lcd_write_command (LCD_SET_PAGE_ADDRESS | (i /*& 0xf*/));
+        lcd_write_data(p_bytes, LCD_FULLSCREEN /* overscan */);
+    }
+
+    lcd_update();
+}
+
+/*** Update functions ***/
+
+/* Performance function that works with an external buffer
+   note that by and bheight are in 8-pixel units! */
+void lcd_blit_mono(const unsigned char *data, int x, int by, int width,
+                   int bheight, int stride)
+{
+    /* Copy display bitmap to hardware */
+    while (bheight--)
+    {
+        lcd_write_command (LCD_CNTL_PAGE | (by++ & 0xf));
+        lcd_write_command (LCD_CNTL_HIGHCOL | (((x+2+xoffset)>>4) & 0xf));
+        lcd_write_command (LCD_CNTL_LOWCOL | ((x+2+xoffset) & 0xf));
+
+        lcd_write_data(data, width);
+        data += stride;
+    }
+}
+
+
+/* Performance function that works with an external buffer
+   note that by and bheight are in 8-pixel units! */
+void lcd_blit_grey_phase(unsigned char *values, unsigned char *phases,
+                         int x, int by, int width, int bheight, int stride)
+{
+    (void)values;
+    (void)phases;
+    (void)x;
+    (void)by;
+    (void)width;
+    (void)bheight;
+    (void)stride;
+}
+
+/* Update the display.
+   This must be called after all other LCD functions that change the display. */
+void lcd_update(void) ICODE_ATTR;
+void lcd_update(void)
+{
+    int y;
+
+    /* Copy display bitmap to hardware */
+    for (y = 0; y < LCD_FBHEIGHT; y++)
+    {
+        lcd_write_command (LCD_CNTL_PAGE | (y & 0xf));
+        lcd_write_command (LCD_CNTL_HIGHCOL | (((xoffset+2) >> 4) & 0xf));
+        lcd_write_command (LCD_CNTL_LOWCOL | ((xoffset+2) & 0xf));
+
+        lcd_write_data (lcd_framebuffer[y], LCD_WIDTH);
+    }
+}
+
+/* Update a fraction of the display. */
+void lcd_update_rect(int, int, int, int) ICODE_ATTR;
+void lcd_update_rect(int x, int y, int width, int height)
+{
+    int ymax;
+
+    /* The Y coordinates have to work on even 8 pixel rows */
+    ymax = (y + height-1) >> 3;
+    y >>= 3;
+
+    if(x + width > LCD_WIDTH)
+        width = LCD_WIDTH - x;
+    if (width <= 0)
+        return; /* nothing left to do, 0 is harmful to lcd_write_data() */
+    if(ymax >= LCD_FBHEIGHT)
+        ymax = LCD_FBHEIGHT-1;
+
+    /* Copy specified rectange bitmap to hardware */
+    for (; y <= ymax; y++)
+    {
+        lcd_write_command (LCD_CNTL_PAGE | (y & 0xf));
+        lcd_write_command (LCD_CNTL_HIGHCOL | (((x+2+xoffset) >> 4) & 0xf));
+        lcd_write_command (LCD_CNTL_LOWCOL | ((x+2+xoffset) & 0xf));
+
+        lcd_write_data (&lcd_framebuffer[y][x], width);
+    }
+}
diff --git a/firmware/target/arm/as3525/sansa-clip/system-target.h b/firmware/target/arm/as3525/sansa-clip/system-target.h
new file mode 100644
index 0000000000..b712d1c124
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/system-target.h
@@ -0,0 +1,28 @@
+/***************************************************************************
+ *             __________               __   ___.
+ *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+ *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+ *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+ *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+ *                     \/            \/     \/    \/            \/
+ * $Id$
+ *
+ * Copyright (C) 2008 ??
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+ * KIND, either express or implied.
+ *
+ ****************************************************************************/
+#ifndef SYSTEM_TARGET_H
+#define SYSTEM_TARGET_H
+
+#include "system-arm.h"
+
+#define CPUFREQ_MAX    250000000
+
+#endif /* SYSTEM_TARGET_H */
diff --git a/firmware/target/arm/as3525/sansa-clip/timer-target.h b/firmware/target/arm/as3525/sansa-clip/timer-target.h
new file mode 100644
index 0000000000..b81da57885
--- /dev/null
+++ b/firmware/target/arm/as3525/sansa-clip/timer-target.h
@@ -0,0 +1,38 @@
+/***************************************************************************
+*             __________               __   ___.
+*   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
+*   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
+*   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
+*   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
+*                     \/            \/     \/    \/            \/
+* $Id$
+*
+* Copyright (C) 2008 ??
+*
+* This program is free software; you can redistribute it and/or
+* modify it under the terms of the GNU General Public License
+* as published by the Free Software Foundation; either version 2
+* of the License, or (at your option) any later version.
+*
+* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+* KIND, either express or implied.
+*
+****************************************************************************/
+#ifndef TIMER_TARGET_H
+#define TIMER_TARGET_H
+
+bool __timer_set(long cycles, bool set);
+bool __timer_register(void);
+void __timer_unregister(void);
+
+#define __TIMER_SET(cycles, set) \
+    __timer_set(cycles, set)
+
+#define __TIMER_REGISTER(reg_prio, unregister_callback, cycles, \
+                              int_prio, timer_callback) \
+    __timer_register()
+
+#define __TIMER_UNREGISTER(...) \
+    __timer_unregister()
+
+#endif /* TIMER_TARGET_H */