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 # Audio input
    155 name        = hw.audioInput
    156 type        = boolean
    157 default     = yes
    158 abstract    = Audio recording support
    159 description = Whether the device can record audio
    160 
    161 # Audio output
    162 name        = hw.audioOutput
    163 type        = boolean
    164 default     = yes
    165 abstract    = Audio playback support
    166 description = Whether the device can play audio
    167 
    168 # SDCard support
    169 name        = hw.sdCard
    170 type        = boolean
    171 default     = yes
    172 abstract    = SD Card support
    173 description = Whether the device supports insertion/removal of virtual SD Cards.
    174 
    175 name        = hw.sdCard.path
    176 type        = string
    177 default     =
    178 abstract    = SD Card image path
    179 
    180 # Cache partition
    181 name        = disk.cachePartition
    182 type        = boolean
    183 default     = yes
    184 abstract    = Cache partition support
    185 description = Whether we use a /cache partition on the device.
    186 
    187 name        = disk.cachePartition.path
    188 type        = string
    189 default     =
    190 abstract    = Cache partition
    191 description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'.
    192 
    193 name        = disk.cachePartition.size
    194 type        = diskSize
    195 abstract    = Cache partition size
    196 default     = 66MB
    197 
    198 # LCD width
    199 name        = hw.lcd.width
    200 type        = integer
    201 default     = 320
    202 abstract    = LCD pixel width
    203 
    204 name        = hw.lcd.height
    205 type        = integer
    206 default     = 640
    207 abstract    = LCD pixel height
    208 
    209 name        = hw.lcd.depth
    210 type        = integer
    211 enum        = 16, 32
    212 default     = 16
    213 abstract    = LCD color depth
    214 description = Color bit depth of emulated framebuffer.
    215 
    216 # LCD density
    217 name        = hw.lcd.density
    218 type        = integer
    219 enum        = 120, 160, 240, 213, 320
    220 default     = 160
    221 abstract    = Abstracted LCD density
    222 description = A value used to roughly describe the density of the LCD screen for automatic resource/asset selection.
    223 
    224 # LCD backlight - Enable/Disable LCD backlight simulation
    225 # default = no  : Disabled
    226 # default = yes : Enabled
    227 name        = hw.lcd.backlight
    228 type        = boolean
    229 default     = yes
    230 abstract    = LCD backlight
    231 description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled.
    232 
    233 # Hardware OpenGLES emulation support
    234 #
    235 name        = hw.gpu.enabled
    236 type        = boolean
    237 default     = no
    238 abstract    = GPU emulation
    239 description = Enable/Disable emulated OpenGLES GPU
    240 
    241 name        = hw.gpu.mode
    242 type        = string
    243 default     = auto
    244 enum        = auto, host, mesa
    245 abstract    = GPU emulation mode
    246 description = This value determines how GPU emulation is implemented.
    247 
    248 name        = hw.gpu.blacklisted
    249 type        = string
    250 default     = no
    251 enum        = no, yes
    252 abstract    = GPU on-blacklist mode
    253 description = This value determines if the GPU is considered blacklisted. Testing purposes only.
    254 
    255 # Configures the initial orientation: portrait or landscape
    256 #
    257 name        = hw.initialOrientation
    258 type        = string
    259 enum        = portrait, landscape
    260 default     = portrait
    261 abstract    = Initial screen orientation
    262 description = Setup initial screen orientation, can be rotated later on.
    263 
    264 # Configures camera facing back
    265 #
    266 name        = hw.camera.back
    267 type        = string
    268 enum        = emulated, none, webcam0, ...
    269 default     = emulated
    270 abstract    = Configures camera facing back
    271 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if back camera is disabled.
    272 
    273 # Configures camera facing front
    274 #
    275 name        = hw.camera.front
    276 type        = string
    277 enum        = emulated, none, webcam0, ...
    278 default     = none
    279 abstract    = Configures camera facing front
    280 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if front camera is disabled.
    281 
    282 # Maximum VM heap size
    283 # Higher values are required for high-dpi devices
    284 # Default will depend on RAM size.
    285 name        = vm.heapSize
    286 type        = integer
    287 default     = 0
    288 abstract    = Max VM application heap size
    289 description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes.
    290 
    291 # Light sensor
    292 name        = hw.sensors.light
    293 type        = boolean
    294 default     = yes
    295 abstract    = Light support
    296 description = Whether there is a light sensor in the device
    297 
    298 # Pressure sensor
    299 name        = hw.sensors.pressure
    300 type        = boolean
    301 default     = yes
    302 abstract    = Pressure support
    303 description = Whether there is a pressure sensor in the device
    304 
    305 # Humidity sensor
    306 name        = hw.sensors.humidity
    307 type        = boolean
    308 default     = yes
    309 abstract    = Humidity support
    310 description = Whether there is a relative humidity sensor in the device
    311 
    312 # Proximity sensor
    313 name        = hw.sensors.proximity
    314 type        = boolean
    315 default     = yes
    316 abstract    = Proximity support
    317 description = Whether there is an proximity in the device.
    318 
    319 # Magnetic field sensor
    320 name        = hw.sensors.magnetic_field
    321 type        = boolean
    322 default     = yes
    323 abstract    = Magnetic field support
    324 description = Provides magnetic field sensor values.
    325 
    326 # Orientation sensor
    327 name        = hw.sensors.orientation
    328 type        = boolean
    329 default     = yes
    330 abstract    = Orientation support
    331 description = Provides orientation sensor values.
    332 
    333 # Temperature sensor
    334 name        = hw.sensors.temperature
    335 type        = boolean
    336 default     = yes
    337 abstract    = Temperature support
    338 description = Provides temperature sensor values.
    339 
    340 # File system
    341 name        = hw.useext4
    342 type        = boolean
    343 default     = yes
    344 abstract    = Deprecated option. Ignored.
    345 description = Used to specify the Ext4 partition image type. This is now autodetected.
    346 
    347 # Kernel image.
    348 #
    349 # kernel.path        specified the path to the kernel image
    350 # kernel.parameters  specifies the string of kernel boot parameters.
    351 #
    352 name        = kernel.path
    353 type        = string
    354 default     =
    355 abstract    = Path to the kernel image
    356 description = Path to the kernel image.
    357 
    358 name        = kernel.parameters
    359 type        = string
    360 default     =
    361 abstract    = kernel boot parameters string.
    362 
    363 name        = kernel.newDeviceNaming
    364 type        = string
    365 enum        = autodetect, yes, no
    366 default     = autodetect
    367 abstract    = Does the kernel require a new device naming scheme?
    368 description = Used to specify whether the kernel requires a new device naming scheme. Typically for Linux 3.10 and above.
    369 
    370 name        = kernel.supportsYaffs2
    371 type        = string
    372 enum        = autodetect, yes, no
    373 default     = autodetect
    374 abstract    = Does the kernel supports YAFFS2 partitions?
    375 description = Used to specify whether the kernel supports YAFFS2 partition images. Typically before 3.10 only.
    376 
    377 # Path to the ramdisk image.
    378 name        = disk.ramdisk.path
    379 type        = string
    380 default     =
    381 abstract    = Path to the ramdisk image
    382 description = Path to the ramdisk image.
    383 
    384 # System partition image(s).
    385 #
    386 # disk.systemPartition.path points to the read/write system partition image.
    387 #   if empty, a temporary file will be created, initialized with the content
    388 #   of .initPath
    389 #
    390 # disk.systemPartition.initPath is only used when .path is empty. It must
    391 # then point to a read-only initialization system image file.
    392 #
    393 # disk.systemPartition.size is the ideal size of the system partition. The
    394 # size is ignored if the actual system partition image is larger. Otherwise,
    395 # it indicates the maximum size the disk image file can grow to.
    396 #
    397 name        = disk.systemPartition.path
    398 type        = string
    399 default     =
    400 abstract    = Path to runtime system partition image
    401 
    402 name        = disk.systemPartition.initPath
    403 type        = string
    404 default     =
    405 abstract    = Initial system partition image
    406 
    407 name        = disk.systemPartition.size
    408 type        = diskSize
    409 default     = 0
    410 abstract    = Ideal size of system partition
    411 
    412 # Path to the data partition.
    413 name        = disk.dataPartition.path
    414 type        = string
    415 default     = <temp>
    416 abstract    = Path to data partition file
    417 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.
    418 
    419 # Initial path to the data partition.
    420 name        = disk.dataPartition.initPath
    421 type        = string
    422 default     =
    423 abstract    = Initial data partition
    424 description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time.
    425 
    426 # Data partition size.
    427 name        = disk.dataPartition.size
    428 type        = diskSize
    429 default     = 0
    430 abstract    = Ideal size of data partition
    431 
    432 # Path to the data partition.
    433 name        = disk.encryptionKeyPartition.path
    434 type        = string
    435 default     =
    436 abstract    = Path to encryption key partition file
    437 description = Path to encryption key partition file. Should be at least 16K bytes empty disk without any filesystem on it.
    438 
    439 # Path to the snapshots storage file.
    440 name        = disk.snapStorage.path
    441 type        = string
    442 default     =
    443 abstract    = Path to snapshot storage
    444 description = Path to a 'snapshot storage' file, where all snapshots are stored.
    445 
    446 # Android AVD name
    447 # This is set automatically before launching a core.
    448 #
    449 name        = avd.name
    450 type        = string
    451 default     = <build>
    452 abstract    = Name of the AVD being run
    453