- -- --------------------------------------------------------------------- -- -
Author      MK2k / www.mk2k.net
Name        Sleep'n'Wake
Version     1.99b MULTi 8
Platform    PSP (Custom Firmware 3xx/4xx)
Dev-Details Developed in C, uses OpenAlarmLib by Mr305
- -- --------------------------------------------------------------------- -- -

- -- --------------------------------------------------------------------- -- -
I    Description
- -- --------------------------------------------------------------------- -- -
Sleep'n'Wake is THE app for dozing off to your favorite music playing silently
and getting waked up again with the music you chose, this time with the volume
maxed to the system volume setting on your Playstation Portable.

- -- --------------------------------------------------------------------- -- -
II   Installation
- -- --------------------------------------------------------------------- -- -
Put the sleepnwake directory in your PSP/GAME directory on your memorystick. Let
the PSP/GAME directory run the latest kernel (set it in recovery mode).
Alternatively put sleepnwake into PSP/GAME3xx or PSP/GAME4XX on your
memorystick.

- -- --------------------------------------------------------------------- -- -
III  Features
- -- --------------------------------------------------------------------- -- -
- Full support of cbr/vbr/abr 8kbps-320kbps 44.1kHz MP3 of arbitrary length 
- Manage different playlists for Sleep and Wake modes
  -> add / remove mp3s
  -> save / load / randomize playlists
- In Sleep mode you can set a special, more silent volume
- Set up times for Wake, Snooze and Fade-In
- Wake mode is entered at a preset time with volume maxed (you can always adjust
  the maximum volume with the VOL + and - keys), the Wake Playlist will be
  looped infinitely
- Snooze for a preset amount of time in Wake Mode by pressing a Shoulderbutton
- Fade the Wake-Up Tracks in smoothly
- Save your Battery's life, the PSP gets send into Suspend Mode after the last
  track in the Sleep List has been played, the PSP gets resumed one minute
  before the Wake Time
  -- this feature could only be possible with the help of Adrahil in past
     releases and Mr305 in this release (SnW uses OpenAlarmLib by Mr305)
  -> NOTE: Activate this feature in the Customize Menu, it is deactivated by
     default, else the PSP will just get underclocked to 50MHz
- Big Digits Time Display (set 24h or 12h am|pm by pressing the right shoulder
  button in one of the Setup Times Editors)
- Customize the Font Colours or put your own theme as background.png in the
  app's directory
- Multilanguage Support (EN_DE_FR_IT_NL_FI_PT_PT-BR)
- PowerLock feature, if enabled will prevent the user from switching the PSP to
  Suspend by hand with nudging the Power Switch upwards quickly

- -- --------------------------------------------------------------------- -- -
IV   Usual First-Time Usage
- -- --------------------------------------------------------------------- -- -
1. Choose your preferred language in the Customize->Change Language Menu
2. Set up the Wake Time, Sn00ze Time and Fade-In Time in the Setup Times Menu
   -> here you can also switch from 24h to AM/PM display by pressing the right
      shoulderbutton
3. Fill the Sleep List and Wake List with your mp3s, save them if you want
4. (optional) Hook up your PSP to your hi-fi system
5. Enter SleepMode
6. Adjust the SYSTEM Volume to a loud enough Level for Wake Mode
7. Adjust the SLEEPMODE special Volume silent enough for you with Left/Right
   D-Buttons
8. (now optional) Plug in the Power Cable!
9. (optional) Hold the Screen Button a while to get the screen turned off
A. (optional) Move the Power Switch to the Lock position (move it down)
B. Good Night ;)
C. Get waked up in time :>

When you start Sleep'n'Wake another time, all your customizations, time settings
and playlists will be loaded.

Note: Adding something to either Sleep- or WakeList is in a Loop so you can
      easily add more files to your lists. Break the Loop with the Circle
      Button.

- -- --------------------------------------------------------------------- -- -
V    Greets and Shouts
- -- --------------------------------------------------------------------- -- -
Thanks to:
- Adrahil for the AlarmLib in past releases
- Mr305 for OpenAlarmLib
Thanks go to the following guys translating SnW (without you MULTi 8 would be
only MULTi 2 :D)
  o Flatmush (proofreading EN)
  o daaa57150 & sleepman (FR)
  o whazilla (NL)
  o frmariam (PT)
  o peterson vaz (PT-BR)
  o MaTiAz (FI)
  o fendergc (IT)
Shouts to:
- everyone at #psp-programming on Freenode
- Kojote / www.pdroms.de
- Greg / www.psp-hacks.com
- Shoesy / www.pspsource.de

- -- --------------------------------------------------------------------- -- -
VI   SPECiAL GREETiNG
- -- --------------------------------------------------------------------- -- -
A special greeting to my grandmother, she turned 80 years today!

- -- --------------------------------------------------------------------- -- -
VII  Backlog
- -- --------------------------------------------------------------------- -- -
1.99b
Engine (added) OpenAlarmLib (for 3xx/4xx compatibility)
       ( rem.) Adrahil's AlarmLib (for 3xx/4xx compatibility)
       ( rem.) Write-Yourself-a-Message funcs (for 3xx/4xx compatibility)
       (bugfx) Snooze handling in AM/PM mode fixed
1.99
GUI    (added) Multilanguage Support
       (bugfx) Multiple Call of the Filebrowser crashed it badly, now fixed
       (added) Customizable
Engine (added) After playing the last track in Sleep Mode, PSP gets in Suspend
               Mode and gets waked up 1 Minute before Wake Time -- this is due
               to utilization of LibAlarm (big thanks to Adrahil), this mode is
               deactivated by default, activate it in the customize menu
       (added) Snooze Mode now accepts hh:mm:ss time to snooze
       (added) Fade-In with time setting
       (added) WakeList is now looped infinitely

1.2
GUI    (added) 12h (am|pm) display (toggle 24h and 12h display in the
               "Set Wake Time" option)
       (bugfx) ".mp3" is now accepted in all capitalization variations
               (e.g. ".Mp3")
Engine (added) Playlist Randomizer as a Playlist Edit Option
       (added) Snooze Mode (activated in Alarm Mode by pressing L or R
               Shoulderbuttons)

1.1
Engine (added) 50MHz underclock in SleepMode while nothing is played

GUI    (added) Big Digits Time Display in Sleep- and Wake Mode
       (added) Left and Right Shoulderbuttons now exit Wake Mode too
       (bugfx) An overflow with adding items to the playlist fixed
       (added) Playlist enlargement to 99 max. entries
       (added) Filebrowser now remembers last visited Directory

1.0
Notes: Several Weeks of Beta Testing are over now. Stable enough for release :)

0.5a
Engine (added) ini-File with Wake Time Settings, autosaved upon new Wake Time
               set up, autoloaded upon startup
       (added) Playlist Files, autoloaded upon startup, save and load via menu
GUI    (added) REMOVED the 1MHz EnergySave mode, after many successful
               wakenings, it didn't wake me up this night
       (added) New menu elements for Playlist Edit (clear, load, save)

0.4a
Engine (added) USB Mass Storage
GUI    (added) USB Mass Storage Menu Item
       (added) Colors!
       (added) New Menuselection method
       (added) Let the user write a message and display it in the WakeMode

0.3a
Engine
GUI    (added) Exit by Menu
       (added) Default Directory is ms0:/PSP/MUSIC now with a fallback to ms0:
               if ms0:/PSP/MUSIC doesn't exist
       (added) Filebrowser now only accepts .mp3 files to be selected
       (bugfx) Enters EnergySave Mode now even if SleepList is empty
       (bugfx) Directories now correctly identified
       (added) faster scrolling in filebrowser and up&down warp
       
0.2a
Engine (added) Assumably working MP3 Stop, Pause and Play Feature
       (test ) Works with cbr, vbr, abr up to 320kbit/s
GUI    (added) File Browser

0.1
Engine (added) Streaming MP3
       (todo ) MP3 Stop and Play behave strange

pre 0.1
Engine (added) MP3 audio player
       (todo ) MP3 fully loaded to memory
GUI    (added) Basic Menu Structure

- -- --------------------------------------------------------------------- -- -
VIII EOF - Visit www.mk2k.net
- -- --------------------------------------------------------------------- -- -