1 /***************************************************************************
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
9 * Copyright (C) 2004 Brent Coutts
11 * All files in this archive are subject to the GNU General Public License.
12 * See the file COPYING in the source tree root for full license agreement.
14 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
15 * KIND, either express or implied.
17 ****************************************************************************/
24 #define TIMEOUT_BLOCK -1
25 #define TIMEOUT_NOBLOCK 0
27 #define CONTEXT_STOPSEARCHING 0xFFFFFFFF
28 #define CONTEXT_REMOTE 0x80000000 /* | this against another context to get remote buttons for that context */
29 #define CONTEXT_CUSTOM 0x40000000 /* | this against anything to get your context number */
31 #define LAST_ITEM_IN_LIST { CONTEXT_STOPSEARCHING, BUTTON_NONE, BUTTON_NONE }
32 #define LAST_ITEM_IN_LIST__NEXTLIST(a) { a, BUTTON_NONE, BUTTON_NONE }
34 #ifndef HAS_BUTTON_HOLD
35 #define ALLOW_SOFTLOCK 0x20000000 /* will be stripped.. never needed except in calls to get_action() */
37 #define ALLOW_SOFTLOCK 0
42 /* These CONTEXT_ values were here before me,
43 there values may have significance, so dont touch! */
49 /* Add new contexts here, no need to explicitly define a value for them */
51 CONTEXT_SETTINGS
, /* regular setting screens (and debug screens) */
52 /* bellow are setting screens which may need to redefine the standard
53 setting screen keys, targets should return the CONTEXT_SETTINGS
54 keymap unless they are not adequate for the screen
55 NOTE: uses ACTION_STD_[NEXT|PREV] so make sure they are there also
56 and (possibly) ACTION_SETTINGS_[INC|DEC] */
58 CONTEXT_SETTINGS_COLOURCHOOSER
,
59 CONTEXT_SETTINGS_TIME
,
61 /* The following contexts should use ACTION_STD_[NEXT|PREV]
62 and (possibly) ACTION_SETTINGS_[INC|DEC]
63 Also add any extra actions they need */
64 CONTEXT_BOOKMARKSCREEN
, /* uses ACTION_BMS_ defines */
65 CONTEXT_ALARMSCREEN
, /* uses ACTION_AS_ defines */
66 CONTEXT_QUICKSCREEN
, /* uses ACTION_QS_ defines below */
67 CONTEXT_PITCHSCREEN
, /* uses ACTION_PS_ defines below */
69 CONTEXT_YESNOSCREEN
, /*NOTE: make sure your target has this and ACTION_YESNO_ACCEPT */
78 ACTION_NONE
= BUTTON_NONE
,
80 ACTION_REDRAW
, /* returned if keys are locked and we splash()'ed */
82 /* standard actions, use these first */
84 ACTION_STD_PREVREPEAT
,
86 ACTION_STD_NEXTREPEAT
,
92 ACTION_STD_QUICKSCREEN
,
95 ACTION_F3
, /* just so everything works again, possibly change me */
96 /* code context actions */
109 ACTION_WPS_PITCHSCREEN
,/* optional */
110 ACTION_WPS_ID3SCREEN
,/* optional */
112 ACTION_WPS_QUICKSCREEN
,/* optional */
113 ACTION_WPS_MENU
, /*this should be the same as ACTION_STD_MENU */
115 ACTION_WPSAB_SINGLE
, /* This needs to be #defined in
116 the config-<target>.h to one of the ACTION_WPS_ actions
119 ACTION_WPS_ABSETA_PREVDIR
, /* these should be safe to put together seen as */
120 ACTION_WPS_ABSETB_NEXTDIR
, /* you shouldnt want to change dir in ab-mode */
123 /* list and tree page up/down */
124 ACTION_LISTTREE_PGUP
,/* optional */
125 ACTION_LISTTREE_PGDOWN
,/* optional */
128 ACTION_TREE_ROOT_INIT
,
129 ACTION_TREE_PGLEFT
,/* optional */
130 ACTION_TREE_PGRIGHT
,/* optional */
143 ACTION_FM_RECORD_DBLPRE
,
144 ACTION_FM_NEXT_PRESET
,
145 ACTION_FM_PREV_PRESET
,
147 /* recording screen */
155 ACTION_REQUEST_MENUITEM
,
156 ACTION_EXIT_MENUITEM
,
157 ACTION_EXIT_AFTER_THIS_MENUITEM
, /* if a menu returns this the menu will exit
158 once the subitem returns */
159 ACTION_ENTER_MENUITEM
,
169 ACTION_SETTINGS_INCREPEAT
,
170 ACTION_SETTINGS_INCBIGSTEP
,
172 ACTION_SETTINGS_DECREPEAT
,
173 ACTION_SETTINGS_DECBIGSTEP
,
174 ACTION_SETTINGS_RESET
,
176 /* bookmark screen */
181 /* alarm menu screen */
187 ACTION_QS_DOWNINV
, /* why is this not called up?? :p */
190 /* obviously ignore if you dont have thise screen */
195 ACTION_PS_NUDGE_LEFT
,
196 ACTION_PS_NUDGE_RIGHT
,
197 ACTION_PS_NUDGE_LEFTOFF
,
198 ACTION_PS_NUDGE_RIGHTOFF
,
199 ACTION_PS_TOGGLE_MODE
,
201 ACTION_PS_EXIT
, /* _STD_* isnt going to work here */
206 /* keyboard screen */
209 ACTION_KBD_CURSOR_LEFT
,
210 ACTION_KBD_CURSOR_RIGHT
,
212 ACTION_KBD_SELECT_REM
,
213 ACTION_KBD_PAGE_FLIP
,
216 ACTION_KBD_BACKSPACE
,
219 ACTION_KBD_MORSE_INPUT
,
220 ACTION_KBD_MORSE_SELECT
,
223 LAST_ACTION_PLACEHOLDER
, /* custom actions should be this + something */
226 struct button_mapping
{
231 /* use if you want to supply your own button mappings, PLUGINS ONLY */
232 /* get_context_map is a function which returns a button_mapping* depedning on the given context */
233 /* custom button_mappings may "chain" to inbuilt CONTEXT's */
234 int get_custom_action(int context
,int timeout
,
235 const struct button_mapping
* (*get_context_map
)(int));
236 /* use if one of the standard CONTEXT_ mappings will work (ALL the core should be using this! */
237 int get_action(int context
, int timeout
);
238 /* call this whenever you leave your button loop */
239 void action_signalscreenchange(void);
241 /* call this if you need to check for ACTION_STD_CANCEL only (i.e user abort! */
242 bool action_userabort(int timeout
);
244 /* no other code should need this apart from action.c */
245 const struct button_mapping
* get_context_mapping(int context
);
246 #ifndef HAS_BUTTON_HOLD
247 bool is_keys_locked(void);
250 /* returns the status code variable from action.c for the button just pressed
251 If button != NULL it will be set to the actual button code */
252 #define ACTION_REMOTE 0x1 /* remote was pressed */
253 #define ACTION_REPEAT 0x2 /* action was repeated (NOT button) */
254 #define ACTION_IGNORING 0x4 /* action_signalscreenchange() was called \
255 waiting for BUTTON_REL */
256 int get_action_statuscode(int *button
);