forked from len0rd/rockbox
moved these files to /docs
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@1867 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Robert Hak
parent
71f2567f10
commit
e532316e92
4 changed files with 0 additions and 379 deletions
276
firmware/API
276
firmware/API
|
|
@ -1,276 +0,0 @@
|
||||||
$Id$
|
|
||||||
__________ __ ___.
|
|
||||||
Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
||||||
Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
||||||
Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
||||||
Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
||||||
\/ \/ \/ \/ \/
|
|
||||||
|
|
||||||
API summmary
|
|
||||||
|
|
||||||
[ This is still pretty rough and basic. Extend! ]
|
|
||||||
|
|
||||||
LCD
|
|
||||||
|
|
||||||
#include <lcd.h>
|
|
||||||
|
|
||||||
Generic
|
|
||||||
|
|
||||||
Most LCD functions are specific for which output we work with, due to the
|
|
||||||
huge differences.
|
|
||||||
|
|
||||||
lcd_init() - init the LCD stuff
|
|
||||||
lcd_clear_display() - clear the whole display
|
|
||||||
lcd_backlight(on) - set backlight on/off
|
|
||||||
lcd_puts(x,y,string) write a string at given character position
|
|
||||||
|
|
||||||
Recorder
|
|
||||||
|
|
||||||
All the functions operate on a display buffer. You make the buffer get
|
|
||||||
shown on screen by calling lcd_update().
|
|
||||||
|
|
||||||
lcd_update() update the LCD according to the internal buffer.
|
|
||||||
|
|
||||||
|
|
||||||
lcd_update_rect(int x, int y, int height, int width)
|
|
||||||
|
|
||||||
Update the given rectangle to the LCD. Give arguments measured in
|
|
||||||
pixels. Notice that the smallest vertical resolution in updates that the
|
|
||||||
hardware supports is even 8 pixels. This function will adjust to those.
|
|
||||||
|
|
||||||
lcd_setfont(int font) set default font
|
|
||||||
lcd_setmargins(int x, int y) set top/left margins
|
|
||||||
lcd_putsxy(x,y,string,font) put a string at given position, using a
|
|
||||||
specific font
|
|
||||||
lcd_bitmap(src,x,y,width,height,clear) put a bitmap at given position
|
|
||||||
lcd_clearrect(x,y,width,height) clear a rectangle area
|
|
||||||
lcd_fillrect(x,y,width,height) fill a rectangle area
|
|
||||||
lcd_drawrect(x,y,width,height) draw a rectangle
|
|
||||||
lcd_invertrect(x,y,width,height) revert the graphics of the given area
|
|
||||||
lcd_drawline(x1,y1,x2,y2) draw a line between the coordinates
|
|
||||||
lcd_drawpixel(x,y) put a pixel on the given coordinate
|
|
||||||
lcd_clearpixel(x,y) clear the pixel at the given coordinate
|
|
||||||
lcd_fontsize(font,width,height) return the width and height of the font
|
|
||||||
|
|
||||||
Player
|
|
||||||
|
|
||||||
lcd_define_pattern(which,pattern,lenth) define a custom pattern
|
|
||||||
|
|
||||||
Buttons
|
|
||||||
|
|
||||||
#include <button.h>
|
|
||||||
|
|
||||||
These functions work the same regardless of which keypad you have, but they
|
|
||||||
return a different set of values. Note that the Recorder keypad has 10
|
|
||||||
keys, while the Player keypad only features 6.
|
|
||||||
|
|
||||||
int button_get(bool block)
|
|
||||||
|
|
||||||
Returns a bitmask for which keys were pressed. If 'block' is set TRUE it
|
|
||||||
won't return until a key is pressed.
|
|
||||||
|
|
||||||
Files
|
|
||||||
|
|
||||||
(These functions are POSIX look-alikes)
|
|
||||||
|
|
||||||
#include <file.h>
|
|
||||||
|
|
||||||
int open(const char *path, int oflag);
|
|
||||||
|
|
||||||
The open() function establishes the connection between a file and a file
|
|
||||||
descriptor. It creates an open file descrip- tion that refers to a file
|
|
||||||
and a file descriptor that refers to that open file description. The file
|
|
||||||
descriptor is used by other I/O functions to refer to that file.
|
|
||||||
|
|
||||||
int read(int fildes, void *buf, size_t nbyte);
|
|
||||||
|
|
||||||
The read() function attempts to read nbyte bytes from the file associated
|
|
||||||
with the open file descriptor, fildes, into the buffer pointed to by buf.
|
|
||||||
|
|
||||||
int lseek(int fildes, off_t offset, int whence);
|
|
||||||
|
|
||||||
The lseek() function sets the file pointer associated with the open file
|
|
||||||
descriptor specified by fildes as follows:
|
|
||||||
|
|
||||||
o If whence is SEEK_SET, the pointer is set to offset
|
|
||||||
bytes.
|
|
||||||
|
|
||||||
o If whence is SEEK_CUR, the pointer is set to its
|
|
||||||
current location plus offset.
|
|
||||||
|
|
||||||
o If whence is SEEK_END, the pointer is set to the size
|
|
||||||
of the file plus offset.
|
|
||||||
|
|
||||||
int write(int fildes, const void *buf, size_t nbyte);
|
|
||||||
|
|
||||||
NOT CURRENTLY SUPPORTED.
|
|
||||||
|
|
||||||
write writes up to count bytes to the file referenced by the file
|
|
||||||
descriptor fd from the buffer starting at buf.
|
|
||||||
|
|
||||||
int close(int fildes);
|
|
||||||
|
|
||||||
The close() function will deallocate the file descriptor indicated by
|
|
||||||
fildes. To deallocate means to make the file descriptor available for
|
|
||||||
return by subsequent calls to open(2) or other functions that allocate
|
|
||||||
file descriptors.
|
|
||||||
|
|
||||||
int rename(const char *old, const char *new);
|
|
||||||
|
|
||||||
NOT CURRENTLY SUPPORTED.
|
|
||||||
|
|
||||||
The rename() function changes the name of a file. The old argument points
|
|
||||||
to the pathname of the file to be renamed. The new argument points to the
|
|
||||||
new pathname of the file.
|
|
||||||
|
|
||||||
int remove(const char *pathname);
|
|
||||||
|
|
||||||
NOT CURRENTLY SUPPORTED.
|
|
||||||
|
|
||||||
remove deletes a name from the filesystem. It calls unlink for files,
|
|
||||||
and rmdir for directories.
|
|
||||||
|
|
||||||
|
|
||||||
Directories
|
|
||||||
|
|
||||||
#include <dir.h>
|
|
||||||
|
|
||||||
DIR *opendir(const char *name);
|
|
||||||
|
|
||||||
The opendir() function opens a directory stream corresponding to the
|
|
||||||
directory name, and returns a pointer to the directory stream. The
|
|
||||||
stream is positioned at the first entry in the directory.
|
|
||||||
|
|
||||||
struct dirent *readdir(DIR *dir);
|
|
||||||
|
|
||||||
The readdir() function returns a pointer to a dirent structure
|
|
||||||
representing the next directory entry in the directory stream pointed to
|
|
||||||
by dir. It returns NULL on reaching the end-of-file or if an error
|
|
||||||
occurred.
|
|
||||||
|
|
||||||
Add a description of the struct here.
|
|
||||||
|
|
||||||
int closedir(DIR *dir);
|
|
||||||
|
|
||||||
The closedir() function closes the directory stream associated with dir.
|
|
||||||
The directory stream descriptor dir is not available after this call.
|
|
||||||
|
|
||||||
|
|
||||||
String/Memory
|
|
||||||
|
|
||||||
#include <string.h>
|
|
||||||
|
|
||||||
strcmp()
|
|
||||||
strcpy()
|
|
||||||
memcpy()
|
|
||||||
memset()
|
|
||||||
...
|
|
||||||
|
|
||||||
Memory allocation
|
|
||||||
|
|
||||||
#include <dmalloc.h>
|
|
||||||
|
|
||||||
void *malloc(size_t size);
|
|
||||||
|
|
||||||
malloc() allocates size bytes and returns a pointer to the allocated
|
|
||||||
memory. The memory is not cleared.
|
|
||||||
|
|
||||||
void free(void *ptr);
|
|
||||||
|
|
||||||
free() frees the memory space pointed to by ptr, which must have been
|
|
||||||
returned by a previous call to malloc(), calloc() or realloc().
|
|
||||||
Otherwise, or if free(ptr) has already been called before, undefined
|
|
||||||
behaviour occurs.
|
|
||||||
|
|
||||||
void *realloc(void *ptr, size_t size);
|
|
||||||
|
|
||||||
realloc() changes the size of the memory block pointed to by ptr to size
|
|
||||||
bytes. The contents will be unchanged to the minimum of the old and new
|
|
||||||
sizes; newly allocated memory will be uninitialized. If ptr is NULL, the
|
|
||||||
call is equivalent to malloc(size); if size is equal to zero, the call is
|
|
||||||
equivalent to free(ptr). Unless ptr is NULL, it must have been returned
|
|
||||||
by an earlier call to malloc(), calloc() or realloc().
|
|
||||||
|
|
||||||
void *calloc(size_t nmemb, size_t size);
|
|
||||||
|
|
||||||
calloc() allocates memory for an array of nmemb elements of size bytes
|
|
||||||
each and returns a pointer to the allocated memory. The memory is set to
|
|
||||||
zero.
|
|
||||||
|
|
||||||
ID3
|
|
||||||
|
|
||||||
#include <id3.h>
|
|
||||||
bool mp3info(mp3entry *entry, char *filename);
|
|
||||||
|
|
||||||
Return FALSE if successful. The given mp3entry is then filled in with
|
|
||||||
whatever id3 info it could find about the given file.
|
|
||||||
|
|
||||||
Various
|
|
||||||
|
|
||||||
#include <kernel.h>
|
|
||||||
|
|
||||||
void kernel_init(void)
|
|
||||||
|
|
||||||
Inits the kernel and starts the tick interrupt
|
|
||||||
|
|
||||||
void sleep(ticks)
|
|
||||||
|
|
||||||
Sleep a specified number of ticks, we have HZ ticks per second.
|
|
||||||
|
|
||||||
void yield(void)
|
|
||||||
|
|
||||||
Let another thread run. This should be used as soon as you have to "wait"
|
|
||||||
for something or similar, and also if you do anything that takes "a long
|
|
||||||
time". This function is the entire foundation that our "cooperative
|
|
||||||
multitasking" is based on. Use it.
|
|
||||||
|
|
||||||
int set_irq_level(int level)
|
|
||||||
|
|
||||||
Sets the interrupt level (0 = lowest, 15 = highest) and returns the
|
|
||||||
previous level.
|
|
||||||
|
|
||||||
void queue_init(struct event_queue *q)
|
|
||||||
|
|
||||||
Initialize an event queue. The maximum number of events in a queue is
|
|
||||||
QUEUE_LENGTH-1.
|
|
||||||
|
|
||||||
void queue_wait(struct event_queue *q, struct event *ev)
|
|
||||||
|
|
||||||
Receive an event in a queue, blocking the thread if the queue is empty.
|
|
||||||
|
|
||||||
void queue_post(struct event_queue *q, int id, void *data)
|
|
||||||
|
|
||||||
Post an event to a queue.
|
|
||||||
NOTE: Negative event ID's are for system use only!!!
|
|
||||||
|
|
||||||
bool queue_empty(struct event_queue* q)
|
|
||||||
|
|
||||||
Returns true if the queue is empty.
|
|
||||||
|
|
||||||
int queue_broadcast(int id, void *data)
|
|
||||||
|
|
||||||
Posts an event in all queues that has been initiated with queue_init().
|
|
||||||
Returns the number of queues that were posted to.
|
|
||||||
|
|
||||||
int tick_add_task(void (*f)(void))
|
|
||||||
|
|
||||||
Add a task to the tick task queue. The argument is a pointer to a
|
|
||||||
function that will be called every tick interrupt.
|
|
||||||
At most MAX_NUM_TICK_TASKS can be active at the same time.
|
|
||||||
|
|
||||||
int tick_remove_task(void (*f)(void))
|
|
||||||
|
|
||||||
Remove a task from the task queue.
|
|
||||||
|
|
||||||
void mutex_init(struct mutex *m)
|
|
||||||
|
|
||||||
Initialize a mutex.
|
|
||||||
|
|
||||||
void mutex_lock(struct mutex *m)
|
|
||||||
|
|
||||||
Lock a mutex. This will block the thread if the mutex is already locked.
|
|
||||||
Note that you will geta deadlock if you lock the mutex twice!
|
|
||||||
|
|
||||||
void mutex_unlock(struct mutex *m)
|
|
||||||
|
|
||||||
Unlock a mutex.
|
|
||||||
|
|
@ -1,25 +0,0 @@
|
||||||
/*
|
|
||||||
* Config template file. Contains and describes all possibile config
|
|
||||||
* items. Don't actually use this file, this is plain documentation.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/* define this if you have recording possibility */
|
|
||||||
#define HAVE_RECORDING 1
|
|
||||||
|
|
||||||
/* define this if you have a bitmap LCD display */
|
|
||||||
#define HAVE_LCD_BITMAP 1
|
|
||||||
|
|
||||||
/* define this if you have a charcell LCD display */
|
|
||||||
#define HAVE_LCD_CHARCELLS 1
|
|
||||||
|
|
||||||
/* define this if you have a post-4.50 charcell LCD display */
|
|
||||||
#define HAVE_NEW_CHARCELL_LCD 1
|
|
||||||
|
|
||||||
/* define this if you have the Recorder's 10-key keyboard */
|
|
||||||
#define HAVE_RECORDER_KEYPAD 1
|
|
||||||
|
|
||||||
/* define this if you have the Player's keyboard */
|
|
||||||
#define HAVE_PLAYER_KEYPAD 1
|
|
||||||
|
|
||||||
/* define this if you compile a simulator (no actual HW) */
|
|
||||||
#define SIMULATOR 1
|
|
||||||
|
|
@ -1,42 +0,0 @@
|
||||||
$Id$
|
|
||||||
|
|
||||||
In order for the project to run as smoothly as possible, it's best if all
|
|
||||||
contributors adhere to a few simple conventions:
|
|
||||||
|
|
||||||
Language
|
|
||||||
--------
|
|
||||||
Write all code in C. Sometimes assembly is faster, but C is always more
|
|
||||||
readable and maintainable.
|
|
||||||
|
|
||||||
Language features
|
|
||||||
-----------------
|
|
||||||
Write normal C code. Don't redefine the language. No new types (structs are
|
|
||||||
structs, not typedefs), no C++isms or Javaisms. Also, avoid using "const".
|
|
||||||
|
|
||||||
Names
|
|
||||||
-----
|
|
||||||
Variables and function names should be all lower case.
|
|
||||||
Preprocessor symbols should be all uppercase.
|
|
||||||
|
|
||||||
Style
|
|
||||||
-----
|
|
||||||
When changing code, follow the code style of the file you are editing.
|
|
||||||
|
|
||||||
When writing new files, you may use the brace placement style of your choice.
|
|
||||||
|
|
||||||
Always indent your code with four spaces. Don't use TAB characters, as that
|
|
||||||
will mess up code display in CVS, printing, and a zillion other places.
|
|
||||||
|
|
||||||
Keep lines below 80 columns length. Use whitespace and newlines to make the
|
|
||||||
code easy to browse/read.
|
|
||||||
|
|
||||||
Text format
|
|
||||||
-----------
|
|
||||||
Use "unix style" line feeds: "LF" only. Do not use "CR+LF".
|
|
||||||
|
|
||||||
Patches
|
|
||||||
-------
|
|
||||||
Create a patch using 'cvs diff -ub'. Trim your patches so they only contain
|
|
||||||
relevant changes.
|
|
||||||
Submit all patches to the mailing list. Put [PATCH] first on the subject line
|
|
||||||
of your mail. If the patch is very large (>50k), gzip it before you send it.
|
|
||||||
|
|
@ -1,36 +0,0 @@
|
||||||
People that have contributed to the project, one way or another. Friends!
|
|
||||||
|
|
||||||
Björn Stenberg Originator, project manager, code
|
|
||||||
Linus Nielsen Feltzing Electronics, code
|
|
||||||
Andy Choi Checksums
|
|
||||||
Andrew Jamieson Schematics, electronics
|
|
||||||
Paul Suade Serial port setup
|
|
||||||
Joachim Schiffer Schematics, electronics
|
|
||||||
Daniel Stenberg Code
|
|
||||||
Alan Korr Code
|
|
||||||
Gary Czvitkovicz Code
|
|
||||||
Stuart Martin Code
|
|
||||||
Felix Arends Code
|
|
||||||
Ulf Ralberg Thread embryo
|
|
||||||
David Härdeman Initial ID3 code
|
|
||||||
Thomas Saeys Logo
|
|
||||||
Grant Wier Code
|
|
||||||
Julien Labruyére Donated Archos Player
|
|
||||||
Nicolas Sauzede Display research
|
|
||||||
Robert Hak Code, documentation, sarcasm
|
|
||||||
Dave Chapman Code
|
|
||||||
Stefan Meyer Code
|
|
||||||
Eric Linenberg Code
|
|
||||||
Tom Cvitan Web design
|
|
||||||
Magnus Öman Font
|
|
||||||
Jerome Kuptz Code
|
|
||||||
Julien Boissinot Code, Sound research
|
|
||||||
Nuutti Kotivuori Code
|
|
||||||
Heikki Hannikainen Code
|
|
||||||
Hardeep Sidhu Code
|
|
||||||
Markus Braun Code
|
|
||||||
Justin Heiner Code
|
|
||||||
Magnus Holmgren Code
|
|
||||||
Bill Napier Build fixes
|
|
||||||
George Styles Code
|
|
||||||
Mats Lidell Code
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue