apps/plugin.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2002 Björn Stenberg
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21 #ifndef _PLUGIN_H_
  22 #define _PLUGIN_H_
  23
  24 /* instruct simulator code to not redefine any symbols when compiling plugins.
  25    (the PLUGIN macro is defined in apps/plugins/Makefile) */
  26 #ifdef PLUGIN
  27 #define NO_REDEFINES_PLEASE
  28 #endif
  29
  30 #include <stdbool.h>
  31 #include <inttypes.h>
  32 #include <sys/types.h>
  33 #include <stdarg.h>
  34 #include <stdio.h>
  35 #include <stdlib.h>
  36 #include <string.h>
  37 #include "string-extra.h"
  38 #include "gcc_extensions.h"
  39
  40 char* strncpy(char *, const char *, size_t);
  41 void* plugin_get_buffer(size_t *buffer_size);
  42
  43 #ifndef __PCTOOL__
  44 #include "config.h"
  45 #include "system.h"
  46 #include "dir.h"
  47 #include "general.h"
  48 #include "kernel.h"
  49 #include "thread.h"
  50 #include "button.h"
  51 #include "action.h"
  52 #include "load_code.h"
  53 #include "usb.h"
  54 #include "font.h"
  55 #include "lcd.h"
  56 #include "metadata.h"
  57 #include "sound.h"
  58 #include "mpeg.h"
  59 #include "audio.h"
  60 #include "mp3_playback.h"
  61 #include "talk.h"
  62 #ifdef RB_PROFILE
  63 #include "profile.h"
  64 #endif
  65 #include "misc.h"
  66 #include "filefuncs.h"
  67 #if (CONFIG_CODEC == SWCODEC)
  68 #include "pcm_mixer.h"
  69 #include "dsp.h"
  70 #include "codecs.h"
  71 #include "playback.h"
  72 #include "codec_thread.h"
  73 #ifdef HAVE_RECORDING
  74 #include "recording.h"
  75 #endif
  76 #else
  77 #include "mas35xx.h"
  78 #endif /* CONFIG_CODEC == SWCODEC */
  79 #include "settings.h"
  80 #include "timer.h"
  81 #include "playlist.h"
  82 #ifdef HAVE_LCD_BITMAP
  83 #include "screendump.h"
  84 #include "scrollbar.h"
  85 #include "jpeg_load.h"
  86 #include "../recorder/bmp.h"
  87 #endif
  88 #include "statusbar.h"
  89 #include "menu.h"
  90 #include "rbunicode.h"
  91 #include "list.h"
  92 #include "tree.h"
  93 #include "color_picker.h"
  94 #include "buffering.h"
  95 #include "tagcache.h"
  96 #include "viewport.h"
  97 #include "ata_idle_notify.h"
  98 #include "settings_list.h"
  99 #include "timefuncs.h"
 100 #include "crc32.h"
 101
 102 #ifdef HAVE_ALBUMART
 103 #include "albumart.h"
 104 #endif
 105
 106 #ifdef HAVE_REMOTE_LCD
 107 #include "lcd-remote.h"
 108 #endif
 109
 110 #include "yesno.h"
 111
 112 #include "filetypes.h"
 113
 114 #ifdef USB_ENABLE_HID
 115 #include "usbstack/usb_hid_usage_tables.h"
 116 #endif
 117
 118
 119 /* on some platforms strcmp() seems to be a tricky define which
 120  * breaks if we write down strcmp's prototype */
 121 #undef strcmp
 122
 123 #ifdef PLUGIN
 124
 125 #if defined(DEBUG) || defined(SIMULATOR)
 126 #undef DEBUGF
 127 #define DEBUGF  rb->debugf
 128 #undef LDEBUGF
 129 #define LDEBUGF rb->debugf
 130 #else
 131 #undef DEBUGF
 132 #define DEBUGF(...) do { } while(0)
 133 #undef LDEBUGF
 134 #define LDEBUGF(...) do { } while(0)
 135 #endif
 136
 137 #ifdef ROCKBOX_HAS_LOGF
 138 #undef LOGF
 139 #define LOGF rb->logf
 140 #else
 141 #define LOGF(...)
 142 #endif
 143
 144 #endif
 145
 146 #define PLUGIN_MAGIC 0x526F634B /* RocK */
 147
 148 /* increase this every time the api struct changes */
 149 #define PLUGIN_API_VERSION 208
 150
 151 /* update this to latest version if a change to the api struct breaks
 152    backwards compatibility (and please take the opportunity to sort in any
 153    new function which are "waiting" at the end of the function table) */
 154 #define PLUGIN_MIN_API_VERSION 205
 155
 156 /* plugin return codes */
 157 /* internal returns start at 0x100 to make exit(1..255) work */
 158 #define INTERNAL_PLUGIN_RETVAL_START 0x100
 159 enum plugin_status {
 160     PLUGIN_OK = 0, /* PLUGIN_OK == EXIT_SUCCESS */
 161     /* 1...255 reserved for exit() */
 162     PLUGIN_USB_CONNECTED = INTERNAL_PLUGIN_RETVAL_START,
 163     PLUGIN_POWEROFF,
 164     PLUGIN_GOTO_WPS,
 165     PLUGIN_ERROR = -1,
 166 };
 167
 168 /* NOTE: To support backwards compatibility, only add new functions at
 169          the end of the structure.  Every time you add a new function,
 170          remember to increase PLUGIN_API_VERSION.  If you make changes to the
 171          existing APIs then also update PLUGIN_MIN_API_VERSION to current
 172          version
 173  */
 174 struct plugin_api {
 175
 176     /* lcd */
 177
 178 #ifdef HAVE_LCD_CONTRAST
 179     void (*lcd_set_contrast)(int x);
 180 #endif
 181     void (*lcd_update)(void);
 182     void (*lcd_clear_display)(void);
 183     int  (*lcd_getstringsize)(const unsigned char *str, int *w, int *h);
 184     void (*lcd_putsxy)(int x, int y, const unsigned char *string);
 185     void (*lcd_putsxyf)(int x, int y, const unsigned char *fmt, ...);
 186     void (*lcd_puts)(int x, int y, const unsigned char *string);
 187     void (*lcd_putsf)(int x, int y, const unsigned char *fmt, ...);
 188     void (*lcd_puts_scroll)(int x, int y, const unsigned char* string);
 189     void (*lcd_stop_scroll)(void);
 190 #ifdef HAVE_LCD_CHARCELLS
 191     void (*lcd_define_pattern)(unsigned long ucs, const char *pattern);
 192     unsigned long (*lcd_get_locked_pattern)(void);
 193     void (*lcd_unlock_pattern)(unsigned long ucs);
 194     void (*lcd_putc)(int x, int y, unsigned long ucs);
 195     void (*lcd_put_cursor)(int x, int y, unsigned long ucs);
 196     void (*lcd_remove_cursor)(void);
 197     void (*lcd_icon)(int icon, bool enable);
 198     void (*lcd_double_height)(bool on);
 199 #else /* HAVE_LCD_BITMAP */
 200     fb_data* lcd_framebuffer;
 201     void (*lcd_update_rect)(int x, int y, int width, int height);
 202     void (*lcd_set_drawmode)(int mode);
 203     int  (*lcd_get_drawmode)(void);
 204     void (*lcd_setfont)(int font);
 205     void (*lcd_drawpixel)(int x, int y);
 206     void (*lcd_drawline)(int x1, int y1, int x2, int y2);
 207     void (*lcd_hline)(int x1, int x2, int y);
 208     void (*lcd_vline)(int x, int y1, int y2);
 209     void (*lcd_drawrect)(int x, int y, int width, int height);
 210     void (*lcd_fillrect)(int x, int y, int width, int height);
 211     void (*lcd_mono_bitmap_part)(const unsigned char *src, int src_x, int src_y,
 212                                  int stride, int x, int y, int width, int height);
 213     void (*lcd_mono_bitmap)(const unsigned char *src, int x, int y,
 214                             int width, int height);
 215 #if LCD_DEPTH > 1
 216     void     (*lcd_set_foreground)(unsigned foreground);
 217     unsigned (*lcd_get_foreground)(void);
 218     void     (*lcd_set_background)(unsigned foreground);
 219     unsigned (*lcd_get_background)(void);
 220     void (*lcd_bitmap_part)(const fb_data *src, int src_x, int src_y,
 221                             int stride, int x, int y, int width, int height);
 222     void (*lcd_bitmap)(const fb_data *src, int x, int y, int width,
 223                        int height);
 224     fb_data* (*lcd_get_backdrop)(void);
 225     void (*lcd_set_backdrop)(fb_data* backdrop);
 226 #endif
 227 #if LCD_DEPTH == 16
 228     void (*lcd_bitmap_transparent_part)(const fb_data *src,
 229             int src_x, int src_y, int stride,
 230             int x, int y, int width, int height);
 231     void (*lcd_bitmap_transparent)(const fb_data *src, int x, int y,
 232             int width, int height);
 233 #if MEMORYSIZE > 2
 234     void (*lcd_blit_yuv)(unsigned char * const src[3],
 235                          int src_x, int src_y, int stride,
 236                          int x, int y, int width, int height);
 237 #if defined(TOSHIBA_GIGABEAT_F) || defined(SANSA_E200) || defined(SANSA_C200) \
 238     || defined(IRIVER_H10) || defined(COWON_D2) || defined(PHILIPS_HDD1630) \
 239     || defined(SANSA_FUZE) || defined(SANSA_E200V2) || defined(SANSA_FUZEV2) \
 240     || defined(TOSHIBA_GIGABEAT_S) || defined(PHILIPS_SA9200)
 241     void (*lcd_yuv_set_options)(unsigned options);
 242 #endif
 243 #endif /* MEMORYSIZE > 2 */
 244 #elif (LCD_DEPTH < 4) && (CONFIG_PLATFORM & PLATFORM_NATIVE)
 245     void (*lcd_blit_mono)(const unsigned char *data, int x, int by, int width,
 246                           int bheight, int stride);
 247     void (*lcd_blit_grey_phase)(unsigned char *values, unsigned char *phases,
 248                                 int bx, int by, int bwidth, int bheight,
 249                                 int stride);
 250 #endif /* LCD_DEPTH */
 251 #if defined(HAVE_LCD_MODES) && (HAVE_LCD_MODES & LCD_MODE_PAL256)
 252     void (*lcd_blit_pal256)(unsigned char *src, int src_x, int src_y, int x, int y,
 253                             int width, int height);
 254     void (*lcd_pal256_update_pal)(fb_data *palette);
 255 #endif
 256     void (*lcd_puts_style)(int x, int y, const unsigned char *str, int style);
 257     void (*lcd_puts_scroll_style)(int x, int y, const unsigned char* string,
 258                                   int style);
 259 #ifdef HAVE_LCD_INVERT
 260     void (*lcd_set_invert_display)(bool yesno);
 261 #endif /* HAVE_LCD_INVERT */
 262 #if defined(HAVE_LCD_MODES)
 263     void (*lcd_set_mode)(int mode);
 264 #endif
 265
 266 #if defined(HAVE_LCD_ENABLE) || defined(HAVE_LCD_SLEEP)
 267     struct event_queue *button_queue;
 268 #endif
 269     unsigned short *(*bidi_l2v)( const unsigned char *str, int orientation );
 270 #ifdef HAVE_LCD_BITMAP
 271     bool (*is_diacritic)(const unsigned short char_code, bool *is_rtl);
 272 #endif
 273     const unsigned char *(*font_get_bits)( struct font *pf, unsigned short char_code );
 274     int (*font_load)(struct font*, const char *path);
 275     struct font* (*font_get)(int font);
 276     int  (*font_getstringsize)(const unsigned char *str, int *w, int *h,
 277                                int fontnumber);
 278     int (*font_get_width)(struct font* pf, unsigned short char_code);
 279     void (*screen_clear_area)(struct screen * display, int xstart, int ystart,
 280                               int width, int height);
 281     void (*gui_scrollbar_draw)(struct screen * screen, int x, int y,
 282                                int width, int height, int items,
 283                                int min_shown, int max_shown,
 284                                unsigned flags);
 285 #endif  /* HAVE_LCD_BITMAP */
 286     const char* (*get_codepage_name)(int cp);
 287
 288     /* backlight */
 289     /* The backlight_* functions must be present in the API regardless whether
 290      * HAVE_BACKLIGHT is defined or not. The reason is that the stock Ondio has
 291      * no backlight but can be modded to have backlight (it's prepared on the
 292      * PCB). This makes backlight an all-target feature API wise, and keeps API
 293      * compatible between stock and modded Ondio.
 294      * For OLED targets like the Sansa Clip, the backlight_* functions control
 295      * the display enable, which has essentially the same effect. */
 296     void (*backlight_on)(void);
 297     void (*backlight_off)(void);
 298     void (*backlight_set_timeout)(int index);
 299 #ifdef HAVE_BACKLIGHT_BRIGHTNESS
 300     void (*backlight_set_brightness)(int val);
 301 #endif /* HAVE_BACKLIGHT_BRIGHTNESS */
 302
 303 #if CONFIG_CHARGING
 304     void (*backlight_set_timeout_plugged)(int index);
 305 #endif
 306     bool (*is_backlight_on)(bool ignore_always_off);
 307     void (*splash)(int ticks, const char *str);
 308     void (*splashf)(int ticks, const char *fmt, ...) ATTRIBUTE_PRINTF(2, 3);
 309
 310 #ifdef HAVE_REMOTE_LCD
 311     /* remote lcd */
 312     void (*lcd_remote_set_contrast)(int x);
 313     void (*lcd_remote_clear_display)(void);
 314     void (*lcd_remote_puts)(int x, int y, const unsigned char *string);
 315     void (*lcd_remote_puts_scroll)(int x, int y, const unsigned char* string);
 316     void (*lcd_remote_stop_scroll)(void);
 317     void (*lcd_remote_set_drawmode)(int mode);
 318     int  (*lcd_remote_get_drawmode)(void);
 319     void (*lcd_remote_setfont)(int font);
 320     int  (*lcd_remote_getstringsize)(const unsigned char *str, int *w, int *h);
 321     void (*lcd_remote_drawpixel)(int x, int y);
 322     void (*lcd_remote_drawline)(int x1, int y1, int x2, int y2);
 323     void (*lcd_remote_hline)(int x1, int x2, int y);
 324     void (*lcd_remote_vline)(int x, int y1, int y2);
 325     void (*lcd_remote_drawrect)(int x, int y, int nx, int ny);
 326     void (*lcd_remote_fillrect)(int x, int y, int nx, int ny);
 327     void (*lcd_remote_mono_bitmap_part)(const unsigned char *src, int src_x,
 328                                         int src_y, int stride, int x, int y,
 329                                         int width, int height);
 330     void (*lcd_remote_mono_bitmap)(const unsigned char *src, int x, int y,
 331                                    int width, int height);
 332     void (*lcd_remote_putsxy)(int x, int y, const unsigned char *string);
 333     void (*lcd_remote_puts_style)(int x, int y, const unsigned char *str, int style);
 334     void (*lcd_remote_puts_scroll_style)(int x, int y, const unsigned char* string,
 335                                          int style);
 336     fb_remote_data* lcd_remote_framebuffer;
 337     void (*lcd_remote_update)(void);
 338     void (*lcd_remote_update_rect)(int x, int y, int width, int height);
 339
 340     void (*remote_backlight_on)(void);
 341     void (*remote_backlight_off)(void);
 342     void (*remote_backlight_set_timeout)(int index);
 343 #if CONFIG_CHARGING
 344     void (*remote_backlight_set_timeout_plugged)(int index);
 345 #endif
 346 #endif /* HAVE_REMOTE_LCD */
 347     struct screen* screens[NB_SCREENS];
 348 #if defined(HAVE_REMOTE_LCD) && (LCD_REMOTE_DEPTH > 1)
 349     void     (*lcd_remote_set_foreground)(unsigned foreground);
 350     unsigned (*lcd_remote_get_foreground)(void);
 351     void     (*lcd_remote_set_background)(unsigned background);
 352     unsigned (*lcd_remote_get_background)(void);
 353     void (*lcd_remote_bitmap_part)(const fb_remote_data *src,
 354                                    int src_x, int src_y, int stride,
 355                                    int x, int y, int width, int height);
 356     void (*lcd_remote_bitmap)(const fb_remote_data *src, int x, int y,
 357                               int width, int height);
 358 #endif
 359     void (*viewport_set_defaults)(struct viewport *vp,
 360                                   const enum screen_type screen);
 361 #ifdef HAVE_LCD_BITMAP
 362     void (*viewportmanager_theme_enable)(enum screen_type screen, bool enable,
 363                                          struct viewport *viewport);
 364     void (*viewportmanager_theme_undo)(enum screen_type screen, bool force_redraw);
 365 #endif
 366     /* list */
 367     void (*gui_synclist_init)(struct gui_synclist * lists,
 368             list_get_name callback_get_item_name, void * data,
 369             bool scroll_all,int selected_size,
 370             struct viewport parent[NB_SCREENS]);
 371     void (*gui_synclist_set_nb_items)(struct gui_synclist * lists, int nb_items);
 372     void (*gui_synclist_set_icon_callback)(struct gui_synclist * lists,
 373                                            list_get_icon icon_callback);
 374     int (*gui_synclist_get_nb_items)(struct gui_synclist * lists);
 375     int  (*gui_synclist_get_sel_pos)(struct gui_synclist * lists);
 376     void (*gui_synclist_draw)(struct gui_synclist * lists);
 377     void (*gui_synclist_select_item)(struct gui_synclist * lists,
 378                                      int item_number);
 379     void (*gui_synclist_add_item)(struct gui_synclist * lists);
 380     void (*gui_synclist_del_item)(struct gui_synclist * lists);
 381     void (*gui_synclist_limit_scroll)(struct gui_synclist * lists, bool scroll);
 382     bool (*gui_synclist_do_button)(struct gui_synclist * lists,
 383                                    int *action, enum list_wrap wrap);
 384     void (*gui_synclist_set_title)(struct gui_synclist *lists, char* title,
 385                                    enum themable_icons icon);
 386     enum yesno_res (*gui_syncyesno_run)(const struct text_message * main_message,
 387                                         const struct text_message * yes_message,
 388                                         const struct text_message * no_message);
 389     void (*simplelist_info_init)(struct simplelist_info *info, char* title,
 390                                  int count, void* data);
 391     bool (*simplelist_show_list)(struct simplelist_info *info);
 392
 393     /* button */
 394     long (*button_get)(bool block);
 395     long (*button_get_w_tmo)(int ticks);
 396     int (*button_status)(void);
 397 #ifdef HAVE_BUTTON_DATA
 398     intptr_t (*button_get_data)(void);
 399     int (*button_status_wdata)(int *pdata);
 400 #endif
 401     void (*button_clear_queue)(void);
 402     int (*button_queue_count)(void);
 403 #ifdef HAS_BUTTON_HOLD
 404     bool (*button_hold)(void);
 405 #endif
 406 #ifdef HAVE_TOUCHSCREEN
 407     void (*touchscreen_set_mode)(enum touchscreen_mode);
 408 #endif
 409 #ifdef HAVE_BUTTON_LIGHT
 410     void (*buttonlight_set_timeout)(int value);
 411     void (*buttonlight_off)(void);
 412     void (*buttonlight_on)(void);
 413 #ifdef HAVE_BUTTONLIGHT_BRIGHTNESS
 414     void (*buttonlight_set_brightness)(int val);
 415 #endif /* HAVE_BUTTONLIGHT_BRIGHTNESS */
 416 #endif /* HAVE_BUTTON_LIGHT */
 417
 418     /* file */
 419     int (*open_utf8)(const char* pathname, int flags);
 420     int (*open)(const char* pathname, int flags, ...);
 421     int (*close)(int fd);
 422     ssize_t (*read)(int fd, void* buf, size_t count);
 423     off_t (*lseek)(int fd, off_t offset, int whence);
 424     int (*creat)(const char *pathname, mode_t mode);
 425     ssize_t (*write)(int fd, const void* buf, size_t count);
 426     int (*remove)(const char* pathname);
 427     int (*rename)(const char* path, const char* newname);
 428     int (*ftruncate)(int fd, off_t length);
 429     off_t (*filesize)(int fd);
 430     int (*fdprintf)(int fd, const char *fmt, ...) ATTRIBUTE_PRINTF(2, 3);
 431     int (*read_line)(int fd, char* buffer, int buffer_size);
 432     bool (*settings_parseline)(char* line, char** name, char** value);
 433     void (*storage_sleep)(void);
 434     void (*storage_spin)(void);
 435     void (*storage_spindown)(int seconds);
 436 #if USING_STORAGE_CALLBACK
 437     void (*register_storage_idle_func)(void (*function)(void *data));
 438     void (*unregister_storage_idle_func)(void (*function)(void *data), bool run);
 439 #endif /* USING_STORAGE_CALLBACK */
 440     void (*reload_directory)(void);
 441     char *(*create_numbered_filename)(char *buffer, const char *path,
 442                                       const char *prefix, const char *suffix,
 443                                       int numberlen IF_CNFN_NUM_(, int *num));
 444     bool (*file_exists)(const char *file);
 445     char* (*strip_extension)(char* buffer, int buffer_size, const char *filename);
 446     unsigned (*crc_32)(const void *src, unsigned len, unsigned crc32);
 447
 448     int (*filetype_get_attr)(const char* file);
 449
 450
 451
 452     /* dir */
 453     DIR* (*opendir)(const char* name);
 454     int (*closedir)(DIR* dir);
 455     struct dirent* (*readdir)(DIR* dir);
 456     int (*mkdir)(const char *name);
 457     int (*rmdir)(const char *name);
 458     bool (*dir_exists)(const char *path);
 459     struct dirinfo (*dir_get_info)(DIR* parent, struct dirent *entry);
 460
 461     /* browsing */
 462     void (*browse_context_init)(struct browse_context *browse,
 463                                 int dirfilter, unsigned flags,
 464                                 char *title, enum themable_icons icon,
 465                                 const char *root, const char *selected);
 466     int (*rockbox_browse)(struct browse_context *browse);
 467
 468     /* kernel/ system */
 469 #if defined(CPU_ARM) && CONFIG_PLATFORM & PLATFORM_NATIVE
 470     void (*__div0)(void);
 471 #endif
 472     unsigned (*sleep)(unsigned ticks);
 473     void (*yield)(void);
 474     volatile long* current_tick;
 475     long (*default_event_handler)(long event);
 476     long (*default_event_handler_ex)(long event,
 477             void (*callback)(void *), void *parameter);
 478     unsigned int (*create_thread)(void (*function)(void), void* stack,
 479                                   size_t stack_size, unsigned flags,
 480                                   const char *name
 481                                   IF_PRIO(, int priority)
 482                                   IF_COP(, unsigned int core));
 483     unsigned int (*thread_self)(void);
 484     void (*thread_exit)(void);
 485     void (*thread_wait)(unsigned int thread_id);
 486 #if CONFIG_CODEC == SWCODEC
 487     void (*thread_thaw)(unsigned int thread_id);
 488 #ifdef HAVE_PRIORITY_SCHEDULING
 489     int (*thread_set_priority)(unsigned int thread_id, int priority);
 490 #endif
 491     void (*mutex_init)(struct mutex *m);
 492     void (*mutex_lock)(struct mutex *m);
 493     void (*mutex_unlock)(struct mutex *m);
 494 #endif
 495
 496     void (*reset_poweroff_timer)(void);
 497 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 498     int (*system_memory_guard)(int newmode);
 499     long *cpu_frequency;
 500 #ifdef HAVE_ADJUSTABLE_CPU_FREQ
 501 #ifdef CPU_BOOST_LOGGING
 502     void (*cpu_boost_)(bool on_off,char*location,int line);
 503 #else
 504     void (*cpu_boost)(bool on_off);
 505 #endif
 506 #endif /* HAVE_ADJUSTABLE_CPU_FREQ */
 507 #endif /* PLATFORM_NATIVE */
 508 #ifdef HAVE_SCHEDULER_BOOSTCTRL
 509     void (*trigger_cpu_boost)(void);
 510     void (*cancel_cpu_boost)(void);
 511 #endif
 512
 513     void (*cpucache_flush)(void);
 514     void (*cpucache_invalidate)(void);
 515
 516     /* load code api for overlay */
 517     void* (*lc_open)(const char *filename, unsigned char *buf, size_t buf_size);
 518     void* (*lc_open_from_mem)(void* addr, size_t blob_size);
 519     void* (*lc_get_header)(void *handle);
 520     void  (*lc_close)(void *handle);
 521
 522     bool (*timer_register)(int reg_prio, void (*unregister_callback)(void),
 523                            long cycles, void (*timer_callback)(void)
 524                            IF_COP(, int core));
 525     void (*timer_unregister)(void);
 526     bool (*timer_set_period)(long count);
 527
 528     void (*queue_init)(struct event_queue *q, bool register_queue);
 529     void (*queue_delete)(struct event_queue *q);
 530     void (*queue_post)(struct event_queue *q, long id, intptr_t data);
 531     void (*queue_wait_w_tmo)(struct event_queue *q, struct queue_event *ev,
 532             int ticks);
 533 #if CONFIG_CODEC == SWCODEC
 534     void (*queue_enable_queue_send)(struct event_queue *q,
 535                                     struct queue_sender_list *send,
 536                                     unsigned int thread_id);
 537     bool (*queue_empty)(const struct event_queue *q);
 538     void (*queue_wait)(struct event_queue *q, struct queue_event *ev);
 539     intptr_t (*queue_send)(struct event_queue *q, long id,
 540                            intptr_t data);
 541     void (*queue_reply)(struct event_queue *q, intptr_t retval);
 542 #endif /* CONFIG_CODEC == SWCODEC */
 543
 544     void (*usb_acknowledge)(long id);
 545 #ifdef USB_ENABLE_HID
 546     void (*usb_hid_send)(usage_page_t usage_page, int id);
 547 #endif
 548 #ifdef RB_PROFILE
 549     void (*profile_thread)(void);
 550     void (*profstop)(void);
 551     void (*profile_func_enter)(void *this_fn, void *call_site);
 552     void (*profile_func_exit)(void *this_fn, void *call_site);
 553 #endif
 554     /* event api */
 555     bool (*add_event)(unsigned short id, bool oneshot, void (*handler)(void *data));
 556     void (*remove_event)(unsigned short id, void (*handler)(void *data));
 557     void (*send_event)(unsigned short id, void *data);
 558
 559 #if (CONFIG_PLATFORM & PLATFORM_HOSTED)
 560     /* special simulator hooks */
 561 #if defined(HAVE_LCD_BITMAP) && LCD_DEPTH < 8
 562     void (*sim_lcd_ex_init)(unsigned long (*getpixel)(int, int));
 563     void (*sim_lcd_ex_update_rect)(int x, int y, int width, int height);
 564 #endif
 565 #endif
 566
 567     /* strings and memory */
 568     int (*snprintf)(char *buf, size_t size, const char *fmt, ...)
 569                     ATTRIBUTE_PRINTF(3, 4);
 570     int (*vsnprintf)(char *buf, size_t size, const char *fmt, va_list ap);
 571     char* (*strcpy)(char *dst, const char *src);
 572     size_t (*strlcpy)(char *dst, const char *src, size_t length);
 573     size_t (*strlen)(const char *str);
 574     char * (*strrchr)(const char *s, int c);
 575     int (*strcmp)(const char *, const char *);
 576     int (*strncmp)(const char *, const char *, size_t);
 577     int (*strcasecmp)(const char *, const char *);
 578     int (*strncasecmp)(const char *s1, const char *s2, size_t n);
 579     void* (*memset)(void *dst, int c, size_t length);
 580     void* (*memcpy)(void *out, const void *in, size_t n);
 581     void* (*memmove)(void *out, const void *in, size_t n);
 582 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 583     const unsigned char *_rbctype_;
 584 #endif
 585     int (*atoi)(const char *str);
 586     char *(*strchr)(const char *s, int c);
 587     char *(*strcat)(char *s1, const char *s2);
 588     size_t (*strlcat)(char *dst, const char *src, size_t length);
 589     void *(*memchr)(const void *s1, int c, size_t n);
 590     int (*memcmp)(const void *s1, const void *s2, size_t n);
 591     char *(*strcasestr) (const char* phaystack, const char* pneedle);
 592     char* (*strtok_r)(char *ptr, const char *sep, char **end);
 593     /* unicode stuff */
 594     const unsigned char* (*utf8decode)(const unsigned char *utf8, unsigned short *ucs);
 595     unsigned char* (*iso_decode)(const unsigned char *iso, unsigned char *utf8, int cp, int count);
 596     unsigned char* (*utf16LEdecode)(const unsigned char *utf16, unsigned char *utf8, int count);
 597     unsigned char* (*utf16BEdecode)(const unsigned char *utf16, unsigned char *utf8, int count);
 598     unsigned char* (*utf8encode)(unsigned long ucs, unsigned char *utf8);
 599     unsigned long (*utf8length)(const unsigned char *utf8);
 600     int (*utf8seek)(const unsigned char* utf8, int offset);
 601
 602     /* sound */
 603     void (*sound_set)(int setting, int value);
 604     int (*sound_default)(int setting);
 605     int (*sound_min)(int setting);
 606     int (*sound_max)(int setting);
 607     const char * (*sound_unit)(int setting);
 608     int (*sound_val2phys)(int setting, int value);
 609 #ifdef AUDIOHW_HAVE_EQ
 610     int (*sound_enum_hw_eq_band_setting)(unsigned int band,
 611                                          unsigned int band_setting);
 612 #endif /* AUDIOHW_HAVE_EQ */
 613 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 614     void (*mp3_play_data)(const unsigned char* start, int size,
 615                           void (*get_more)(unsigned char** start, size_t* size));
 616     void (*mp3_play_pause)(bool play);
 617     void (*mp3_play_stop)(void);
 618     bool (*mp3_is_playing)(void);
 619 #if CONFIG_CODEC != SWCODEC
 620     void (*bitswap)(unsigned char *data, int length);
 621 #endif
 622 #endif /* PLATFORM_NATIVE */
 623 #if CONFIG_CODEC == SWCODEC
 624     const unsigned long *audio_master_sampr_list;
 625     const unsigned long *hw_freq_sampr;
 626     void (*pcm_apply_settings)(void);
 627     void (*pcm_play_data)(pcm_play_callback_type get_more,
 628             unsigned char* start, size_t size);
 629     void (*pcm_play_stop)(void);
 630     void (*pcm_set_frequency)(unsigned int frequency);
 631     bool (*pcm_is_playing)(void);
 632     bool (*pcm_is_paused)(void);
 633     void (*pcm_play_pause)(bool play);
 634     size_t (*pcm_get_bytes_waiting)(void);
 635     void (*pcm_calculate_peaks)(int *left, int *right);
 636     const void* (*pcm_get_peak_buffer)(int *count);
 637     void (*pcm_play_lock)(void);
 638     void (*pcm_play_unlock)(void);
 639     void (*beep_play)(unsigned int frequency, unsigned int duration,
 640                       unsigned int amplitude);
 641 #ifdef HAVE_RECORDING
 642     const unsigned long *rec_freq_sampr;
 643     void (*pcm_init_recording)(void);
 644     void (*pcm_close_recording)(void);
 645     void (*pcm_record_data)(pcm_rec_callback_type more_ready,
 646                             void *start, size_t size);
 647     void (*pcm_stop_recording)(void);
 648     void (*pcm_calculate_rec_peaks)(int *left, int *right);
 649     void (*audio_set_recording_gain)(int left, int right, int type);
 650 #endif /* HAVE_RECORDING */
 651 #if INPUT_SRC_CAPS != 0
 652     void (*audio_set_output_source)(int monitor);
 653     void (*audio_set_input_source)(int source, unsigned flags);
 654 #endif
 655     void (*dsp_set_crossfeed)(bool enable);
 656     void (*dsp_set_eq)(bool enable);
 657     void (*dsp_dither_enable)(bool enable);
 658     intptr_t (*dsp_configure)(struct dsp_config *dsp, int setting,
 659                               intptr_t value);
 660     int (*dsp_process)(struct dsp_config *dsp, char *dest,
 661                        const char *src[], int count);
 662     int (*dsp_input_count)(struct dsp_config *dsp, int count);
 663     int (*dsp_output_count)(struct dsp_config *dsp, int count);
 664 #endif /* CONFIG_CODEC == SWCODC */
 665
 666     /* playback control */
 667     int (*playlist_amount)(void);
 668     int (*playlist_resume)(void);
 669     void (*playlist_start)(int start_index, int offset);
 670     int (*playlist_add)(const char *filename);
 671     void (*playlist_sync)(struct playlist_info* playlist);
 672     int (*playlist_remove_all_tracks)(struct playlist_info *playlist);
 673     int (*playlist_create)(const char *dir, const char *file);
 674     int (*playlist_insert_track)(struct playlist_info* playlist,
 675             const char *filename, int position, bool queue, bool sync);
 676     int (*playlist_insert_directory)(struct playlist_info* playlist,
 677                               const char *dirname, int position, bool queue,
 678                               bool recurse);
 679     int (*playlist_shuffle)(int random_seed, int start_index);
 680     void (*audio_play)(long offset);
 681     void (*audio_stop)(void);
 682     void (*audio_pause)(void);
 683     void (*audio_resume)(void);
 684     void (*audio_next)(void);
 685     void (*audio_prev)(void);
 686     void (*audio_ff_rewind)(long newtime);
 687     struct mp3entry* (*audio_next_track)(void);
 688     int (*audio_status)(void);
 689     struct mp3entry* (*audio_current_track)(void);
 690     void (*audio_flush_and_reload_tracks)(void);
 691     int (*audio_get_file_pos)(void);
 692 #if !defined(SIMULATOR) && (CONFIG_CODEC != SWCODEC)
 693     unsigned long (*mpeg_get_last_header)(void);
 694 #endif
 695 #if ((CONFIG_CODEC == MAS3587F) || (CONFIG_CODEC == MAS3539F) || \
 696      (CONFIG_CODEC == SWCODEC)) && defined (HAVE_PITCHSCREEN)
 697     void (*sound_set_pitch)(int32_t pitch);
 698 #endif
 699
 700     /* MAS communication */
 701 #if !defined(SIMULATOR) && (CONFIG_CODEC != SWCODEC)
 702     int (*mas_readmem)(int bank, int addr, unsigned long* dest, int len);
 703     int (*mas_writemem)(int bank, int addr, const unsigned long* src, int len);
 704     int (*mas_readreg)(int reg);
 705     int (*mas_writereg)(int reg, unsigned int val);
 706 #if (CONFIG_CODEC == MAS3587F) || (CONFIG_CODEC == MAS3539F)
 707     int (*mas_codec_writereg)(int reg, unsigned int val);
 708     int (*mas_codec_readreg)(int reg);
 709     void (*i2c_begin)(void);
 710     void (*i2c_end)(void);
 711     int  (*i2c_write)(int address, const unsigned char* buf, int count );
 712 #endif
 713 #endif
 714
 715     /* menu */
 716     int (*do_menu)(const struct menu_item_ex *menu, int *start_selected,
 717                    struct viewport parent[NB_SCREENS], bool hide_theme);
 718
 719     /* scroll bar */
 720     struct gui_syncstatusbar *statusbars;
 721     void (*gui_syncstatusbar_draw)(struct gui_syncstatusbar * bars, bool force_redraw);
 722
 723     /* options */
 724     const struct settings_list* (*get_settings_list)(int*count);
 725     const struct settings_list* (*find_setting)(const void* variable, int *id);
 726     bool (*option_screen)(const struct settings_list *setting,
 727                           struct viewport parent[NB_SCREENS],
 728                           bool use_temp_var, unsigned char* option_title);
 729     bool (*set_option)(const char* string, const void* variable,
 730                        enum optiontype type, const struct opt_items* options,
 731                        int numoptions, void (*function)(int));
 732     bool (*set_bool_options)(const char* string, const bool* variable,
 733                              const char* yes_str, int yes_voice,
 734                              const char* no_str, int no_voice,
 735                              void (*function)(bool));
 736     bool (*set_int)(const unsigned char* string, const char* unit, int voice_unit,
 737                     const int* variable, void (*function)(int), int step,
 738                     int min, int max,
 739                     const char* (*formatter)(char*, size_t, int, const char*) );
 740     bool (*set_bool)(const char* string, const bool* variable );
 741
 742 #ifdef HAVE_LCD_COLOR
 743     bool (*set_color)(struct screen *display, char *title,
 744                       unsigned *color, unsigned banned_color);
 745 #endif
 746     /* action handling */
 747     int (*get_custom_action)(int context,int timeout,
 748                           const struct button_mapping* (*get_context_map)(int));
 749     int (*get_action)(int context, int timeout);
 750 #ifdef HAVE_TOUCHSCREEN
 751     int (*action_get_touchscreen_press)(short *x, short *y);
 752 #endif
 753     bool (*action_userabort)(int timeout);
 754
 755     /* power */
 756     int (*battery_level)(void);
 757     bool (*battery_level_safe)(void);
 758     int (*battery_time)(void);
 759 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 760     unsigned int (*battery_voltage)(void);
 761 #endif
 762 #if CONFIG_CHARGING
 763     bool (*charger_inserted)(void);
 764 # if CONFIG_CHARGING >= CHARGING_MONITOR
 765     bool (*charging_state)(void);
 766 # endif
 767 #endif
 768 #ifdef HAVE_USB_POWER
 769     bool (*usb_powered)(void);
 770 #endif
 771
 772     /* misc */
 773 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 774     int* __errno;
 775 #endif
 776     void (*srand)(unsigned int seed);
 777     int  (*rand)(void);
 778     void (*qsort)(void *base, size_t nmemb, size_t size,
 779                   int(*compar)(const void *, const void *));
 780     int (*kbd_input)(char* buffer, int buflen);
 781     struct tm* (*get_time)(void);
 782     int  (*set_time)(const struct tm *tm);
 783 #if CONFIG_RTC
 784     time_t (*mktime)(struct tm *t);
 785 #endif
 786     void* (*plugin_get_buffer)(size_t *buffer_size);
 787     void* (*plugin_get_audio_buffer)(size_t *buffer_size);
 788     void (*plugin_tsr)(bool (*exit_callback)(bool reenter));
 789     char* (*plugin_get_current_filename)(void);
 790 #if defined(DEBUG) || defined(SIMULATOR)
 791     void (*debugf)(const char *fmt, ...) ATTRIBUTE_PRINTF(1, 2);
 792 #endif
 793 #ifdef ROCKBOX_HAS_LOGF
 794     void (*logf)(const char *fmt, ...) ATTRIBUTE_PRINTF(1, 2);
 795 #endif
 796     struct user_settings* global_settings;
 797     struct system_status *global_status;
 798     void (*talk_disable)(bool disable);
 799 #if CONFIG_CODEC == SWCODEC
 800     void (*codec_thread_do_callback)(void (*fn)(void),
 801                                      unsigned int *audio_thread_id);
 802     int (*codec_load_file)(const char* codec, struct codec_api *api);
 803     int (*codec_run_proc)(void);
 804     int (*codec_close)(void);
 805     const char *(*get_codec_filename)(int cod_spec);
 806     void ** (*find_array_ptr)(void **arr, void *ptr);
 807     int (*remove_array_ptr)(void **arr, void *ptr);
 808     int (*round_value_to_list32)(unsigned long value,
 809                                  const unsigned long list[],
 810                                  int count,
 811                                  bool signd);
 812 #endif /* CONFIG_CODEC == SWCODEC */
 813     bool (*get_metadata)(struct mp3entry* id3, int fd, const char* trackname);
 814     bool (*mp3info)(struct mp3entry *entry, const char *filename);
 815     int (*count_mp3_frames)(int fd, int startpos, int filesize,
 816                             void (*progressfunc)(int));
 817     int (*create_xing_header)(int fd, long startpos, long filesize,
 818             unsigned char *buf, unsigned long num_frames,
 819             unsigned long rec_time, unsigned long header_template,
 820             void (*progressfunc)(int), bool generate_toc);
 821     unsigned long (*find_next_frame)(int fd, long *offset,
 822             long max_offset, unsigned long reference_header);
 823
 824 #if (CONFIG_CODEC == MAS3587F) || (CONFIG_CODEC == MAS3539F)
 825     unsigned short (*peak_meter_scale_value)(unsigned short val,
 826                                              int meterwidth);
 827     void (*peak_meter_set_use_dbfs)(bool use);
 828     bool (*peak_meter_get_use_dbfs)(void);
 829 #endif
 830 #ifdef HAVE_LCD_BITMAP
 831     int (*read_bmp_file)(const char* filename, struct bitmap *bm, int maxsize,
 832                          int format, const struct custom_format *cformat);
 833     int (*read_bmp_fd)(int fd, struct bitmap *bm, int maxsize,
 834                        int format, const struct custom_format *cformat);
 835 #ifdef HAVE_JPEG
 836     int (*read_jpeg_file)(const char* filename, struct bitmap *bm, int maxsize,
 837                           int format, const struct custom_format *cformat);
 838     int (*read_jpeg_fd)(int fd, struct bitmap *bm, int maxsize,
 839                         int format, const struct custom_format *cformat);
 840 #endif
 841     void (*screen_dump_set_hook)(void (*hook)(int fh));
 842 #endif
 843     int (*show_logo)(void);
 844     struct tree_context* (*tree_get_context)(void);
 845     void (*set_current_file)(const char* path);
 846     void (*set_dirfilter)(int l_dirfilter);
 847
 848 #ifdef HAVE_WHEEL_POSITION
 849     int (*wheel_status)(void);
 850     void (*wheel_send_events)(bool send);
 851 #endif
 852
 853 #ifdef IRIVER_H100_SERIES
 854     /* Routines for the iriver_flash -plugin. */
 855     bool (*detect_original_firmware)(void);
 856     bool (*detect_flashed_ramimage)(void);
 857     bool (*detect_flashed_romimage)(void);
 858 #endif
 859
 860     void (*led)(bool on);
 861
 862 #if (CONFIG_CODEC == SWCODEC)
 863     /* buffering API */
 864     int (*bufopen)(const char *file, size_t offset, enum data_type type,
 865                    void *user_data);
 866     int (*bufalloc)(const void *src, size_t size, enum data_type type);
 867     bool (*bufclose)(int handle_id);
 868     int (*bufseek)(int handle_id, size_t newpos);
 869     int (*bufadvance)(int handle_id, off_t offset);
 870     ssize_t (*bufread)(int handle_id, size_t size, void *dest);
 871     ssize_t (*bufgetdata)(int handle_id, size_t size, void **data);
 872     ssize_t (*bufgettail)(int handle_id, size_t size, void **data);
 873     ssize_t (*bufcuttail)(int handle_id, size_t size);
 874
 875     ssize_t (*buf_handle_offset)(int handle_id);
 876     void (*buf_set_base_handle)(int handle_id);
 877     size_t (*buf_used)(void);
 878 #endif
 879
 880 #ifdef HAVE_TAGCACHE
 881     bool (*tagcache_search)(struct tagcache_search *tcs, int tag);
 882     void (*tagcache_search_set_uniqbuf)(struct tagcache_search *tcs,
 883            void *buffer, long length);
 884     bool (*tagcache_search_add_filter)(struct tagcache_search *tcs,
 885                                     int tag, int seek);
 886     bool (*tagcache_get_next)(struct tagcache_search *tcs);
 887     bool (*tagcache_retrieve)(struct tagcache_search *tcs, int idxid,
 888                            int tag, char *buf, long size);
 889     void (*tagcache_search_finish)(struct tagcache_search *tcs);
 890     long (*tagcache_get_numeric)(const struct tagcache_search *tcs, int tag);
 891 #if defined(HAVE_TC_RAMCACHE) && defined(HAVE_DIRCACHE)
 892     bool (*tagcache_fill_tags)(struct mp3entry *id3, const char *filename);
 893 #endif
 894 #endif
 895
 896 #ifdef HAVE_ALBUMART
 897     bool (*search_albumart_files)(const struct mp3entry *id3, const char *size_string,
 898                                   char *buf, int buflen);
 899 #endif
 900
 901 #ifdef HAVE_SEMAPHORE_OBJECTS
 902     void (*semaphore_init)(struct semaphore *s, int max, int start);
 903     int  (*semaphore_wait)(struct semaphore *s, int timeout);
 904     void (*semaphore_release)(struct semaphore *s);
 905 #endif
 906
 907     const char *rbversion;
 908
 909     /* new stuff at the end, sort into place next time
 910        the API gets incompatible */
 911 #if CONFIG_CODEC == SWCODEC
 912     enum channel_status (*mixer_channel_status)(enum pcm_mixer_channel channel);
 913     void * (*mixer_channel_get_buffer)(enum pcm_mixer_channel channel, int *count);
 914     void (*mixer_channel_calculate_peaks)(enum pcm_mixer_channel channel,
 915                                           int *left, int *right);
 916     void (*mixer_channel_play_data)(enum pcm_mixer_channel channel,
 917                                     pcm_play_callback_type get_more,
 918                                     unsigned char *start, size_t size);
 919     void (*mixer_channel_play_pause)(enum pcm_mixer_channel channel, bool play);
 920     void (*mixer_channel_stop)(enum pcm_mixer_channel channel);
 921     void (*mixer_channel_set_amplitude)(enum pcm_mixer_channel channel,
 922                                         unsigned int amplitude);
 923     size_t (*mixer_channel_get_bytes_waiting)(enum pcm_mixer_channel channel);
 924     void (*system_sound_play)(enum system_sound sound);
 925     void (*keyclick_click)(int button);
 926 #endif
 927 };
 928
 929 /* plugin header */
 930 struct plugin_header {
 931     struct lc_header lc_hdr; /* must be the first */
 932     enum plugin_status(*entry_point)(const void*);
 933     const struct plugin_api **api;
 934 };
 935
 936 #ifdef PLUGIN
 937 #if (CONFIG_PLATFORM & PLATFORM_NATIVE)
 938 extern unsigned char plugin_start_addr[];
 939 extern unsigned char plugin_end_addr[];
 940 #define PLUGIN_HEADER \
 941         const struct plugin_api *rb DATA_ATTR; \
 942         const struct plugin_header __header \
 943         __attribute__ ((section (".header")))= { \
 944         { PLUGIN_MAGIC, TARGET_ID, PLUGIN_API_VERSION, \
 945         plugin_start_addr, plugin_end_addr }, plugin__start, &rb };
 946 #else /* PLATFORM_HOSTED */
 947 #define PLUGIN_HEADER \
 948         const struct plugin_api *rb DATA_ATTR; \
 949         const struct plugin_header __header \
 950         __attribute__((visibility("default"))) = { \
 951         { PLUGIN_MAGIC, TARGET_ID, PLUGIN_API_VERSION, NULL, NULL }, \
 952         plugin__start, &rb };
 953 #endif /* CONFIG_PLATFORM */
 954 #endif /* PLUGIN */
 955
 956 int plugin_load(const char* plugin, const void* parameter);
 957 void* plugin_get_audio_buffer(size_t *buffer_size);
 958
 959 /* plugin_tsr,
 960     callback returns true to allow the new plugin to load,
 961     reenter means the currently running plugin is being reloaded */
 962 void plugin_tsr(bool (*exit_callback)(bool reenter));
 963
 964 /* defined by the plugin */
 965 extern const struct plugin_api *rb;
 966 enum plugin_status plugin__start(const void* parameter)
 967     NO_PROF_ATTR;
 968
 969 #endif /* __PCTOOL__ */
 970 #endif