release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Wiki > Main > HowtoVerifyPlugins (compare)

Difference: HowtoVerifyPlugins (r13 vs. r12)

How to verify plugins

Cross platform coding

A plugin has to work on all supported platforms. Besides some 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 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 FS#6616maze FS#6636Spider Solitaire FS#6599
SIM DONEDONE  
recorder DONEDONE  
e200 DONEDONE  
gigabeat DONEDONEDONE
h10_5gb DONEDONE  
h10 DONEDONE  
h120 DONEDONE  
h300     DONE
ipod3g DONEDONE  
ipodcolor DONEDONEDONE
ipodmini DONEDONE  
ipodnano DONEDONE  
ipodvideo DONEDONEDONE
HW      
recorder DONEDONE  
e200 DONEDONE  
gigabeat      
h10_5gb      
h10      
h120      
h300     DONE
ipod3g      
ipodcolor      
ipodmini      
ipodnano      
ipodvideo DONEDONE  

r13 - 06 Aug 2009 - 17:22:10 - MaurusCuelenaere

Revision r13 - 06 Aug 2009 - 17:22 - MaurusCuelenaere
Revision r12 - 16 Jul 2009 - 07:03 - ChristopheGragnic
Copyright by the contributing authors.