18b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectAndroid Emulator changes: 28b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project========================= 38b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 48b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectVersions: 58b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 68b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.0 => SDK M3 release 78b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.1 => SDK M5 release 88b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.2 => Internal release (build 72264) 98b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.3 => Internal release (build 77780) 108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.4 => Internal release (build 84853) 118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.5 => SDK 0.9_r1 128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.6 => SDK 1.0_r1 138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.7 => SDK 1.0_r2 148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 1.8 => SDK 1.1 15d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 1.9 => SDK 1.5_r1 (and SDK 1.5_r2) 16d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 1.10 => SDK 1.5_r3 175ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner 1.11 => SDK 1.6_r1 188b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1.12 => SDK 2.0 198b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1.13 => SDK 2.0.1 (but wrongly tagged 1.12) 200d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner 210d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner Starting from here, the emulator version number will match 220d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner the corresponding SDK Tools release level, i.e.: 230d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner 240d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner 5.0 => SDK Tools release 5 250d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner 6.0 => SDK Tools release 6 26eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine 7.0 => SDK Tools release 7 270d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner etc... 288b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 298b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner============================================================================== 30a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-HugueninChanges between 8.0 and 7.0 31a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 32a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-HugueninIMPORTANT CHANGES: 33a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 34a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-HugueninOTHER: 35a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 36a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin- The phone can now be called with additional numbers, using the 1-555-521 37a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin prefix. I.e. you can now use all of the following numbers to call/sms an 38a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin emulator that runs on console port 5554: 39a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 40a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 5554 41a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 521 5554 42a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 555 521 5554 43a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 1 555 521 5554 44a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin 45c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner- Fix -http-proxy implementation to properly work with chunked encodings. 469b98dbde344781e93e2bdcfa599428cda2fda41dDavid 'Digit' Turner 479b98dbde344781e93e2bdcfa599428cda2fda41dDavid 'Digit' Turner Also try to connect to the proxy on startup to see if the host/port are 489b98dbde344781e93e2bdcfa599428cda2fda41dDavid 'Digit' Turner valid. If no connection succeeds after 1 second, dump a warning and 499b98dbde344781e93e2bdcfa599428cda2fda41dDavid 'Digit' Turner ignore the proxy for the session. 50c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner 51c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner- The console's "geo fix" command was modified: 52c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner 53c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner - a computational bug sent the wrong latitude/longitude to the emulated 54c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner system, resulting in coordinates that could be off from 500 to 1000 meters. 55c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner 56c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner - fixed another bug that didn't report the altitude correctly. 57c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner 58c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner - added a fourth, optional, parameter to indicate the number of tracked 59c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner satellites to emulate. The number must be an integer between 1 and 12, 60c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner (1 is the default). 61c97ba1ea0905cebc6dc089ee5126209d606ef296David 'Digit' Turner 624afdaf1285ecdcbcfeac6d3e9be0b9b0de0e2b07Tim Baverstock - fixed a bug in parameter handling: the implementation disagreed with the 634afdaf1285ecdcbcfeac6d3e9be0b9b0de0e2b07Tim Baverstock documentation, requiring an additional dummy fourth argument. Now four or 644afdaf1285ecdcbcfeac6d3e9be0b9b0de0e2b07Tim Baverstock five parameters are accepted (for backwards compatibility), but the last is 654afdaf1285ecdcbcfeac6d3e9be0b9b0de0e2b07Tim Baverstock always the satellite count. 664afdaf1285ecdcbcfeac6d3e9be0b9b0de0e2b07Tim Baverstock 67415a4b1f54f896bf28abe1beb2d8005a3d98f531David 'Digit' Turner - Add a PulseAudio audio backend on Linux. It will be used by default 68415a4b1f54f896bf28abe1beb2d8005a3d98f531David 'Digit' Turner unless it's impossible to connect to the PA daemon. 69415a4b1f54f896bf28abe1beb2d8005a3d98f531David 'Digit' Turner 70e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner - It is now possible to access the QEMU monitor from the console. 71e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner Just type "qemu monitor" and you will be at the monitor prompt. 72e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner 73e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner Note that the monitor 'quit' command will not stop the emulator, 74e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner but will simply close the connection instead. 75e92bc56ef89ab8b51c4c89d4d9779b64e9491b9bDavid 'Digit' Turner 76a1b379c65f787fc85bd9c6f4a6d14d8a2bebc9d5Marc Petit-Huguenin============================================================================== 77eeac013f898716ec7e7acf419953fb253cd06916Vladimir ChtchetkineChanges between 7.0 and 6.0 78eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine 79eeac013f898716ec7e7acf419953fb253cd06916Vladimir ChtchetkineIMPORTANT CHANGES: 80eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine 81eeac013f898716ec7e7acf419953fb253cd06916Vladimir ChtchetkineOTHER: 82eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine 83eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine- Removed audio stack SDL dependency. 84eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine 8540beab42ecdc4e2a79714b54c401feb0fb33b6d0Dries Harnie- Add a '-shared-net-id' option which allows emulators to join a shared network. 8640beab42ecdc4e2a79714b54c401feb0fb33b6d0Dries Harnie This allows testing situations where emulators need to communicate directly 8740beab42ecdc4e2a79714b54c401feb0fb33b6d0Dries Harnie with each other. See '-help-shared-net-id' for more details. 8840beab42ecdc4e2a79714b54c401feb0fb33b6d0Dries Harnie 893bca7734dc4b3a9e1e24964183d9765780dee4eaDavid 'Digit' Turner- Fix net shaping regression: -netspeed and -netdelay did not work anymore. 903bca7734dc4b3a9e1e24964183d9765780dee4eaDavid 'Digit' Turner 91eeac013f898716ec7e7acf419953fb253cd06916Vladimir Chtchetkine============================================================================== 92e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' TurnerChanges between 6.0 and 5.0 93e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner 94e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' TurnerIMPORTANT CHANGES: 95e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner 96e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner- Add a '-memcheck' option to instrument memory reads/writes at runtime in 97e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner order to detect buffer under/overflows. This requires a new version of the 98e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner C library that is only available in Froyo and above. 99e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner 1000d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner- Fix '-http-proxy' on Win32. This was actually a regression introduced 1010d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner with the Donut SDK. 1020d6e3e2b1510319f218d8b6f1590f25079d4fc4aDavid 'Digit' Turner 103e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' TurnerOTHER: 104e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner 105e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner- Add a '--static' option to both android-configure.sh and android-rebuild.sh 106e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner in order to build a completely static executable. This is required to run 107e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner the emulator in restricted environments. No audio and graphics in this mode 108e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner so using '-no-window' is required. 109e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner 110e4c6b1f1dda3ebfb4e88d7c0f1d2676d685cb438David 'Digit' Turner============================================================================== 111a383d02cb57dd7dadd382654175e51354073a139David 'Digit' TurnerChanges between 5.0 and 1.13 112a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner 113a383d02cb57dd7dadd382654175e51354073a139David 'Digit' TurnerIMPORTANT CHANGES: 114a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner 115a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner- Starting from this release, the emulator's version number will match the 116a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner corresponding Android SDK Tools package revision number. The exact number 117a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner is extracted at build time from the Android source tree. 118a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner 119a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner The minor number will now be stuck to 0 since each official emulator 120a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner release is supposed to match a corresponding SDK Tools release. 121a383d02cb57dd7dadd382654175e51354073a139David 'Digit' Turner 1228b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1238b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' TurnerOTHER: 1248b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1258b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner- Fixed a bug that crashed the emulator when the SD Card image size was exactly 1268b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 8 MB. Now, the minimum supported size is 9 MB, and the emulator will complain 1278b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner with a human-friendly message if this is not the case, and ignore the SD Card 1288b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner file. 1298b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1308b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner============================================================================== 1318b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' TurnerChanges between 1.13 and 1.12 1328b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1338b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' TurnerIMPORTANT BUG FIXES: 1348b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1358b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner- Fix D-Pad rotation issues in the skins. The problem being that switching 1368b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner the emulator window to landscape mode resulted in incorrectly rotated 1378b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner D-Pad events. The fix allows for a new 'dpad-rotation' field for each 1388b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner layout. 1398b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner 1408b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner- Fixed a bug in Thumb2 emulation (not used by typical SDK images yet though) 1418b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner that resulted incorrect behaviour / crashes, especially in single-stepping 1428b657e5deaa03b989b0b36791fcf2aa6b2882656David 'Digit' Turner mode. 1435ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner 1445ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner============================================================================== 1455ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' TurnerChanges between 1.12 and 1.11 1465ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner 1475ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' TurnerIMPORTANT BUG FIXES: 1485ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner 1495ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner- Fixed a nasty race condition in the Linux EsounD audio backend which resulted 1505ad9febb1c7e08fe24413f9bd04f30d92b4cfa3aDavid 'Digit' Turner in rare lockups when stopping the emulator on this platform. 151d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 152abe0822e3cccae6098c56f4fecb029f300b9a01aDavid 'Digit' Turner- The key-bindings for the Menu button (F2 and PageUp by default) didn't work 153abe0822e3cccae6098c56f4fecb029f300b9a01aDavid 'Digit' Turner due to a typo. 154abe0822e3cccae6098c56f4fecb029f300b9a01aDavid 'Digit' Turner 155cd059b15f2c7df69f4a087bd66900eb172e41d1cDavid 'Digit' TurnerOTHER: 156cd059b15f2c7df69f4a087bd66900eb172e41d1cDavid 'Digit' Turner 1575d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner- Sources have been refreshed by a large integration of upstream QEMU 1585d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner sources (version 0.10.50). The integration is based on the following commit, 1595d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner dated 2009-06-19: 1605d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner 1615d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner d2e9fd8f703203c2eeeed120b1ef6c3a6574e0ab 1625d8f37ad78fc66901af50c762029a501561f3b23David 'Digit' Turner 163d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner============================================================================== 164d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' TurnerChanges between 1.11 and 1.10 165d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 166d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' TurnerIMPORTANT BUG FIXES: 167d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 168d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner- Fixed ANDROID_SDK_HOME being ignored on Unix (not Windows). This environment 169d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner variable is used to locate a user's configuration files for the SDK, with a 170d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner default value of ~/.android 1718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 172a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' TurnerOTHER: 173a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 174a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner- Add "KEY_XXX" name alias for EV_KEY codes. This means that the console 175a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner command "event codes EV_KEY" will now return KEY_XXX code names (in addition 176a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner to BTN_YYY ones), and that you can use "event send EV_KEY:KEY_SOFT1:1" 177a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner instead of "event send EV_KEY:229:1" to simulate the press of the Menu 178a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner button. 179a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 180a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner The KEY_XXX values are defined by Linux. The following Android-specific 181a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner mappings apply: 182a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 183a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_HOME => Home key 184a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_BACK => Back key 185a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_SEND => Call key (e.g. Green Phone) 186a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_END => EndCall key (e.g. Red Phone) 187a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_SOFT1 => Menu key 188a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 189a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_VOLUME_UP 190a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_VOLUME_DOWN 191a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 192a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_SEARCH => Search key (if any) 193a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_POWER => Power button 194a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_CAMERA => Camera button 195a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 196a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_DOWN / UP / LEFT / RIGHT => DPad keys 197a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner KEY_CENTER => DPad / trackball click 198a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 199a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner Beware: KEY_MENU does *not* correspond to the "Menu" key of most Android 200a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner devices. 201a69c35e9e398346ba34b7c82f56f2b5565ebabfeDavid 'Digit' Turner 2028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 203e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.10 and 1.9 204e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 205e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerIMPORTANT BUG FIXES: 206e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 207e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed sock_address_init_resolve() in sockets.c to work properly on 208e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner IPv6 capable systems, when the list returned by getaddrinfo() doesn't 209e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner necessarily reflect the simplistic heuristics that were used by the 210e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner previous implementation. On such systems, inter-emulator telephony 211e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner and SMS didn't work properly, as well as certain other network-related 212e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner tasks. 213e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 214e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerIMPORTANT CHANGES: 215e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 216e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Skins can now provide a button for the "SEARCH" scan-code, simply using 217e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner the "search" label for it. 218e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 219e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- A new option '-prop <name>=<value>' can be used to set a system property 220e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner at boot time in the emulated system. This only works for system images 221e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner starting at 1.5_r3, and will be ignored for older ones. 222e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 223e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner Note that properties starting with "ro." can only be set once. Moreover, 224e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner all system properties in the system build.prop or local.prop are parsed 225e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner by init before anything else. Any "ro." property in them cannot be 226e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner changed with this option. 227e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 228d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner- Allow the HTTP proxy implementation to receive chunked encoding data. 229d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner This shall solve problems when talking to Microsoft proxies. 230d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner 231e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerOTHER: 232e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 233e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Allow the SEARCH key-binding (F5) to work on keyboard-less hardware 234e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner configurations (AVDs). 235e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 236e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed a typo which prevented the kernel gdbstub from working properly 237e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 238e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed bad QADD/QDADD/QSUB/QDSUB emulation in the ARM JIT. 239e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 240e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed one minor crash when the Linux OSS audio backend was used with the 241e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner -debug-audio option. 242e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 243e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed emulator tracing bug (basic block address could be wrong). And add 244e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner support for recording native (JNI) calls when profiling. 245e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 246e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Fixed build for platforms where deprecated symbol EAI_NODATA is not 247e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner defined. 248e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 249d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner- Fix GPS emulation to allow several clients concurrently. There are still 250d68b48725d720a06b24932b170f528929856f3dbDavid 'Digit' Turner problems that may be due to changes in the system's framework. 251e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 252e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner- Added some technical documentation in the docs/ directory. 253e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner 254e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' Turner============================================================================== 255e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.9 and 1.8 2568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT CHANGES: 2588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Many features have been integrated from upstream QEMU sources, including 2608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the new TCG code generator used by the ARM translator. This should result 261fff1ae51e389c25e2b19cd087c5e19cd27d40163David Turner in slightly faster execution speed on all supported platforms. Another 262fff1ae51e389c25e2b19cd087c5e19cd27d40163David Turner benefit is that you no longer require a specific (and obsolete) version 263fff1ae51e389c25e2b19cd087c5e19cd27d40163David Turner of GCC to build the emulator. 2648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The emulator now requires that you specify a virtual device name when 2668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project starting the emulator, prefixed with the '@' sign. For example, to start 2678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the 'foo' virtual device, type: 2688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulator @foo 2708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Each AVD (Android Virtual Device) corresponds to a directory used to store 2728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project mutable disk images, an optional system image/kernel/sdcard, plus some 2738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project configuration file(s). 2748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project The command-line tool 'android' that comes with the SDK can be used to 2768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project create/list/remove virtual devices on your system. 2778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Note that the '@<name>' form is a convenience shortcut for '-avd <name>'. 2798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project It is thus possible to place options after the AVD name on your command 2808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project line, as in: 2818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulator @foo -verbose -shell 2838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Finally, when building the Android platform source tree, an AVD name is not 2858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project required and 'emulator' will start a new emulator instance exactly as 2868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project previously. 2878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- A new option '-sysdir <dir>' has been introduced, the interpretation of 2898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the '-system' option has changed, and '-image <file>' should now be 2908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project considered obsolete. In more details: 2918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * you should now use '-sysdir <dir>' instead of '-system <dir>' to specify 2938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the directory where system images will be searched by the emulator 2948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project on startup. 2958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * you should now use '-system <file>' to indicate which system.img partition 2978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project image to use at startup. 2988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 2998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * you should not use '-system <dir>' or '-image <path>' anymore. However, 3008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project these options are still supported but will print a warning to remind you 3018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project to change your scripts/habits. 3028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project The change was done to reduce confusion as to what these options provide. 3048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Options '-noaudio', '-nojni', '-noskin' and 'nocache' are deprecated. 3068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project You should use '-no-audio', '-no-jni', '-no-skin' and '-no-cache' instead. 3078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Option 'initdata' is deprecated, you should use '-init-data' instead. 3098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Hardware emulation is now limited to the corresponding Android Virtual 3118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Device's configuration. This means it is now possible to not emulate 3128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project a touch-screen, trackball, dpad, keyboard, modem, etc... 3138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Note that in the case of the Android build system, all hardware properties 3158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project are enabled by default, so this only affects "normal" virtual devices 3168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project created with the 'android' tool. 3178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The emulator now supports capturing network packets to a file. 3198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project You can either use the new -tcpdump <file> command-line option, or use 3208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the new console 'network capture start <file>' command (then use 3218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 'network capture stop' to stop it). 3228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project This captures all ethernet packets on the virtual LAN, so this includes 3248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project ARP, UDP, TCP, etc... The file is in libpcap format and can be opened with 3258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project external tools like WireShark for analysis. 3268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 3288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The file in ~/.android/default.keyset was ignored, unless you used 3308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-keyset default' explicitely. It is now loaded automatically when 3318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project available. 3328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Environment variable ANDROID_SDK_ROOT can be used to specifiy the location 3348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of the SDK installation path. 3358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Environment variable ANDROID_SDK_HOME can be used to specify the location 337fff1ae51e389c25e2b19cd087c5e19cd27d40163David Turner of the '.android' data directory (which defaults to your $HOME). 3388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- A new console command 'avd name' can be used to query the name of the 3408b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project virtual device running in the emulator. Note that it will be '<build>' 3418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project if you run from the Android build system. 3428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Also, the emulator's window title also displays the AVD name now. 3448b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The option '-memory <size>' has been added. <memory> must be an integer 3468b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project specifying the amount of physical RAM in the emulated device in megabytes. 3478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project The default value is 96. 3488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The '-skindir <path>' option now requires that you specify a '-skin <name>' 3508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project option as well. 3518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Better handling of Audio on Linux for the EsounD and Alsa backends 3538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fullscreen toggle should now work on Windows and OS X. On Linux, the 3558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project toggle will not switch the display resolution anymore (which resulted 3568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project in distorted images). 3578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 35892c7311b1cb354745ec7b59b0e03910b3fe4c205The Android Open Source Project- Using '-no-audio' no longer disables sound hardware emulation. It simply 35992c7311b1cb354745ec7b59b0e03910b3fe4c205The Android Open Source Project mutes the emulator program on the host. 36092c7311b1cb354745ec7b59b0e03910b3fe4c205The Android Open Source Project 361791d86195fedca3a8cba5d7fa3e3610302361a78David Turner- The window title bar changes when you toggle persistent trackball mode 362791d86195fedca3a8cba5d7fa3e3610302361a78David Turner (F6 by default). It will display something like the following: 363791d86195fedca3a8cba5d7fa3e3610302361a78David Turner 364791d86195fedca3a8cba5d7fa3e3610302361a78David Turner "Press F6 to exit trackball mode ..." 365791d86195fedca3a8cba5d7fa3e3610302361a78David Turner 366791d86195fedca3a8cba5d7fa3e3610302361a78David Turner The actual text depends on your key binding configuration. This is to help 367791d86195fedca3a8cba5d7fa3e3610302361a78David Turner people toggle the mode by accident. 368791d86195fedca3a8cba5d7fa3e3610302361a78David Turner 3698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 370e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.7 and 1.6 3718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT BUG FIXES: 3738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Properly create ~/.android directory when needed. 3758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Do not leave temporary files in Android app-specific directory on Win32 3778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Support for HTTP/HTTPS proxies has been considerably improved and should now 3798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project "just work" with a lot more HTTP proxies. In case of problem, use the 3808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project -debug-proxy option to dump debugging data to stderr. 3818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 3838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Trackball emulation has changed. First, the awkward "Control-T" keybinding 3858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project is gone. Instead, you can now: 3868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project - press 'Delete' to show the trackball and have it disappear as soon 3888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project as your release the key. 3898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project - press 'F6' to perform a persistent trackball mode toggle. 3918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Also, trackball emulation is fixed in rotated/landscape mode now. 3938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- New option '-nand-limits <limits>' allows you to send a signal to a remote 3958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project process when a read or write threshold on flash storage is reached. This is 3968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project only useful for hardcore Android system hackers. 3978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 3988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix emulator build on recent Cygwin releases (the -mno-cygwin headers do not 3998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project tolerate the _GNU_SOURCE macro definition anymore) 4008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix Win32 emulator to support SD Card images larger than 2 GiB 4028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The non-Android build system has been completely rewritten to allow building 4048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulator on Linux x86_64. Also, there is now a single Makefile that 4058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project drives the build in both Android and non-Android modes. 4068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- '-qemu <other-options>' works again 4088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 410e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.6 and 1.5 4118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT CHANGES: 4138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Emulator now saves the user image in <android>/SDK1.0/ 4158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 4178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Get rid of EsounD-related freezes on Linux (again) 4198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix the documentation in -help-audio. '-audio list' doesn't work, one 4218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project needs to call -help-audio-out and -help-audio-in to get the list of valid 4228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project audio backends 4238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix scrollwheel Dpad emulation in rotated mode. before that, using the 4258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project scroll-wheel would always generated Dpad Up/Down events, even when in 4268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project landscape mode. 4278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Re-enable CPU fault emulation in case of unaligned data access. this was 4298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project previously disabled because it crashed the emulated kernel in previous 4308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project releases. 4318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- The emulator no longer prints an obscure warning when it doesn't find 4338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulator.cfg configuration file in ~/.android. 4348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 'broken configuration file doesn't have a 'window' element' 4368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4378b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Removed a bunch of obsolete options (e.g. -console, -adb-port, etc...) 4388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Setting the network speed through the console or the -netspeed option will 4408b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project properly modify the connectivity icon on the device. 4418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Setting the GSM voice registration state to 'roaming' in the console will 4438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project properly modify the voice icon on the device 4448b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 446e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.5 and 1.4 4478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT BUG FIXES: 4498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix spurious discards of SMS messages when using two emulators. 4518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 4538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Get rid of EsounD-related freezes on Linux (again) 4558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix the documentation in -help-audio. '-audio list' doesn't work; one 4578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project needs to call -help-audio-out and -help-audio-in to get the list of valid 4588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project audio backends 4598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Fix scrollwheel Dpad emulation in rotated mode. before that, using the 4618b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project scroll-wheel would always generated Dpad Up/Down events, even when in 4628b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project landscape mode. 4638b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- Re-enable CPU fault emulation in case of unaligned data access. This was 4658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project previously disabled because it crashed the emulated kernel in previous 4668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project releases. 4678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 469e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.4 and 1.3 4708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT BUG FIXES: 4728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fix for audio-related Linux startup freezes when using the 'esd' and 'alsa' 4748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project backends 4758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the number of audio buffers in the Windows backend has been incremented. 4778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project this gets rid of audio chopiness issues on Vista (and sometimes on XP too) 4788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW FEATURES: 4808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW CONSOLE COMMANDS: 4828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- new 'geo fix <lontitude> <latitude> [<altitude>]' command allows you to 4848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project send a simple GPS fix to the emulated system, without the headaches of 4858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project NMEA 1083 formatting. 4868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER BUG FIXES: 4888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fixed the -audio, -audio-in and -audio-out options (the <backend> values 4908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project were sometimes ignored) 4918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectREGRESSIONS: 4938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 4958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the transitional '-qemud' option introduced in 1.3 is now gone. its 4978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project behaviour is now the default. 4988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 4998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- use the new '-old-system' option if you need to use a 1.4+ emulator binary 5008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project with older system images. if you don't use it, GSM and GPS emulation will 5018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project not work correctly (among other things). 5028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the obsolete '-oldradio' option is now gone 5048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on some Unix systems, SIGALRM is blocked by default, so unblock it when 5068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project creating the alarm timer 5078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the 'esd' and 'alsa' libraries dump a lot of error messages to the console 5098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project by default on Linux. these are now disabled unless you use '-debug audio' 5108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- added the '-help-char-devices' help topic that describe the specification 5128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of the <device> parameter of options like -serial, -gps, -shell-serial, 5138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project etc... 5148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectKNOWN ISSUES: 5168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for video input 5188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for mutable SIM Card emulation yet 5198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for bluetooth 5208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for WiFi 5218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on some Linux machines, the emulator might get stuck at startup. this 5238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project seems to be related to audio input support. try starting with 5248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-audio-in none' or even '-noaudio' to disable sound, or choose a 5258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project different audio backend by defining QEMU_AUDIO_DRV to an appropriate 5268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project value (read below). 5278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you can also select different audio backends for both output and input 5298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently. 5308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on Windows, the emulator takes about 10-15% of the CPU even when the 5328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system is idle. this is a known issue related to QEMU's internal 5338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project event loop and Winsock. this should be fixed in a future emulator release. 5348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- GPS emulation only if you use the '-qemud' option. this is an experimental 5368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project option that is soon going to be the default. without this option, the 5378b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system will start but GPS emulation will not work. 5388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project for the record, 'qemud' is a serial port multiplexer that is used to 5408b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project multiplex several communication channels between the emulator and the 5418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system, though a single serial port. 5428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 544e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.3 and 1.2 5458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5468b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT BUG FIXES: 5478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW FEATURES: 5498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- '-audio-in <backend>' allows you to select the audio input backend from the 5518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project command line. this is equivalent to defining QEMU_AUDIO_IN_DRV=<backend> 5528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-audio-out <backend>' works for the audio output, and '-audio <backend>' 5548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project will select both input and output at the same time 5558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- '-debug <tags>' has replaced the old '-verbose-<tag1> -verbose-<tag2> ...' 5578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project debugging option. <tags> is a comma-separated list of debug tags 5588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project (see -help-debug-tags for a complete list). you can also use the special 5598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project value 'all' to indicate all debug tags, or prefix a '-' before a tag 5608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project name to disable it. for example: 5618b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5628b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project -debug all,-audio 5638b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project enables all debugging except audio. '-debug-<tag>' still works though. 5658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project note that while '-verbose-<tag>' is deprecated, '-verbose' is still supported 5678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project as an alias to '-debug-init' 5688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- '-keyset <file>' allows you to specific the keyset file to use. the default 5708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project is still ~/.android/default.keyset on Unix. for Windows, use -help-keyset 5718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project to get its default location (which differs between XP and Vista) 5728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW CONSOLE COMMANDS: 5758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the 'geo nmea <sentence>' can be used to send a NMEA 1083 sentence as if 5778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project it came from an emulated GPS unit. NOTE: this doesn't work unless you 5788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project also use the '-qemud' option (see KNOWN ISSUES below) 5798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER BUG FIXES: 5818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- severe color artefact issues when scaling the emulator window < 1.0 were 5838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project fixed. 5848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fix rare random emulator freezes on Linux by disabling the 'dynticks' timer. 5868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectREGRESSIONS: 5888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 5908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the ambiguous '-console' option is now obsolete. use '-shell' instead 5928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new '-shell-serial <device>' allows you to specify a device to 5948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project connect a root shell session to the emulated system. 5958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the '-debug-kernel' option is now known as '-show-kernel' (the -debug- 5978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project prefix is reserved for strict emulator debugging features) 5988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 5998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- '-adb-port' has been removed from the list of options. similarly 6008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-port <port>' will accept an odd port number, but will print a warning 6018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project that it is using <port>-1 instead. 6028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- MMX is used on x86 to speed up window rescaling. 6048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new '-qemud' option is required to have GPS support work in this 6068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project SDK (either through '-gps <device>' or the 'geo nmea <sentence>' 6078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project console command) 6088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project this option is purely experimental and will soon become the default. 6108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectKNOWN ISSUES: 6128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for video input 6148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for mutable SIM Card emulation yet 6158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for bluetooth 6168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for WiFi 6178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on some Linux machines, the emulator might get stuck at startup. this 6198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project seems to be related to audio input support. try starting with 6208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-audio-in none' or even '-noaudio' to disable sound, or choose a 6218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project different audio backend by defining QEMU_AUDIO_DRV to an appropriate 6228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project value (read below). 6238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you can also select different audio backends for both output and input 6258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently. 6268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on Windows, the emulator takes about 10-15% of the CPU even when the 6288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system is idle. this is a known issue related to QEMU's internal 6298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project event loop and Winsock. this should be fixed in a future emulator release. 6308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- GPS emulation only if you use the '-qemud' option. this is an experimental 6328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project option that is soon going to be the default. without this option, the 6338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system will start but GPS emulation will not work. 6348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project for the record, 'qemud' is a serial port multiplexer that is used to 6368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project multiplex several communication channels between the emulator and the 6378b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system, though a single serial port. 6388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project============================================================================== 640e15f24b5fc4c260bf5acbf9e4ff6331c745e5e42David 'Digit' TurnerChanges between 1.2 and 1.1 6418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectIMPORTANT BUG FIXES: 6448b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fixed a typo that prevented the F9/F10 keyboard shortcuts from working 6468b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project properly, making non-programatically tracing unusable. 6478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- halve the emulator's memory requirements, saving around 130 megabytes 6498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of memory by changing the way flash images are accessed (we now use 6508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project temporary files instead) 6518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- this emulator binary should be 10% to 20% faster than previous ones on 6538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the Windows and OS X platforms. for faster boots, you may also want to 6548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project use the -no-boot-anim option described below to speed up the initial 6558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project boot sequence as well on slow machines. 6568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- proper rotation support when using Keypad 7/9 to switch between layouts 6588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project in the default HVGA skin. no need to use Ctrl-PageDown anymore 6598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the -http-proxy <proxy> option didn't work correctly on Windows (unless 6618b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you were very lucky). 6628b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6638b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- general socket handling code on Windows has been significantly improved. 6648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW FEATURES: 6678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the console port number of a given emulator instance is now displayed in 6698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project its window's title bar. 6708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- voice/sms are automatically forwarded to other emulator instances running 6728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project on the same machine, as long as you use their console port number as the 6738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project destination phone number. 6748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project for example, if you have two emulator running, the first one will usually 6768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project use console port 5554, and the second one will use port 5556 6778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project then dialing 5556 on the 1st emulator will generate an incoming call on 6798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the 2nd emulator. you can also hold/unhold calls as well. 6808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project this also works when sending SMS messages from one emulator to the other 6828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the help system has been totally revamped: 6848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * -help prints a summary of all options and help topics 6868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * -help-<option> prints option-specific help 6878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * -help-<topic> prints various topical help text 6888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project * -help-all prints *all* help content at once 6898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the emulator now tries to automatically detect the host time zone and sends 6918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project it to the emulated system at startup (through the GSM modem). there is also 6928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project a new '-timezone <timezone>' option to be able to specify a different one. 6938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project IMPORTANT: the <timezone> name must be in zoneinfo format, i.e. 6958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Area/Location, human-friendly abbreviations like "PST" or "CET" 6968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project will not work. examples are: 6978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 6988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project America/Los_Angeles 6998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Europe/Paris 7008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the emulator can now use up to 4 distinct DNS servers (instead of only one). 7028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project by default, they are taken from your system's list, which is obtained by 7038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project calling GetNetworkParams() on Win32, and parsing /etc/resolv.conf on 7048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Unix. 7058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new '-dns-server <server>' option can be used to specify a comma-separated 7078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project list of alternative DNS servers to be used by the emulated system, instead of 7088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the system's default. 7098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new '-scale <fraction>' option allows you to scale the emulator 7118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project window. <fraction> can be a number between 0.1 and 3.0. 7128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you can also use '-scale <value>dpi', (e.g. '-scale 110dpi') to indicate the 7148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project resolution of your host monitor screen. it will be divided by the emulated 7158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project device's resolution to get an absolute scale. 7168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new '-dpi-device <dpi>' option allows you to specific the resolution of 7188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulated device's screen. Note that this is not required: the default 7198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project used is 165, which is the average of several prototypes we've been working 7208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project with. 7218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- add a new '-port <port>' option to specify which port the emulator should 7238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project bind to for the console, instead of letting it guess. <port> must be an 7248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project *even* integer between 5554 and 5584 included. the corresponding ADB port 7258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project will be <port>+1 7268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- [DEPRECATED] add a new '-adb-port <port>' option to specify which port the 7288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulator should bind to, instead of letting it guess. <port> must be an odd 7298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project integer between 5555 and 5585 included. the corresponding control console 7308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project will be on <port>-1 7318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project NOTE: -adb-port is deprecated, don't use it, it will probably disappear 7338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project NOTE2: you cannot use both -port and -adb-port at the same time. 7348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new '-no-boot-anim' options tells the emulated system to disable the boot 7368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project animation. on slow systems, this can *significantly* reduce the time to 7378b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project boot the system in the emulator. 7388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- you can now redefine the emulator's keybinding by writing a 'keyset' file 7408b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project and use '-keyset <filename>' to use it when starting the emulator. use 7418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project -help-keyset and -help-keyset-file for all details. 7428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project this allows you to use the emulator effectively on keyboards which don't 7448b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project have a keypad, by using different keys.. 7458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7468b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- you can now toggle between windowed and fullscreen mode at runtime by 7478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project pressing Alt-Enter (only works on Linux at the moment !!) 7488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- use '-audio-out <backend>' and '-audio-in <backend>' to change the output 7508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project and input audio backends used by the emulator. see -help-audio-out and 7518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project -help-audio-in for a list of valid values. 7528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project this is equivalent to setting the QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV 7548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project environment variables. 7558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project use '-audio <backend>' to set both the input and output backends at the 7578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project same time. this is equivalent to setting the QEMU_AUDIO_DRV environment 7588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project variable. 7598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7618b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectNEW CONSOLE COMMANDS: 7628b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7638b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new 'power' command can be used to control the power/battery state of 7648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulated device. 7658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new 'event send' command can be used to send simulated hardware events 7678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project to the Android Linux kernel. each event must be in the form 7688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project <type>:<code>:<value> where: 7698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project <type> is either an integer or a corresponding string alias 7718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project (use "event types" to see a list of aliases) 7728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project <code> is either an integer or a corresponding string alias 7748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project that depends on the value of <type> (use "event codes <type>" 7758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project to see a list of these aliases) 7768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project <value> is an integer 7788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project NOTE: Be warned that it is very easy to confuse the kernel about the state 7808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of emulated hardware by sending the wrong event. An *excellent* 7818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project knowledge of the Linux kernel internals is encouraged before playing 7828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project with "event send". 7838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new 'event text <textMessage>' command can be used to simulate 7858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project keypresses of small text messages, where <textMessage> is an utf-8 string. 7868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new 'avd stop' and 'avd start' command can be used to stop/start the 7888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulation. you can also use 'avd status' to query the current state. 7898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the new 'window scale <scale>' command allows you to change the scale of 7918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulator window dynamically. <scale> is either an integer followed by 7928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the 'dpi' suffix (e.g. '120dpi') or a real number between 0.1 and 3.0. 7938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project in the first case, <scale> specifies your monitor dpi; in the second one, 7958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the new window scale itself. 7968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 7988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER BUG FIXES: 7998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- in case of SDL_Init() failure, print the SDL error message. 8018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- disable networking code's logging to /tmp/slirp.log 8028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the emulator now works with 2GB SD Card files 8038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the emulator doesn't prevent the screensaver to kick in on OS X anymore 8048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the -onion and -onion-alpha options now work properly 8058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a second emulator instance trying to use the same SD Card instance than a 8068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project first one will no longer crash 8078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- it's now possible to properly start the emulator in the background on all 8088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project Unix shells (e.g. "emulator &") without being interrupted/stopped by a 8098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project SIGTTIN or SIGTTOU signal. 8108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fixed a bug in the SMS emulation that happened when using GSM 7-bit escaped 8118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project characters, i.e. anything in the following: [|]~\{}^ 8128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- fixed a small regression where -data <foo> would fail if the file <foo> 8138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project did not exist. 8148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectREGRESSIONS: 8178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- the -flash-keys options doesn't work anymore 8198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8218b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectKNOWN ISSUES: 8228b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8238b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for video input 8248b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for mutable SIM Card emulation yet 8258b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for bluetooth 8268b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- no support for WiFi 8278b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8288b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on some Linux machines, the emulator might get stuck at startup. this 8298b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project seems to be related to audio input support. try starting with 8308b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project '-audio-in none' or even '-noaudio' to disable sound, or choose a different 8318b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project audio backend by defining QEMU_AUDIO_DRV to an appropriate value 8328b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project (read below). 8338b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8348b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you can also select different audio backends for both output and input 8358b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently. 8368b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8378b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- on Windows, the emulator takes about 10-15% of the CPU even when the 8388b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulated system is idle. this is a known issue related to QEMU's internal 8398b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project event loop and Winsock. this should be fixed in a future emulator release. 8408b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8418b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source ProjectOTHER: 8428b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8438b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- you can now use -debug-<component> and/or -debug-no-<component> to 8448b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project enable or disable the debug messages of a given emulator component. this 8458b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project can be very useful for troubleshooting. for all details, use -help-debug 8468b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project and -help-debug-tags 8478b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8488b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- you can also use '-debug <tags>' where <tags> is a comma-separated list 8498b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of component names, optionally prefixed by a single '-'. see -help-debug 8508b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project and -help-debug-tags for all details 8518b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8528b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- you can now define the ANDROID_VERBOSE environment variable as a list 8538b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project of "debug" items (each <item> corresponds to a -debug-<item> option). 8548b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project for example, defining: 8558b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8568b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project ANDROID_VERBOSE=socket,keys 8578b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8588b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project is equivalent to using "-debug socket,keys" when invoking the emulator 8598b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8608b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- as a special case, -debug-slirp enables logging of the router/firewall 8618b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project operations to a temporary file (e.g. /tmp/android/slirp.log). you can 8628b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project also specify a logging bitmask with the ANDROID_SLIRP_LOGMASK environment 8638b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project variable (the default is a mask of 7). 8648b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8658b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- removed many obsolete / unused source files from the repository. also 8668b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project performed a rather heavy cleanup of the sources to make them somewhat 8678b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project more manageable. 8688b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8698b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- integrate dynticks support from upstream QEMU depot. this only allows one 8708b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project to provide more precise timing accuracy in the guest under Linux. 8718b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project (NOTE: disabled in the source code, since it seems that it freezes 8728b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the emulator sometimes) 8738b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8748b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- audio input is now working on OS X, Windows and Linux. on Linux, there 8758b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project are four different backends supported: EsounD, ALSA, OSS and SDL. they 8768b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project are accessed through dlopen/dlsym, which means that the emulator binary 8778b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project will run on any system. 8788b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8798b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project you can specify a given backend by defining the QEMU_AUDIO_DRV environment 8808b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project variable to one of these values: 8818b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8828b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project alsa 8838b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project esd 8848b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project sdl 8858b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project oss 8868b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project none 8878b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8888b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project note that the "sdl" audio backend is the most compatible, but doesn't 8898b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project support audio input at all !! 8908b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8918b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- a new option '-cpu-delay <delay>' can be used to slow down the CPU 8928b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project emulation. the <delay> is an integer between 0 and 1000. note that it 8938b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project doesn't necessarily scale linearly with effective performance. 8948b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8958b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the delay process is not exactly deterministic. this is just a hack that 8968b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project may disappear or be completely re-implemented in the future 8978b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 8988b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- some new "gsm" and "sms" subcommands were added to the control console. 8998b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project they are used internally by the voice/sms auto-forwarder and are probably 9008b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project not very useful to typical developers 9018b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 9028b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- some code has been added to support save/restore of the AVD state to/from 9038b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project a file. however this is not properly tested yet, and requires that you 9048b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project use exactly the same options and disk images when reloading the AVD state. 9058b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 9068b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- added a new -cache <file> option to specify the cache partition image 9078b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project file. the default is to use a temporary file instead 9088b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 9098b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- added a new -report-console <socket> option to be able to report the 9108b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project automatically assigned console port to a remote third-party (e.g. a 9118b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project script) before starting the emulation. see the output of -help for all 9128b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the details 9138b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project 9148b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project- (only useful to Android engineers) 9158b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project the audio sub-system is now compiled in its own static library (called 9168b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project libqemu-audio.a), which gets copied to the Android "prebuilt/Linux/qemu" 9178b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project directory. this is done to avoid forcing all developers to install various 9188b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project development packages on Linux, as well as all build servers. there is also 9198b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project now a script named "distrib/update-audio.sh" which will update the depot 9208b23a6c7e1aee255004dd19098d4c2462b61b849The Android Open Source Project file automatically for you: call it whenever you change the audio sources. 921