HowtoVerifyPlugins < Main

Downloads
release
dev builds
extras
themes
Documentation
manual
wiki
device status
Support
forums
mailing lists
IRC
Development
bugs
patches
dev guide
Donate
Wiki > Main > HowtoWritePlugins > HowtoVerifyPlugins
---+!! How to verify plugins

%TOC%

---++ Cross platform coding

A [[PluginIndex][plugin]] has to work on all supported platforms. Besides some [[http://svn.rockbox.org/viewvc.cgi/trunk/docs/CONTRIBUTING][coding conventions]] the following topics have to be considered for plugin coding:
   * Display
      * Display height/width (=LCD_HEIGHT/LCD_WIDTH=) ranging from 112x64 to 320x240
      * color capabilities (=HAVE_COLOR_LCD=)
      * levels of bits per color/greyscale (=LCD_DEPTH=)
      * check if background colors, background light and backdrop images are handled correctly in the plugin
   * Buttons
      * usage of unified button handling makes life a lot easier (and code more compact). See =rockbox/apps/plugins/lib/pluginlib_actions.h= and its usage in some plugins for reference.
   * OS
      * Is there any =rb->yield()= in the code?

   * Find more platform specific properties in ==rockbox/firmware/export/config-target.h==
   * Some of the issues can be solve by putting the plugin source file in the correct section in ==rockbox/apps/plugins/SOURCES==.
   * ARM, MIPS and SH require aligned memory accesses (Coldfire doesn't), and on ARM, the "char" type is signed by default, but unsigned on most other platforms.
   * Plugins should make use of the plugin api where possible. eg. the menu api should be used for all plugins (see ==rockbox/apps/plugins/solitaire.c==)


---++ Cross platform verification
Make sure that the plugin works on the following platforms (platform specific issues to be completed)
   * DISPLAY (only HAVE_BITMAP listed here)
      * Mono (1bpp)
         * 112x64 mono: check one of =fmrecorder, ondiofm, ondiosp, recorder, recorderv2=
      * Greyscale (2bpp)
         * 138x110: check one of =ipodmini, ipodmini2g=
         * 160x128: check one of =ipod3g, ipod4g, h100, h120=
      * Colour (16bpp)
         * 128x128: check =h10_5gb=
         * 160x128: check one of =h10, iaudiox5=
         * 176x132: check =ipodnano=
         * 176x220: check =e200=
         * 220x176:  check one of =h300, ipodcolor=
         * 320x240: check =ipodvideo=
         * 240x320: check =gigabeat=

---++ List of plugins currently under verification

|       | *rocklife* [[http://www.rockbox.org/tracker/task/6616][FS#6616]] | *maze* [[http://www.rockbox.org/tracker/task/6636][FS#6636]] | *Spider Solitaire* [[http://www.rockbox.org/tracker/task/6599][FS#6599]] |
| *SIM* |   %Y%  |  %Y%  |  |
| recorder |   %Y%   |  %Y%  | |
| e200 |   %Y%   |  %Y%  | |
| gigabeat |   %Y%   |  %Y%  |  %Y%  |
| h10_5gb |  %Y%    |  %Y%  | |
| h10 |   %Y%   |  %Y%  | |
| h120 |  %Y%    |  %Y%  | |
| h300 | | |   %Y%  |
| ipod3g |   %Y%   |  %Y%  | |
| ipodcolor |   %Y%   |  %Y%  |  %Y%  |
| ipodmini |   %Y%   |  %Y%  | |
| ipodnano |  %Y%    |  %Y%  | |
| ipodvideo |   %Y%   |  %Y%  |  %Y%  |
| *HW* |      |    | |
| recorder |   %Y%   |  %Y%  | |
| e200 |  %Y%    |  %Y%  | |
| gigabeat |      |    | |
| h10_5gb |      |    | |
| h10 |      |    | |
| h120 |      |    | |
| h300 | | |  %Y%  |
| ipod3g |      |    | |
| ipodcolor |      |    | |
| ipodmini |      |    | |
| ipodnano |      |    | |
| ipodvideo |   %Y%   |  %Y%  | |
r13 - 06 Aug 2009 - 17:22:10 - MaurusCuelenaere
Parents: HowtoWritePlugins