470989bd70
add_event_ex is added that takes an extra user_data pointer. This pointer is passed to the callback (add_event and add_event_ex have slightly different callbacks types). All callbacks also get the event id passed. Events added with add_event_ex must be removed with remove_event_ex because the user_data pointer must match in addition to the callback pointer. On the other add_event is simplified to omit the oneshort parameter which was almost always false (still there with add_event_ex). As a side effect the ata_idle_notify callbacks are changed as well, they do not take a data parameter anymore which was always NULL anyway. This commit also adds some documentation to events.h Change-Id: I13e29a0f88ef908f175b376d83550f9e0231f772
61 lines
2.2 KiB
C
61 lines
2.2 KiB
C
/***************************************************************************
|
|
* __________ __ ___.
|
|
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
* \/ \/ \/ \/ \/
|
|
* $Id$
|
|
*
|
|
* Copyright (C) 2006 Jonathan Gordon
|
|
*
|
|
* 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 __ATACALLBACK_H__
|
|
#define __ATACALLBACK_H__
|
|
|
|
|
|
#include <stdbool.h>
|
|
#include "events.h"
|
|
|
|
/*
|
|
NOTE: storage_idle_notify usage notes..
|
|
|
|
1) The callbacks are called in the ata thread, not main/your thread.
|
|
2) Asynchronous callbacks (like the buffer refill) should be avoided.
|
|
If you must use an async callback, remember to check storage_is_active() before
|
|
accessing the disk, and do not call any functions between that check and the
|
|
disk access which may cause a yield (lcd_update() does this!).
|
|
3) Do not call any yielding functions in the callback.
|
|
4) Do not call storage_sleep in the callbacks.
|
|
5) Don't Panic!
|
|
|
|
*/
|
|
|
|
enum {
|
|
DISK_EVENT_SPINUP = (EVENT_CLASS_DISK|1),
|
|
};
|
|
|
|
/* Enable storage callbacks everywhere except for bootloaders. Both
|
|
* hosted and native targets need this.
|
|
*/
|
|
#define USING_STORAGE_CALLBACK !defined(BOOTLOADER) && !defined(APPLICATION) && !defined(__PCTOOL__)
|
|
|
|
extern void register_storage_idle_func(void (*function)(void));
|
|
#if USING_STORAGE_CALLBACK
|
|
extern void unregister_storage_idle_func(void (*function)(void), bool run);
|
|
extern bool call_storage_idle_notifys(bool force);
|
|
#else
|
|
#define unregister_storage_idle_func(f,r)
|
|
#define call_storage_idle_notifys(f)
|
|
#define storage_idle_notify_init(s)
|
|
#endif
|
|
|
|
#endif /* __ATACALLBACK_H__ */
|