The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 1 | # This file describes the properties of a given virtual device configuration file. |
| 2 | # |
| 3 | # Note: Most top-level properties are boolean that control whether a feature is |
| 4 | # present or not. Sub-features that depend on it are ignored if their |
| 5 | # parent is set to 'false' or 'no' |
| 6 | # |
| 7 | # This file is parsed by 'android/tools/gen-hw-config.py' to generate |
| 8 | # 'android/avd/hw-config-defs.h'. The latter is a special header containing |
| 9 | # macro statements that is used several times: |
| 10 | # |
| 11 | # - once to define the fields of the AndroidHwConfig structure |
| 12 | # (see android/avd/hw-config.h) |
| 13 | # |
| 14 | # - once to implement the hardware configuration loader |
| 15 | # (see android/avd/hw-config.h) |
| 16 | # |
| 17 | # Hopefully, this file should also be read by a virtual device creation |
| 18 | # tool/wizard to provide a nice user interface (hence the presence of |
| 19 | # the 'abstract' and 'description' keys which are not currently used) |
| 20 | # |
| 21 | # |
| 22 | # NOTE: if you remove items from this file, be sure that you do not break |
| 23 | # the emulator build. |
| 24 | # |
| 25 | |
David 'Digit' Turner | 2d238fd | 2011-03-25 10:34:47 +0100 | [diff] [blame] | 26 | # CPU Architecture |
| 27 | name = hw.cpu.arch |
| 28 | type = string |
| 29 | default = arm |
| 30 | abstract = CPU Architecture |
| 31 | description = The CPU Architecture to emulator |
| 32 | |
| 33 | # CPU Model |
| 34 | # Leave it empty, and the default value will be computed from |
| 35 | # hw.cpu.arch. This is only useful for experimentation for now. |
| 36 | name = hw.cpu.model |
| 37 | type = string |
| 38 | default = |
| 39 | abstract = CPU model |
| 40 | description = The CPU model (QEMU-specific string) |
| 41 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 42 | # Ram size |
David 'Digit' Turner | 5377c5b | 2011-02-10 16:52:19 +0100 | [diff] [blame] | 43 | # Default value will be computed based on screen pixels |
| 44 | # or skin version |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 45 | name = hw.ramSize |
| 46 | type = integer |
David 'Digit' Turner | 3bbc919 | 2011-01-19 22:18:02 +0100 | [diff] [blame] | 47 | default = 0 |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 48 | abstract = Device ram size |
| 49 | description = The amount of physical RAM on the device, in megabytes. |
| 50 | |
| 51 | # Touch screen support |
| 52 | name = hw.touchScreen |
| 53 | type = boolean |
| 54 | default = yes |
| 55 | abstract = Touch-screen support |
| 56 | description = Whether there is a touch screen or not on the device. |
| 57 | |
| 58 | # Trackball support |
| 59 | name = hw.trackBall |
| 60 | type = boolean |
| 61 | default = yes |
| 62 | abstract = Track-ball support |
| 63 | description = Whether there is a trackball on the device. |
| 64 | |
| 65 | # Keyboard support (qwerty/azerty) |
| 66 | name = hw.keyboard |
| 67 | type = boolean |
| 68 | default = yes |
| 69 | abstract = Keyboard support |
| 70 | description = Whether the device has a QWERTY keyboard. |
| 71 | |
David 'Digit' Turner | 59e8e19 | 2011-02-10 17:40:04 +0100 | [diff] [blame] | 72 | # Keyboard lid support |
| 73 | # (I.e. can the qwerty keyboard be closed/hidden or opened/visible) |
| 74 | # this will be ignored if hw.keyboard is false |
| 75 | # |
David 'Digit' Turner | b64325d | 2011-03-22 16:07:01 +0100 | [diff] [blame] | 76 | # NOTE: As a special case, the default value will be 'false' if the |
| 77 | # AVD targets API level 12 or higher. See hwConfig_init() |
| 78 | # in external/qemu/android/avd/hw-config.c for more details. |
| 79 | # |
David 'Digit' Turner | 59e8e19 | 2011-02-10 17:40:04 +0100 | [diff] [blame] | 80 | name = hw.keyboard.lid |
| 81 | type = boolean |
| 82 | default = yes |
| 83 | abstract = Keyboard lid support |
| 84 | description = Whether the QWERTY keyboard can be opened/closed. |
| 85 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 86 | # DPad keys |
| 87 | name = hw.dPad |
| 88 | type = boolean |
| 89 | default = yes |
| 90 | abstract = DPad support |
| 91 | description = Whether the device has DPad keys |
| 92 | |
| 93 | # GSM Modem support |
| 94 | name = hw.gsmModem |
| 95 | type = boolean |
| 96 | default = yes |
| 97 | abstract = GSM modem support |
| 98 | description = Whether there is a GSM modem in the device. |
| 99 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 100 | # Camera support |
| 101 | name = hw.camera |
| 102 | type = boolean |
| 103 | default = no |
| 104 | abstract = Camera support |
| 105 | description = Whether the device has a camera. |
| 106 | |
| 107 | name = hw.camera.maxHorizontalPixels |
| 108 | type = integer |
| 109 | default = 640 |
| 110 | abstract = Maximum horizontal camera pixels |
| 111 | |
| 112 | name = hw.camera.maxVerticalPixels |
| 113 | type = integer |
| 114 | default = 480 |
| 115 | abstract = Maximum vertical camera pixels |
| 116 | |
| 117 | # GPS support |
| 118 | name = hw.gps |
| 119 | type = boolean |
The Android Open Source Project | b3ee93a | 2009-03-13 13:04:21 -0700 | [diff] [blame] | 120 | default = yes |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 121 | abstract = GPS support |
| 122 | description = Whether there is a GPS in the device. |
| 123 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 124 | # Battery |
| 125 | name = hw.battery |
| 126 | type = boolean |
| 127 | default = yes |
| 128 | abstract = Battery support |
| 129 | description = Whether the device can run on a battery. |
| 130 | |
The Android Open Source Project | 9877e2e | 2009-03-18 17:39:44 -0700 | [diff] [blame] | 131 | # Accelerometer (used for auto-rotation) |
| 132 | name = hw.accelerometer |
| 133 | type = boolean |
| 134 | default = yes |
| 135 | abstract = Accelerometer |
| 136 | description = Whether there is an accelerometer in the device. |
| 137 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 138 | # Audio input |
| 139 | name = hw.audioInput |
| 140 | type = boolean |
| 141 | default = yes |
| 142 | abstract = Audio recording support |
| 143 | description = Whether the device can record audio |
| 144 | |
| 145 | # Audio output |
| 146 | name = hw.audioOutput |
| 147 | type = boolean |
| 148 | default = yes |
| 149 | abstract = Audio playback support |
| 150 | description = Whether the device can play audio |
| 151 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 152 | # SDCard support |
| 153 | name = hw.sdCard |
| 154 | type = boolean |
| 155 | default = yes |
| 156 | abstract = SD Card support |
| 157 | description = Whether the device supports insertion/removal of virtual SD Cards. |
| 158 | |
David 'Digit' Turner | 48a3c66 | 2011-03-01 14:03:20 +0100 | [diff] [blame] | 159 | name = hw.sdCard.path |
| 160 | type = string |
| 161 | default = |
| 162 | abstract = SD Card image path |
| 163 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 164 | # Cache partition |
| 165 | name = disk.cachePartition |
| 166 | type = boolean |
| 167 | default = yes |
| 168 | abstract = Cache partition support |
| 169 | description = Whether we use a /cache partition on the device. |
| 170 | |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 171 | name = disk.cachePartition.path |
| 172 | type = string |
| 173 | default = |
| 174 | abstract = Cache partition |
| 175 | description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'. |
| 176 | |
The Android Open Source Project | 8b23a6c | 2009-03-03 19:30:32 -0800 | [diff] [blame] | 177 | name = disk.cachePartition.size |
| 178 | type = diskSize |
| 179 | abstract = Cache partition size |
| 180 | default = 66MB |
David 'Digit' Turner | c5b1270 | 2009-06-19 00:36:12 +0200 | [diff] [blame] | 181 | |
David 'Digit' Turner | 2507cab | 2011-02-10 16:29:17 +0100 | [diff] [blame] | 182 | # LCD width |
| 183 | name = hw.lcd.width |
| 184 | type = integer |
| 185 | default = 320 |
| 186 | abstract = LCD pixel width |
| 187 | |
| 188 | name = hw.lcd.height |
| 189 | type = integer |
| 190 | default = 640 |
| 191 | abstract = LCD pixel height |
| 192 | |
| 193 | name = hw.lcd.depth |
| 194 | type = integer |
| 195 | default = 16 |
| 196 | abstract = LCD color depth |
| 197 | description = Must be 16 or 32. Color bit depth of emulated framebuffer. |
| 198 | |
David 'Digit' Turner | c5b1270 | 2009-06-19 00:36:12 +0200 | [diff] [blame] | 199 | # LCD density |
| 200 | name = hw.lcd.density |
| 201 | type = integer |
| 202 | default = 160 |
| 203 | abstract = Abstracted LCD density |
| 204 | description = Must be one of 120, 160 or 240. A value used to roughly describe the density of the LCD screen for automatic resource/asset selection. |
David 'Digit' Turner | 03e1244 | 2009-10-07 17:21:34 -0700 | [diff] [blame] | 205 | |
Tim Wan | 470f6bd | 2011-04-13 15:18:08 +0200 | [diff] [blame] | 206 | # LCD backlight - Enable/Disable LCD backlight simulation |
| 207 | # default = no : Disabled |
| 208 | # default = yes : Enabled |
| 209 | name = hw.lcd.backlight |
| 210 | type = boolean |
| 211 | default = yes |
| 212 | abstract = LCD backlight |
| 213 | description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled. |
| 214 | |
David 'Digit' Turner | 03e1244 | 2009-10-07 17:21:34 -0700 | [diff] [blame] | 215 | # Maximum VM heap size |
| 216 | # Higher values are required for high-dpi devices |
David 'Digit' Turner | 5377c5b | 2011-02-10 16:52:19 +0100 | [diff] [blame] | 217 | # Default will depend on RAM size. |
David 'Digit' Turner | 03e1244 | 2009-10-07 17:21:34 -0700 | [diff] [blame] | 218 | name = vm.heapSize |
| 219 | type = integer |
David 'Digit' Turner | 5377c5b | 2011-02-10 16:52:19 +0100 | [diff] [blame] | 220 | default = 0 |
David 'Digit' Turner | 03e1244 | 2009-10-07 17:21:34 -0700 | [diff] [blame] | 221 | abstract = Max VM application heap size |
| 222 | description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes. |
Ola Albertsson | 7c8397a | 2010-12-17 14:53:44 +0100 | [diff] [blame] | 223 | |
| 224 | # Proximity sensor |
| 225 | name = hw.sensors.proximity |
| 226 | type = boolean |
| 227 | default = yes |
| 228 | abstract = Proximity support |
| 229 | description = Whether there is an proximity in the device. |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 230 | |
David 'Digit' Turner | 0b01949 | 2011-03-01 14:02:42 +0100 | [diff] [blame] | 231 | # Kernel image. |
| 232 | # |
| 233 | # kernel.path specified the path to the kernel image |
| 234 | # kernel.parameters specifies the string of kernel boot parameters. |
| 235 | # |
| 236 | name = kernel.path |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 237 | type = string |
| 238 | default = |
| 239 | abstract = Path to the kernel image |
| 240 | description = Path to the kernel image. |
| 241 | |
David 'Digit' Turner | 0b01949 | 2011-03-01 14:02:42 +0100 | [diff] [blame] | 242 | name = kernel.parameters |
| 243 | type = string |
| 244 | default = |
| 245 | abstract = kernel boot parameters string. |
| 246 | |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 247 | # Path to the ramdisk image. |
David 'Digit' Turner | 0b01949 | 2011-03-01 14:02:42 +0100 | [diff] [blame] | 248 | name = disk.ramdisk.path |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 249 | type = string |
| 250 | default = |
| 251 | abstract = Path to the ramdisk image |
| 252 | description = Path to the ramdisk image. |
| 253 | |
David 'Digit' Turner | 40841b2 | 2011-03-01 14:04:00 +0100 | [diff] [blame] | 254 | # System partition image(s). |
| 255 | # |
| 256 | # disk.systemPartition.path points to the read/write system partition image. |
| 257 | # if empty, a temporary file will be created, initialized with the content |
| 258 | # of .initPath |
| 259 | # |
| 260 | # disk.systemPartition.initPath is only used when .path is empty. It must |
| 261 | # then point to a read-only initialization system image file. |
| 262 | # |
| 263 | # disk.systemPartition.size is the ideal size of the system partition. The |
| 264 | # size is ignored if the actual system partition image is larger. Otherwise, |
| 265 | # it indicates the maximum size the disk image file can grow to. |
| 266 | # |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 267 | name = disk.systemPartition.path |
| 268 | type = string |
David 'Digit' Turner | 40841b2 | 2011-03-01 14:04:00 +0100 | [diff] [blame] | 269 | default = |
| 270 | abstract = Path to runtime system partition image |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 271 | |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 272 | name = disk.systemPartition.initPath |
| 273 | type = string |
| 274 | default = |
| 275 | abstract = Initial system partition image |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 276 | |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 277 | name = disk.systemPartition.size |
| 278 | type = diskSize |
| 279 | default = 0 |
| 280 | abstract = Ideal size of system partition |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 281 | |
| 282 | # Path to the data partition. |
| 283 | name = disk.dataPartition.path |
| 284 | type = string |
| 285 | default = <temp> |
| 286 | abstract = Path to data partition file |
| 287 | description = Path to data partition file. Cannot be empty. Special value <temp> means using a temporary file. If disk.dataPartition.initPath is not empty, its content will be copied to the disk.dataPartition.path file at boot-time. |
| 288 | |
| 289 | # Initial path to the data partition. |
| 290 | name = disk.dataPartition.initPath |
| 291 | type = string |
| 292 | default = |
| 293 | abstract = Initial data partition |
| 294 | description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time. |
| 295 | |
| 296 | # Data partition size. |
| 297 | name = disk.dataPartition.size |
| 298 | type = diskSize |
| 299 | default = 0 |
| 300 | abstract = Ideal size of data partition |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 301 | |
David 'Digit' Turner | 5f64b87 | 2011-02-28 23:23:05 +0100 | [diff] [blame] | 302 | # Path to the snapshots storage file. |
| 303 | name = disk.snapStorage.path |
Vladimir Chtchetkine | 83ffd66 | 2011-02-11 12:40:59 -0800 | [diff] [blame] | 304 | type = string |
| 305 | default = |
David 'Digit' Turner | 5f64b87 | 2011-02-28 23:23:05 +0100 | [diff] [blame] | 306 | abstract = Path to snapshot storage |
| 307 | description = Path to a 'snapshot storage' file, where all snapshots are stored. |
David 'Digit' Turner | 53eb66d | 2011-03-01 14:58:23 +0100 | [diff] [blame] | 308 | |
| 309 | # Android AVD name |
| 310 | # This is set automatically before launching a core. |
| 311 | # |
| 312 | name = avd.name |
| 313 | type = string |
| 314 | default = <build> |
| 315 | abstract = Name of the AVD being run |