Home | History | Annotate | Download | only in lib
      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/scripts/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 # It is also packaged by the SDK and parsed by tools to let the developers
     18 # create AVDs.
     19 #
     20 # NOTE: if you remove items from this file, be sure that you do not break
     21 #       the emulator build.
     22 #
     23 
     24 # CPU Architecture
     25 name        = hw.cpu.arch
     26 type        = string
     27 default     = arm
     28 abstract    = CPU Architecture
     29 description = The CPU Architecture to emulator
     30 
     31 # CPU Model
     32 # Leave it empty, and the default value will be computed from
     33 # hw.cpu.arch. This is only useful for experimentation for now.
     34 name        = hw.cpu.model
     35 type        = string
     36 default     =
     37 abstract    = CPU model
     38 description = The CPU model (QEMU-specific string)
     39 
     40 # SMP count: Number of processors to emulate when SMP is supported.
     41 # Must be > 0.
     42 name        = hw.cpu.ncore
     43 type        = integer
     44 default     = 2
     45 abstract    = SMP CPU core count
     46 description = Number of cores in a simulated SMP CPU.
     47 
     48 # Ram size
     49 # Default value will be computed based on screen pixels
     50 # or skin version
     51 name        = hw.ramSize
     52 type        = integer
     53 default     = 0
     54 abstract    = Device ram size
     55 description = The amount of physical RAM on the device, in megabytes.
     56 
     57 # Touch screen type
     58 name        = hw.screen
     59 type        = string
     60 enum        = touch, multi-touch, no-touch
     61 default     = multi-touch
     62 abstract    = Touch screen type
     63 description = Defines type of the screen.
     64 
     65 # Hardware main keys (back/home)
     66 name        = hw.mainKeys
     67 type        = boolean
     68 default     = yes
     69 abstract    = Hardware Back/Home keys
     70 description = Whether there are hardware back/home keys on the device.
     71 
     72 # Trackball support
     73 name        = hw.trackBall
     74 type        = boolean
     75 default     = yes
     76 abstract    = Track-ball support
     77 description = Whether there is a trackball on the device.
     78 
     79 # Keyboard support (qwerty/azerty)
     80 name        = hw.keyboard
     81 type        = boolean
     82 default     = no
     83 abstract    = Keyboard support
     84 description = Whether the device has a QWERTY keyboard.
     85 
     86 # Keyboard lid support
     87 # (I.e. can the qwerty keyboard be closed/hidden or opened/visible)
     88 # this will be ignored if hw.keyboard is false
     89 #
     90 # NOTE: As a special case, the default value will be 'false' if the
     91 #       AVD targets API level 12 or higher. See hwConfig_init()
     92 #       in external/qemu/android/avd/hw-config.c for more details.
     93 #
     94 name        = hw.keyboard.lid
     95 type        = boolean
     96 default     = yes
     97 abstract    = Keyboard lid support
     98 description = Whether the QWERTY keyboard can be opened/closed.
     99 
    100 # The name of the hardware charmap for this device.
    101 #
    102 # NOTE: This should always be the default 'qwerty2' unless you have
    103 #        modified the system image accordingly. This name is sent to
    104 #        the kernel at boot time. Using an incorrect name will result
    105 #        in an unusable machine.
    106 name        = hw.keyboard.charmap
    107 type        = string
    108 default     = qwerty2
    109 abstract    = Keyboard charmap name
    110 description = Name of the system keyboard charmap file.
    111 
    112 # DPad keys
    113 name        = hw.dPad
    114 type        = boolean
    115 default     = yes
    116 abstract    = DPad support
    117 description = Whether the device has DPad keys
    118 
    119 # Rotary input
    120 name        = hw.rotaryInput
    121 type        = boolean
    122 default     = no
    123 abstract    = Rotary input support
    124 description = Whether the device has rotary input
    125 
    126 # GSM Modem support
    127 name        = hw.gsmModem
    128 type        = boolean
    129 default     = yes
    130 abstract    = GSM modem support
    131 description = Whether there is a GSM modem in the device.
    132 
    133 # GPS support
    134 name        = hw.gps
    135 type        = boolean
    136 default     = yes
    137 abstract    = GPS support
    138 description = Whether there is a GPS in the device.
    139 
    140 # Battery
    141 name        = hw.battery
    142 type        = boolean
    143 default     = yes
    144 abstract    = Battery support
    145 description = Whether the device can run on a battery.
    146 
    147 # Accelerometer (used for auto-rotation)
    148 name        = hw.accelerometer
    149 type        = boolean
    150 default     = yes
    151 abstract    = Accelerometer
    152 description = Whether there is an accelerometer in the device.
    153 
    154 # Gyroscope (used for VR)
    155 name        = hw.gyroscope
    156 type        = boolean
    157 default     = yes
    158 abstract    = Gyroscope
    159 description = Whether there is a gyroscope in the device.
    160 
    161 # Audio input
    162 name        = hw.audioInput
    163 type        = boolean
    164 default     = yes
    165 abstract    = Audio recording support
    166 description = Whether the device can record audio
    167 
    168 # Audio output
    169 name        = hw.audioOutput
    170 type        = boolean
    171 default     = yes
    172 abstract    = Audio playback support
    173 description = Whether the device can play audio
    174 
    175 # SDCard support
    176 name        = hw.sdCard
    177 type        = boolean
    178 default     = yes
    179 abstract    = SD Card support
    180 description = Whether the device supports insertion/removal of virtual SD Cards.
    181 
    182 name        = hw.sdCard.path
    183 type        = string
    184 default     =
    185 abstract    = SD Card image path
    186 
    187 name        = hw.logcatOutput.path
    188 type        = string
    189 default     =
    190 abstract    = Logcat Output File Path
    191 
    192 # Cache partition
    193 name        = disk.cachePartition
    194 type        = boolean
    195 default     = yes
    196 abstract    = Cache partition support
    197 description = Whether we use a /cache partition on the device.
    198 
    199 name        = disk.cachePartition.path
    200 type        = string
    201 default     =
    202 abstract    = Cache partition
    203 description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'.
    204 
    205 name        = disk.cachePartition.size
    206 type        = diskSize
    207 abstract    = Cache partition size
    208 default     = 66MB
    209 
    210 # LCD width
    211 name        = hw.lcd.width
    212 type        = integer
    213 default     = 320
    214 abstract    = LCD pixel width
    215 
    216 name        = hw.lcd.height
    217 type        = integer
    218 default     = 640
    219 abstract    = LCD pixel height
    220 
    221 name        = hw.lcd.depth
    222 type        = integer
    223 enum        = 16, 32
    224 default     = 16
    225 abstract    = LCD color depth
    226 description = Color bit depth of emulated framebuffer.
    227 
    228 # LCD density
    229 name        = hw.lcd.density
    230 type        = integer
    231 enum        = 120, 160, 240, 213, 320
    232 default     = 160
    233 abstract    = Abstracted LCD density
    234 description = A value used to roughly describe the density of the LCD screen for automatic resource/asset selection.
    235 
    236 # LCD backlight - Enable/Disable LCD backlight simulation
    237 # default = no  : Disabled
    238 # default = yes : Enabled
    239 name        = hw.lcd.backlight
    240 type        = boolean
    241 default     = yes
    242 abstract    = LCD backlight
    243 description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled.
    244 
    245 # Hardware OpenGLES emulation support
    246 #
    247 name        = hw.gpu.enabled
    248 type        = boolean
    249 default     = no
    250 abstract    = GPU emulation
    251 description = Enable/Disable emulated OpenGLES GPU
    252 
    253 name        = hw.gpu.mode
    254 type        = string
    255 default     = auto
    256 enum        = auto, host, mesa
    257 abstract    = GPU emulation mode
    258 description = This value determines how GPU emulation is implemented.
    259 
    260 name        = hw.gpu.blacklisted
    261 type        = string
    262 default     = no
    263 enum        = no, yes
    264 abstract    = GPU on-blacklist mode
    265 description = This value determines if the GPU is considered blacklisted. Testing purposes only.
    266 
    267 # Configures the initial orientation: portrait or landscape
    268 #
    269 name        = hw.initialOrientation
    270 type        = string
    271 enum        = portrait, landscape
    272 default     = portrait
    273 abstract    = Initial screen orientation
    274 description = Setup initial screen orientation, can be rotated later on.
    275 
    276 # Configures camera facing back
    277 #
    278 name        = hw.camera.back
    279 type        = string
    280 enum        = emulated, none, webcam0, ...
    281 default     = emulated
    282 abstract    = Configures camera facing back
    283 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if back camera is disabled.
    284 
    285 # Configures camera facing front
    286 #
    287 name        = hw.camera.front
    288 type        = string
    289 enum        = emulated, none, webcam0, ...
    290 default     = none
    291 abstract    = Configures camera facing front
    292 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if front camera is disabled.
    293 
    294 # Maximum VM heap size
    295 # Higher values are required for high-dpi devices
    296 # Default will depend on RAM size.
    297 name        = vm.heapSize
    298 type        = integer
    299 default     = 0
    300 abstract    = Max VM application heap size
    301 description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes.
    302 
    303 # Light sensor
    304 name        = hw.sensors.light
    305 type        = boolean
    306 default     = yes
    307 abstract    = Light support
    308 description = Whether there is a light sensor in the device
    309 
    310 # Pressure sensor
    311 name        = hw.sensors.pressure
    312 type        = boolean
    313 default     = yes
    314 abstract    = Pressure support
    315 description = Whether there is a pressure sensor in the device
    316 
    317 # Humidity sensor
    318 name        = hw.sensors.humidity
    319 type        = boolean
    320 default     = yes
    321 abstract    = Humidity support
    322 description = Whether there is a relative humidity sensor in the device
    323 
    324 # Proximity sensor
    325 name        = hw.sensors.proximity
    326 type        = boolean
    327 default     = yes
    328 abstract    = Proximity support
    329 description = Whether there is an proximity in the device.
    330 
    331 # Magnetic field sensor
    332 name        = hw.sensors.magnetic_field
    333 type        = boolean
    334 default     = yes
    335 abstract    = Magnetic field support
    336 description = Provides magnetic field sensor values.
    337 
    338 # Uncalibrated magnetometer (used for VR)
    339 name        = hw.sensors.magnetic_field_uncalibrated
    340 type        = boolean
    341 default     = yes
    342 abstract    = Uncalibrated magnetic field suport
    343 description = Provides uncalibrated magnetic field sensor values.
    344 
    345 # Uncalibrated gyroscope
    346 name        = hw.sensors.gyroscope_uncalibrated
    347 type        = boolean
    348 default     = yes
    349 abstract    = Uncalibrated gyroscope support
    350 description = Provides uncalibrated gyroscope sensor values.
    351 
    352 # Orientation sensor
    353 name        = hw.sensors.orientation
    354 type        = boolean
    355 default     = yes
    356 abstract    = Orientation support
    357 description = Provides orientation sensor values.
    358 
    359 # Temperature sensor
    360 name        = hw.sensors.temperature
    361 type        = boolean
    362 default     = yes
    363 abstract    = Temperature support
    364 description = Provides temperature sensor values.
    365 
    366 # File system
    367 name        = hw.useext4
    368 type        = boolean
    369 default     = yes
    370 abstract    = Deprecated option. Ignored.
    371 description = Used to specify the Ext4 partition image type. This is now autodetected.
    372 
    373 # ARC++ devices
    374 name        = hw.arc
    375 type        = boolean
    376 default     = no
    377 abstract    = ARC++ device
    378 description = The emulated device is an ARC++ machine.
    379 
    380 # Kernel image.
    381 #
    382 # kernel.path        specified the path to the kernel image
    383 # kernel.parameters  specifies the string of kernel boot parameters.
    384 #
    385 name        = kernel.path
    386 type        = string
    387 default     =
    388 abstract    = Path to the kernel image
    389 description = Path to the kernel image.
    390 
    391 name        = kernel.parameters
    392 type        = string
    393 default     =
    394 abstract    = kernel boot parameters string.
    395 
    396 name        = kernel.newDeviceNaming
    397 type        = string
    398 enum        = autodetect, yes, no
    399 default     = autodetect
    400 abstract    = Does the kernel require a new device naming scheme?
    401 description = Used to specify whether the kernel requires a new device naming scheme. Typically for Linux 3.10 and above.
    402 
    403 name        = kernel.supportsYaffs2
    404 type        = string
    405 enum        = autodetect, yes, no
    406 default     = autodetect
    407 abstract    = Does the kernel supports YAFFS2 partitions?
    408 description = Used to specify whether the kernel supports YAFFS2 partition images. Typically before 3.10 only.
    409 
    410 # Path to the ramdisk image.
    411 name        = disk.ramdisk.path
    412 type        = string
    413 default     =
    414 abstract    = Path to the ramdisk image
    415 description = Path to the ramdisk image.
    416 
    417 # System partition image(s).
    418 #
    419 # disk.systemPartition.path points to the read/write system partition image.
    420 #   if empty, a temporary file will be created, initialized with the content
    421 #   of .initPath
    422 #
    423 # disk.systemPartition.initPath is only used when .path is empty. It must
    424 # then point to a read-only initialization system image file.
    425 #
    426 # disk.systemPartition.size is the ideal size of the system partition. The
    427 # size is ignored if the actual system partition image is larger. Otherwise,
    428 # it indicates the maximum size the disk image file can grow to.
    429 #
    430 name        = disk.systemPartition.path
    431 type        = string
    432 default     =
    433 abstract    = Path to runtime system partition image
    434 
    435 name        = disk.systemPartition.initPath
    436 type        = string
    437 default     =
    438 abstract    = Initial system partition image
    439 
    440 name        = disk.systemPartition.size
    441 type        = diskSize
    442 default     = 0
    443 abstract    = Ideal size of system partition
    444 
    445 # Vendor partition image(s).
    446 
    447 name        = disk.vendorPartition.path
    448 type        = string
    449 default     =
    450 abstract    = Path to runtime vendor partition image
    451 
    452 name        = disk.vendorPartition.initPath
    453 type        = string
    454 default     =
    455 abstract    = Initial vendor partition image
    456 
    457 name        = disk.vendorPartition.size
    458 type        = diskSize
    459 default     = 0
    460 abstract    = Ideal size of vendor partition
    461 
    462 # Path to the data partition.
    463 name        = disk.dataPartition.path
    464 type        = string
    465 default     = <temp>
    466 abstract    = Path to data partition file
    467 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.
    468 
    469 # Initial path to the data partition.
    470 name        = disk.dataPartition.initPath
    471 type        = string
    472 default     =
    473 abstract    = Initial data partition
    474 description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time.
    475 
    476 # Data partition size.
    477 name        = disk.dataPartition.size
    478 type        = diskSize
    479 default     = 0
    480 abstract    = Ideal size of data partition
    481 
    482 # Path to the data partition.
    483 name        = disk.encryptionKeyPartition.path
    484 type        = string
    485 default     =
    486 abstract    = Path to encryption key partition file
    487 description = Path to encryption key partition file. Should be at least 16K bytes empty disk without any filesystem on it.
    488 
    489 # Path to the snapshots storage file.
    490 name        = disk.snapStorage.path
    491 type        = string
    492 default     =
    493 abstract    = Path to snapshot storage
    494 description = Path to a 'snapshot storage' file, where all snapshots are stored.
    495 
    496 # Is the AVD compatible with Google Play?
    497 name        = PlayStore.enabled
    498 type        = boolean
    499 default     = no
    500 abstract    = PlayStore
    501 description = Does the device supports Google Play?
    502 
    503 # Android AVD name
    504 # This is set automatically before launching a core.
    505 #
    506 name        = avd.name
    507 type        = string
    508 default     = <build>
    509 abstract    = Name of the AVD being run
    510