apps/misc.c

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2002 by Daniel Stenberg
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21 #include <stdlib.h>
  22 #include <ctype.h>
  23 #include <stdio.h>
  24 #include <stdarg.h>
  25 #include <errno.h>
  26 #include "string-extra.h"
  27 #include "config.h"
  28 #include "misc.h"
  29 #include "system.h"
  30 #include "lcd.h"
  31 #include "file.h"
  32 #include "filefuncs.h"
  33 #ifndef __PCTOOL__
  34 #include "lang.h"
  35 #include "dir.h"
  36 #include "lcd-remote.h"
  37 #include "system.h"
  38 #include "timefuncs.h"
  39 #include "screens.h"
  40 #include "usb_screen.h"
  41 #include "talk.h"
  42 #include "audio.h"
  43 #include "mp3_playback.h"
  44 #include "settings.h"
  45 #include "storage.h"
  46 #include "ata_idle_notify.h"
  47 #include "kernel.h"
  48 #include "power.h"
  49 #include "powermgmt.h"
  50 #include "backlight.h"
  51 #include "version.h"
  52 #include "font.h"
  53 #include "splash.h"
  54 #include "tagcache.h"
  55 #include "scrobbler.h"
  56 #include "sound.h"
  57 #include "playlist.h"
  58 #include "yesno.h"
  59 #include "viewport.h"
  60
  61 #include "debug.h"
  62
  63 #if CONFIG_TUNER
  64 #include "radio.h"
  65 #endif
  66
  67 #ifdef IPOD_ACCESSORY_PROTOCOL
  68 #include "iap.h"
  69 #endif
  70
  71 #if (CONFIG_STORAGE & STORAGE_MMC)
  72 #include "ata_mmc.h"
  73 #endif
  74 #include "tree.h"
  75 #include "eeprom_settings.h"
  76 #if defined(HAVE_RECORDING) && !defined(__PCTOOL__)
  77 #include "recording.h"
  78 #endif
  79 #if defined(HAVE_LCD_BITMAP) && !defined(__PCTOOL__)
  80 #include "bmp.h"
  81 #include "icons.h"
  82 #endif /* End HAVE_LCD_BITMAP */
  83 #include "bookmark.h"
  84 #include "wps.h"
  85 #include "playback.h"
  86 #if CONFIG_CODEC == SWCODEC
  87 #include "voice_thread.h"
  88 #endif
  89
  90 #ifdef BOOTFILE
  91 #if !defined(USB_NONE) && !defined(USB_HANDLED_BY_OF) \
  92         || defined(HAVE_HOTSWAP_STORAGE_AS_MAIN)
  93 #include "rolo.h"
  94 #endif
  95 #endif
  96
  97 /* units used with output_dyn_value */
  98 const unsigned char * const byte_units[] =
  99 {
 100     ID2P(LANG_BYTE),
 101     ID2P(LANG_KILOBYTE),
 102     ID2P(LANG_MEGABYTE),
 103     ID2P(LANG_GIGABYTE)
 104 };
 105
 106 const unsigned char * const * const kbyte_units = &byte_units[1];
 107
 108 /* Format a large-range value for output, using the appropriate unit so that
 109  * the displayed value is in the range 1 <= display < 1000 (1024 for "binary"
 110  * units) if possible, and 3 significant digits are shown. If a buffer is
 111  * given, the result is snprintf()'d into that buffer, otherwise the result is
 112  * voiced.*/
 113 char *output_dyn_value(char *buf, int buf_size, int value,
 114                        const unsigned char * const *units, bool bin_scale)
 115 {
 116     int scale = bin_scale ? 1024 : 1000;
 117     int fraction = 0;
 118     int unit_no = 0;
 119     char tbuf[5];
 120
 121     while (value >= scale)
 122     {
 123         fraction = value % scale;
 124         value /= scale;
 125         unit_no++;
 126     }
 127     if (bin_scale)
 128         fraction = fraction * 1000 / 1024;
 129
 130     if (value >= 100 || !unit_no)
 131         tbuf[0] = '\0';
 132     else if (value >= 10)
 133         snprintf(tbuf, sizeof(tbuf), "%01d", fraction / 100);
 134     else
 135         snprintf(tbuf, sizeof(tbuf), "%02d", fraction / 10);
 136
 137     if (buf)
 138     {
 139         if (*tbuf)
 140             snprintf(buf, buf_size, "%d%s%s%s", value, str(LANG_POINT),
 141                      tbuf, P2STR(units[unit_no]));
 142         else
 143             snprintf(buf, buf_size, "%d%s", value, P2STR(units[unit_no]));
 144     }
 145     else
 146     {
 147         talk_fractional(tbuf, value, P2ID(units[unit_no]));
 148     }
 149     return buf;
 150 }
 151
 152 /* Ask the user if they really want to erase the current dynamic playlist
 153  * returns true if the playlist should be replaced */
 154 bool warn_on_pl_erase(void)
 155 {
 156     if (global_settings.warnon_erase_dynplaylist &&
 157         !global_settings.party_mode &&
 158         playlist_modified(NULL))
 159     {
 160         static const char *lines[] =
 161             {ID2P(LANG_WARN_ERASEDYNPLAYLIST_PROMPT)};
 162         static const struct text_message message={lines, 1};
 163
 164         return (gui_syncyesno_run(&message, NULL, NULL) == YESNO_YES);
 165     }
 166     else
 167         return true;
 168 }
 169
 170
 171 /* Performance optimized version of the read_line() (see below) function. */
 172 int fast_readline(int fd, char *buf, int buf_size, void *parameters,
 173                   int (*callback)(int n, char *buf, void *parameters))
 174 {
 175     char *p, *next;
 176     int rc, pos = 0;
 177     int count = 0;
 178
 179     while ( 1 )
 180     {
 181         next = NULL;
 182
 183         rc = read(fd, &buf[pos], buf_size - pos - 1);
 184         if (rc >= 0)
 185             buf[pos+rc] = '\0';
 186
 187         if ( (p = strchr(buf, '\n')) != NULL)
 188         {
 189             *p = '\0';
 190             next = ++p;
 191         }
 192
 193         rc = callback(count, buf, parameters);
 194         if (rc < 0)
 195             return rc;
 196
 197         count++;
 198         if (next)
 199         {
 200             pos = buf_size - ((long)next - (long)buf) - 1;
 201             memmove(buf, next, pos);
 202         }
 203         else
 204             break ;
 205     }
 206
 207     return 0;
 208 }
 209
 210 /* parse a line from a configuration file. the line format is:
 211
 212    name: value
 213
 214    Any whitespace before setting name or value (after ':') is ignored.
 215    A # as first non-whitespace character discards the whole line.
 216    Function sets pointers to null-terminated setting name and value.
 217    Returns false if no valid config entry was found.
 218 */
 219
 220 bool settings_parseline(char* line, char** name, char** value)
 221 {
 222     char* ptr;
 223
 224     line = skip_whitespace(line);
 225
 226     if ( *line == '#' )
 227         return false;
 228
 229     ptr = strchr(line, ':');
 230     if ( !ptr )
 231         return false;
 232
 233     *name = line;
 234     *ptr = 0;
 235     ptr++;
 236     ptr = skip_whitespace(ptr);
 237     *value = ptr;
 238     return true;
 239 }
 240
 241 static void system_flush(void)
 242 {
 243     scrobbler_shutdown();
 244     playlist_shutdown();
 245     tree_flush();
 246     call_storage_idle_notifys(true); /*doesnt work on usb and shutdown from ata thread */
 247 }
 248
 249 static void system_restore(void)
 250 {
 251     tree_restore();
 252     scrobbler_init();
 253 }
 254
 255 static bool clean_shutdown(void (*callback)(void *), void *parameter)
 256 {
 257     long msg_id = -1;
 258     int i;
 259
 260     scrobbler_poweroff();
 261
 262 #if CONFIG_CHARGING && !defined(HAVE_POWEROFF_WHILE_CHARGING)
 263     if(!charger_inserted())
 264 #endif
 265     {
 266         bool batt_safe = battery_level_safe();
 267 #if CONFIG_CODEC != SWCODEC || defined(HAVE_RECORDING)
 268         int audio_stat = audio_status();
 269 #endif
 270
 271         FOR_NB_SCREENS(i)
 272         {
 273             screens[i].clear_display();
 274             screens[i].update();
 275         }
 276
 277         if (batt_safe)
 278         {
 279 #ifdef HAVE_TAGCACHE
 280             if (!tagcache_prepare_shutdown())
 281             {
 282                 cancel_shutdown();
 283                 splash(HZ, ID2P(LANG_TAGCACHE_BUSY));
 284                 return false;
 285             }
 286 #endif
 287             if (battery_level() > 10)
 288                 splash(0, str(LANG_SHUTTINGDOWN));
 289             else
 290             {
 291                 msg_id = LANG_WARNING_BATTERY_LOW;
 292                 splashf(0, "%s %s", str(LANG_WARNING_BATTERY_LOW),
 293                                     str(LANG_SHUTTINGDOWN));
 294             }
 295         }
 296         else
 297         {
 298             msg_id = LANG_WARNING_BATTERY_EMPTY;
 299             splashf(0, "%s %s", str(LANG_WARNING_BATTERY_EMPTY),
 300                                 str(LANG_SHUTTINGDOWN));
 301         }
 302 #if CONFIG_CODEC != SWCODEC
 303         if (global_settings.fade_on_stop
 304             && (audio_stat & AUDIO_STATUS_PLAY))
 305         {
 306             fade(false, false);
 307         }
 308 #endif
 309
 310         if (batt_safe) /* do not save on critical battery */
 311         {
 312 #if defined(HAVE_RECORDING) && CONFIG_CODEC == SWCODEC
 313             if (audio_stat & AUDIO_STATUS_RECORD)
 314             {
 315                 rec_command(RECORDING_CMD_STOP);
 316                 /* wait for stop to complete */
 317                 while (audio_status() & AUDIO_STATUS_RECORD)
 318                     sleep(1);
 319             }
 320 #endif
 321             bookmark_autobookmark(false);
 322
 323             /* audio_stop_recording == audio_stop for HWCODEC */
 324             audio_stop();
 325
 326             if (callback != NULL)
 327                 callback(parameter);
 328
 329 #if CONFIG_CODEC != SWCODEC
 330             /* wait for audio_stop or audio_stop_recording to complete */
 331             while (audio_status())
 332                 sleep(1);
 333 #endif
 334
 335 #if defined(HAVE_RECORDING) && CONFIG_CODEC == SWCODEC
 336             audio_close_recording();
 337 #endif
 338
 339             if(global_settings.talk_menu)
 340             {
 341                 bool enqueue = false;
 342                 if(msg_id != -1)
 343                 {
 344                     talk_id(msg_id, enqueue);
 345                     enqueue = true;
 346                 }
 347                 talk_id(LANG_SHUTTINGDOWN, enqueue);
 348 #if CONFIG_CODEC == SWCODEC
 349                 voice_wait();
 350 #endif
 351             }
 352
 353             system_flush();
 354 #ifdef HAVE_EEPROM_SETTINGS
 355             if (firmware_settings.initialized)
 356             {
 357                 firmware_settings.disk_clean = true;
 358                 firmware_settings.bl_version = 0;
 359                 eeprom_settings_store();
 360             }
 361 #endif
 362         }
 363 #ifdef HAVE_DIRCACHE
 364         else
 365             dircache_disable();
 366 #endif
 367
 368         shutdown_hw();
 369     }
 370     return false;
 371 }
 372
 373 bool list_stop_handler(void)
 374 {
 375     bool ret = false;
 376
 377 #if CONFIG_TUNER
 378     radio_stop();
 379 #endif
 380
 381     /* Stop the music if it is playing */
 382     if(audio_status())
 383     {
 384         if (!global_settings.party_mode)
 385         {
 386 #if CONFIG_CODEC != SWCODEC
 387             if (global_settings.fade_on_stop)
 388                 fade(false, false);
 389 #endif
 390             bookmark_autobookmark(true);
 391             audio_stop();
 392             ret = true;  /* bookmarking can make a refresh necessary */
 393         }
 394     }
 395 #if CONFIG_CHARGING
 396 #if (CONFIG_KEYPAD == RECORDER_PAD) && !defined(HAVE_SW_POWEROFF)
 397     else
 398     {
 399         if (charger_inserted())
 400             charging_splash();
 401         else
 402             shutdown_screen(); /* won't return if shutdown actually happens */
 403
 404         ret = true;  /* screen is dirty, caller needs to refresh */
 405     }
 406 #endif
 407 #ifndef HAVE_POWEROFF_WHILE_CHARGING
 408     {
 409         static long last_off = 0;
 410
 411         if (TIME_BEFORE(current_tick, last_off + HZ/2))
 412         {
 413             if (charger_inserted())
 414             {
 415                 charging_splash();
 416                 ret = true;  /* screen is dirty, caller needs to refresh */
 417             }
 418         }
 419         last_off = current_tick;
 420     }
 421 #endif
 422 #endif /* CONFIG_CHARGING */
 423     return ret;
 424 }
 425
 426 #if CONFIG_CHARGING
 427 static bool waiting_to_resume_play = false;
 428 static long play_resume_tick;
 429
 430 static void car_adapter_mode_processing(bool inserted)
 431 {
 432     if (global_settings.car_adapter_mode)
 433     {
 434         if(inserted)
 435         {
 436             /*
 437              * Just got plugged in, delay & resume if we were playing
 438              */
 439             if (audio_status() & AUDIO_STATUS_PAUSE)
 440             {
 441                 /* delay resume a bit while the engine is cranking */
 442                 play_resume_tick = current_tick + HZ*5;
 443                 waiting_to_resume_play = true;
 444             }
 445         }
 446         else
 447         {
 448             /*
 449              * Just got unplugged, pause if playing
 450              */
 451             if ((audio_status() & AUDIO_STATUS_PLAY) &&
 452                 !(audio_status() & AUDIO_STATUS_PAUSE))
 453             {
 454                 pause_action(true, true);
 455             }
 456             waiting_to_resume_play = false;
 457         }
 458     }
 459 }
 460
 461 static void car_adapter_tick(void)
 462 {
 463     if (waiting_to_resume_play)
 464     {
 465         if (TIME_AFTER(current_tick, play_resume_tick))
 466         {
 467             if (audio_status() & AUDIO_STATUS_PAUSE)
 468             {
 469                 queue_broadcast(SYS_CAR_ADAPTER_RESUME, 0);
 470             }
 471             waiting_to_resume_play = false;
 472         }
 473     }
 474 }
 475
 476 void car_adapter_mode_init(void)
 477 {
 478     tick_add_task(car_adapter_tick);
 479 }
 480 #endif
 481
 482 #ifdef HAVE_HEADPHONE_DETECTION
 483 static void unplug_change(bool inserted)
 484 {
 485     static bool headphone_caused_pause = false;
 486
 487     if (global_settings.unplug_mode)
 488     {
 489         int audio_stat = audio_status();
 490         if (inserted)
 491         {
 492             backlight_on();
 493             if ((audio_stat & AUDIO_STATUS_PLAY) &&
 494                     headphone_caused_pause &&
 495                     global_settings.unplug_mode > 1 )
 496                 unpause_action(true, true);
 497             headphone_caused_pause = false;
 498         } else {
 499             if ((audio_stat & AUDIO_STATUS_PLAY) &&
 500                     !(audio_stat & AUDIO_STATUS_PAUSE))
 501             {
 502                 headphone_caused_pause = true;
 503                 pause_action(false, false);
 504             }
 505         }
 506     }
 507 }
 508 #endif
 509
 510 long default_event_handler_ex(long event, void (*callback)(void *), void *parameter)
 511 {
 512 #if CONFIG_PLATFORM & (PLATFORM_ANDROID|PLATFORM_MAEMO)
 513     static bool resume = false;
 514 #endif
 515
 516     switch(event)
 517     {
 518         case SYS_BATTERY_UPDATE:
 519             if(global_settings.talk_battery_level)
 520             {
 521                 talk_ids(true, VOICE_PAUSE, VOICE_PAUSE,
 522                          LANG_BATTERY_TIME,
 523                          TALK_ID(battery_level(), UNIT_PERCENT),
 524                          VOICE_PAUSE);
 525                 talk_force_enqueue_next();
 526             }
 527             break;
 528         case SYS_USB_CONNECTED:
 529             if (callback != NULL)
 530                 callback(parameter);
 531 #if (CONFIG_STORAGE & STORAGE_MMC) && (defined(ARCHOS_ONDIOSP) || defined(ARCHOS_ONDIOFM))
 532             if (!mmc_touched() ||
 533                 (mmc_remove_request() == SYS_HOTSWAP_EXTRACTED))
 534 #endif
 535             {
 536                 system_flush();
 537 #ifdef BOOTFILE
 538 #if !defined(USB_NONE) && !defined(USB_HANDLED_BY_OF)
 539                 check_bootfile(false); /* gets initial size */
 540 #endif
 541 #endif
 542                 gui_usb_screen_run(false);
 543 #ifdef BOOTFILE
 544 #if !defined(USB_NONE) && !defined(USB_HANDLED_BY_OF)
 545                 check_bootfile(true);
 546 #endif
 547 #endif
 548                 system_restore();
 549             }
 550             return SYS_USB_CONNECTED;
 551
 552         case SYS_POWEROFF:
 553             if (!clean_shutdown(callback, parameter))
 554                 return SYS_POWEROFF;
 555             break;
 556 #if CONFIG_CHARGING
 557         case SYS_CHARGER_CONNECTED:
 558             car_adapter_mode_processing(true);
 559             return SYS_CHARGER_CONNECTED;
 560
 561         case SYS_CHARGER_DISCONNECTED:
 562             car_adapter_mode_processing(false);
 563             /*reset rockbox battery runtime*/
 564             global_status.runtime = 0;
 565             return SYS_CHARGER_DISCONNECTED;
 566
 567         case SYS_CAR_ADAPTER_RESUME:
 568             unpause_action(true, true);
 569             return SYS_CAR_ADAPTER_RESUME;
 570 #endif
 571 #ifdef HAVE_HOTSWAP_STORAGE_AS_MAIN
 572         case SYS_FS_CHANGED:
 573         {
 574             /* simple sanity: assume rockbox is on the first hotswappable
 575              * driver, abort out if that one isn't inserted */
 576             int i;
 577             for (i = 0; i < NUM_DRIVES; i++)
 578             {
 579                 if (storage_removable(i) && !storage_present(i))
 580                     return SYS_FS_CHANGED;
 581             }
 582             system_flush();
 583             check_bootfile(true); /* state gotten in main.c:init() */
 584             system_restore();
 585         }
 586             return SYS_FS_CHANGED;
 587 #endif
 588 #ifdef HAVE_HEADPHONE_DETECTION
 589         case SYS_PHONE_PLUGGED:
 590             unplug_change(true);
 591             return SYS_PHONE_PLUGGED;
 592
 593         case SYS_PHONE_UNPLUGGED:
 594             unplug_change(false);
 595             return SYS_PHONE_UNPLUGGED;
 596 #endif
 597 #ifdef IPOD_ACCESSORY_PROTOCOL
 598         case SYS_IAP_PERIODIC:
 599             iap_periodic();
 600             return SYS_IAP_PERIODIC;
 601         case SYS_IAP_HANDLEPKT:
 602             iap_handlepkt();
 603             return SYS_IAP_HANDLEPKT;
 604 #endif
 605 #if CONFIG_PLATFORM & (PLATFORM_ANDROID|PLATFORM_MAEMO)
 606         /* stop playback if we receive a call */
 607         case SYS_CALL_INCOMING:
 608             resume = audio_status() == AUDIO_STATUS_PLAY;
 609             list_stop_handler();
 610             return SYS_CALL_INCOMING;
 611         /* resume playback if needed */
 612         case SYS_CALL_HUNG_UP:
 613             if (resume && playlist_resume() != -1)
 614             {
 615                 playlist_start(global_status.resume_index,
 616                                global_status.resume_offset);
 617             }
 618             resume = false;
 619             return SYS_CALL_HUNG_UP;
 620 #endif
 621 #if (CONFIG_PLATFORM & PLATFORM_HOSTED) && defined(PLATFORM_HAS_VOLUME_CHANGE)
 622         case SYS_VOLUME_CHANGED:
 623         {
 624             static bool firstvolume = true;
 625             int volume = hosted_get_volume();
 626             DEBUGF("SYS_VOLUME_CHANGED: %d\n", volume);
 627             if (global_settings.volume != volume) {
 628                 global_settings.volume = volume;
 629                 if (firstvolume) {
 630                     setvol();
 631                     firstvolume = false;
 632                 }
 633             }
 634             return 0;
 635         }
 636 #endif
 637 #ifdef HAVE_MULTIMEDIA_KEYS
 638         /* multimedia keys on keyboards, headsets */
 639         case BUTTON_MULTIMEDIA_PLAYPAUSE:
 640         {
 641             int status = audio_status();
 642             if (status & AUDIO_STATUS_PLAY)
 643             {
 644                 if (status & AUDIO_STATUS_PAUSE)
 645                     unpause_action(true, true);
 646                 else
 647                     pause_action(true, true);
 648             }
 649             else
 650                 if (playlist_resume() != -1)
 651                 {
 652                     playlist_start(global_status.resume_index,
 653                                    global_status.resume_offset);
 654                 }
 655             return event;
 656         }
 657         case BUTTON_MULTIMEDIA_NEXT:
 658             audio_next();
 659             return event;
 660         case BUTTON_MULTIMEDIA_PREV:
 661             audio_prev();
 662             return event;
 663         case BUTTON_MULTIMEDIA_STOP:
 664             list_stop_handler();
 665             return event;
 666         case BUTTON_MULTIMEDIA_REW:
 667         case BUTTON_MULTIMEDIA_FFWD:
 668             /* not supported yet, needs to be done in the WPS */
 669             return 0;
 670 #endif
 671     }
 672     return 0;
 673 }
 674
 675 long default_event_handler(long event)
 676 {
 677     return default_event_handler_ex(event, NULL, NULL);
 678 }
 679
 680 int show_logo( void )
 681 {
 682 #ifdef HAVE_LCD_BITMAP
 683     char version[32];
 684     int font_h, font_w;
 685
 686     snprintf(version, sizeof(version), "Ver. %s", rbversion);
 687
 688     lcd_clear_display();
 689 #if defined(SANSA_CLIP) || defined(SANSA_CLIPV2) || defined(SANSA_CLIPPLUS)
 690     /* display the logo in the blue area of the screen */
 691     lcd_setfont(FONT_SYSFIXED);
 692     lcd_getstringsize((unsigned char *)"A", &font_w, &font_h);
 693     lcd_putsxy((LCD_WIDTH/2) - ((strlen(version)*font_w)/2),
 694                0, (unsigned char *)version);
 695     lcd_bitmap(rockboxlogo, (LCD_WIDTH - BMPWIDTH_rockboxlogo) / 2, 16,
 696             BMPWIDTH_rockboxlogo, BMPHEIGHT_rockboxlogo);
 697 #else
 698     lcd_bitmap(rockboxlogo, (LCD_WIDTH - BMPWIDTH_rockboxlogo) / 2, 10,
 699             BMPWIDTH_rockboxlogo, BMPHEIGHT_rockboxlogo);
 700     lcd_setfont(FONT_SYSFIXED);
 701     lcd_getstringsize((unsigned char *)"A", &font_w, &font_h);
 702     lcd_putsxy((LCD_WIDTH/2) - ((strlen(version)*font_w)/2),
 703                LCD_HEIGHT-font_h, (unsigned char *)version);
 704 #endif
 705     lcd_setfont(FONT_UI);
 706
 707 #else
 708     char *rockbox = "  ROCKbox!";
 709
 710     lcd_clear_display();
 711     lcd_double_height(true);
 712     lcd_puts(0, 0, rockbox);
 713     lcd_puts_scroll(0, 1, rbversion);
 714 #endif
 715     lcd_update();
 716
 717 #ifdef HAVE_REMOTE_LCD
 718     lcd_remote_clear_display();
 719     lcd_remote_bitmap(remote_rockboxlogo, 0, 10, BMPWIDTH_remote_rockboxlogo,
 720                       BMPHEIGHT_remote_rockboxlogo);
 721     lcd_remote_setfont(FONT_SYSFIXED);
 722     lcd_remote_getstringsize((unsigned char *)"A", &font_w, &font_h);
 723     lcd_remote_putsxy((LCD_REMOTE_WIDTH/2) - ((strlen(version)*font_w)/2),
 724                        LCD_REMOTE_HEIGHT-font_h, (unsigned char *)version);
 725     lcd_remote_setfont(FONT_UI);
 726     lcd_remote_update();
 727 #endif
 728
 729     return 0;
 730 }
 731
 732 #ifdef BOOTFILE
 733 #if !defined(USB_NONE) && !defined(USB_HANDLED_BY_OF) || defined(HAVE_HOTSWAP_STORAGE_AS_MAIN)
 734 /*
 735     memorize/compare details about the BOOTFILE
 736     we don't use dircache because it may not be up to date after
 737     USB disconnect (scanning in the background)
 738 */
 739 void check_bootfile(bool do_rolo)
 740 {
 741     static unsigned short wrtdate = 0;
 742     static unsigned short wrttime = 0;
 743     DIR* dir = NULL;
 744     struct dirent* entry = NULL;
 745
 746     /* 1. open BOOTDIR and find the BOOTFILE dir entry */
 747     dir = opendir(BOOTDIR);
 748
 749     if(!dir) return; /* do we want an error splash? */
 750
 751     /* loop all files in BOOTDIR */
 752     while(0 != (entry = readdir(dir)))
 753     {
 754         if(!strcasecmp(entry->d_name, BOOTFILE))
 755         {
 756             struct dirinfo info = dir_get_info(dir, entry);
 757             /* found the bootfile */
 758             if(wrtdate && do_rolo)
 759             {
 760                 if((info.wrtdate != wrtdate) ||
 761                    (info.wrttime != wrttime))
 762                 {
 763                     static const char *lines[] = { ID2P(LANG_BOOT_CHANGED),
 764                                                    ID2P(LANG_REBOOT_NOW) };
 765                     static const struct text_message message={ lines, 2 };
 766                     button_clear_queue(); /* Empty the keyboard buffer */
 767                     if(gui_syncyesno_run(&message, NULL, NULL) == YESNO_YES)
 768                     {
 769                         audio_hard_stop();
 770                         rolo_load(BOOTDIR "/" BOOTFILE);
 771                     }
 772                 }
 773             }
 774             wrtdate = info.wrtdate;
 775             wrttime = info.wrttime;
 776         }
 777     }
 778     closedir(dir);
 779 }
 780 #endif
 781 #endif
 782
 783 /* check range, set volume and save settings */
 784 void setvol(void)
 785 {
 786     const int min_vol = sound_min(SOUND_VOLUME);
 787     const int max_vol = sound_max(SOUND_VOLUME);
 788     if (global_settings.volume < min_vol)
 789         global_settings.volume = min_vol;
 790     if (global_settings.volume > max_vol)
 791         global_settings.volume = max_vol;
 792     sound_set_volume(global_settings.volume);
 793     global_status.last_volume_change = current_tick;
 794     settings_save();
 795 }
 796
 797 char* strrsplt(char* str, int c)
 798 {
 799     char* s = strrchr(str, c);
 800
 801     if (s != NULL)
 802     {
 803         *s++ = '\0';
 804     }
 805     else
 806     {
 807         s = str;
 808     }
 809
 810     return s;
 811 }
 812
 813 /*
 814  * removes the extension of filename (if it doesn't start with a .)
 815  * puts the result in buffer
 816  */
 817 char *strip_extension(char* buffer, int buffer_size, const char *filename)
 818 {
 819     char *dot = strrchr(filename, '.');
 820     int len;
 821
 822     if (buffer_size <= 0)
 823     {
 824         return NULL;
 825     }
 826
 827     buffer_size--;  /* Make room for end nil */
 828
 829     if (dot != 0 && filename[0] != '.')
 830     {
 831         len = dot - filename;
 832         len = MIN(len, buffer_size);
 833     }
 834     else
 835     {
 836         len = buffer_size;
 837     }
 838
 839     strlcpy(buffer, filename, len + 1);
 840
 841     return buffer;
 842 }
 843
 844 #if CONFIG_CODEC == SWCODEC
 845 /* Play a standard sound */
 846 void system_sound_play(enum system_sound sound)
 847 {
 848     static const struct beep_params
 849     {
 850         int *setting;
 851         unsigned short frequency;
 852         unsigned short duration;
 853         unsigned short amplitude;
 854     } beep_params[] =
 855     {
 856         [SOUND_KEYCLICK] =
 857         { &global_settings.keyclick,
 858           4000, KEYCLICK_DURATION, 2500 },
 859         [SOUND_TRACK_SKIP] =
 860         { &global_settings.beep,
 861           2000, 100, 2500 },
 862         [SOUND_TRACK_NO_MORE] =
 863         { &global_settings.beep,
 864           1000, 100, 1500 },
 865     };
 866
 867     const struct beep_params *params = &beep_params[sound];
 868
 869     if (*params->setting)
 870     {
 871         beep_play(params->frequency, params->duration,
 872                   params->amplitude * *params->setting);
 873     }
 874 }
 875
 876 /* Produce keyclick based upon button and global settings */
 877 void keyclick_click(int button)
 878 {
 879     /* Settings filters */
 880     if (global_settings.keyclick &&
 881         (global_settings.keyclick_repeats || !(button & BUTTON_REPEAT)))
 882     {
 883         /* Button filters */
 884         if (button != BUTTON_NONE && !(button & BUTTON_REL)
 885             && !(button & (SYS_EVENT|BUTTON_MULTIMEDIA)) )
 886         {
 887             system_sound_play(SOUND_KEYCLICK);
 888         }
 889     }
 890 }
 891 #endif /* CONFIG_CODEC == SWCODEC */
 892
 893 #endif /* !defined(__PCTOOL__) */
 894
 895 /* Read (up to) a line of text from fd into buffer and return number of bytes
 896  * read (which may be larger than the number of bytes stored in buffer). If
 897  * an error occurs, -1 is returned (and buffer contains whatever could be
 898  * read). A line is terminated by a LF char. Neither LF nor CR chars are
 899  * stored in buffer.
 900  */
 901 int read_line(int fd, char* buffer, int buffer_size)
 902 {
 903     int count = 0;
 904     int num_read = 0;
 905
 906     errno = 0;
 907
 908     while (count < buffer_size)
 909     {
 910         unsigned char c;
 911
 912         if (1 != read(fd, &c, 1))
 913             break;
 914
 915         num_read++;
 916
 917         if ( c == '\n' )
 918             break;
 919
 920         if ( c == '\r' )
 921             continue;
 922
 923         buffer[count++] = c;
 924     }
 925
 926     buffer[MIN(count, buffer_size - 1)] = 0;
 927
 928     return errno ? -1 : num_read;
 929 }
 930
 931
 932 char* skip_whitespace(char* const str)
 933 {
 934     char *s = str;
 935
 936     while (isspace(*s))
 937         s++;
 938
 939     return s;
 940 }
 941
 942 /* Format time into buf.
 943  *
 944  * buf      - buffer to format to.
 945  * buf_size - size of buffer.
 946  * t        - time to format, in milliseconds.
 947  */
 948 void format_time(char* buf, int buf_size, long t)
 949 {
 950     int const time = abs(t / 1000);
 951     int const hours = time / 3600;
 952     int const minutes = time / 60 - hours * 60;
 953     int const seconds = time % 60;
 954     const char * const sign = &"-"[t < 0 ? 0 : 1];
 955
 956     if ( hours == 0 )
 957     {
 958         snprintf(buf, buf_size, "%s%d:%02d", sign, minutes, seconds);
 959     }
 960     else
 961     {
 962         snprintf(buf, buf_size, "%s%d:%02d:%02d", sign, hours, minutes,
 963                  seconds);
 964     }
 965 }
 966
 967
 968 /** Open a UTF-8 file and set file descriptor to first byte after BOM.
 969  *  If no BOM is present this behaves like open().
 970  *  If the file is opened for writing and O_TRUNC is set, write a BOM to
 971  *  the opened file and leave the file pointer set after the BOM.
 972  */
 973 #define BOM "\xef\xbb\xbf"
 974 #define BOM_SIZE 3
 975
 976 int open_utf8(const char* pathname, int flags)
 977 {
 978     int fd;
 979     unsigned char bom[BOM_SIZE];
 980
 981     fd = open(pathname, flags, 0666);
 982     if(fd < 0)
 983         return fd;
 984
 985     if(flags & (O_TRUNC | O_WRONLY))
 986     {
 987         write(fd, BOM, BOM_SIZE);
 988     }
 989     else
 990     {
 991         read(fd, bom, BOM_SIZE);
 992         /* check for BOM */
 993         if(memcmp(bom, BOM, BOM_SIZE))
 994             lseek(fd, 0, SEEK_SET);
 995     }
 996     return fd;
 997 }
 998
 999
1000 #ifdef HAVE_LCD_COLOR
1001 /*
1002  * Helper function to convert a string of 6 hex digits to a native colour
1003  */
1004
1005 static int hex2dec(int c)
1006 {
1007     return  (((c) >= '0' && ((c) <= '9')) ? (c) - '0' :
1008                                             (toupper(c)) - 'A' + 10);
1009 }
1010
1011 int hex_to_rgb(const char* hex, int* color)
1012 {
1013     int red, green, blue;
1014     int i = 0;
1015
1016     while ((i < 6) && (isxdigit(hex[i])))
1017         i++;
1018
1019     if (i < 6)
1020         return -1;
1021
1022     red = (hex2dec(hex[0]) << 4) | hex2dec(hex[1]);
1023     green = (hex2dec(hex[2]) << 4) | hex2dec(hex[3]);
1024     blue = (hex2dec(hex[4]) << 4) | hex2dec(hex[5]);
1025
1026     *color = LCD_RGBPACK(red,green,blue);
1027
1028     return 0;
1029 }
1030 #endif /* HAVE_LCD_COLOR */
1031
1032 #ifdef HAVE_LCD_BITMAP
1033 /* '0'-'3' are ASCII 0x30 to 0x33 */
1034 #define is0123(x) (((x) & 0xfc) == 0x30)
1035 #if !defined(__PCTOOL__) || defined(CHECKWPS)
1036 bool parse_color(enum screen_type screen, char *text, int *value)
1037 {
1038     (void)text; (void)value; /* silence warnings on mono bitmap */
1039     (void)screen;
1040
1041 #ifdef HAVE_LCD_COLOR
1042     if (screens[screen].depth > 2)
1043     {
1044         if (hex_to_rgb(text, value) < 0)
1045             return false;
1046         else
1047             return true;
1048     }
1049 #endif
1050
1051 #if LCD_DEPTH == 2 || (defined(HAVE_REMOTE_LCD) && LCD_REMOTE_DEPTH == 2)
1052     if (screens[screen].depth == 2)
1053     {
1054         if (text[1] != '\0' || !is0123(*text))
1055             return false;
1056         *value = *text - '0';
1057         return true;
1058     }
1059 #endif
1060     return false;
1061 }
1062 #endif /* !defined(__PCTOOL__) || defined(CHECKWPS) */
1063
1064 /* only used in USB HID and set_time screen */
1065 #if defined(USB_ENABLE_HID) || (CONFIG_RTC != 0)
1066 int clamp_value_wrap(int value, int max, int min)
1067 {
1068     if (value > max)
1069         return min;
1070     if (value < min)
1071         return max;
1072     return value;
1073 }
1074 #endif
1075 #endif
1076 #define MAX_ACTIVITY_DEPTH 12
1077 static enum current_activity
1078         current_activity[MAX_ACTIVITY_DEPTH] = {ACTIVITY_UNKNOWN};
1079 static int current_activity_top = 0;
1080 void push_current_activity(enum current_activity screen)
1081 {
1082     current_activity[current_activity_top++] = screen;
1083 }
1084 void pop_current_activity(void)
1085 {
1086     current_activity_top--;
1087 }
1088 enum current_activity get_current_activity(void)
1089 {
1090     return current_activity[current_activity_top?current_activity_top-1:0];
1091 }