Home | History | Annotate | Download | only in avd
      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 # 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 # Ram size
     41 # Default value will be computed based on screen pixels
     42 # or skin version
     43 name        = hw.ramSize
     44 type        = integer
     45 default     = 0
     46 abstract    = Device ram size
     47 description = The amount of physical RAM on the device, in megabytes.
     48 
     49 # Touch screen support
     50 name        = hw.touchScreen
     51 type        = boolean
     52 default     = yes
     53 abstract    = Touch-screen support
     54 description = Whether there is a touch screen or not on the device.
     55 
     56 # Hardware main keys (back/home)
     57 name        = hw.mainKeys
     58 type        = boolean
     59 default     = yes
     60 abstract    = Hardware Back/Home keys
     61 description = Whether there are hardware back/home keys on the device.
     62 
     63 # Trackball support
     64 name        = hw.trackBall
     65 type        = boolean
     66 default     = yes
     67 abstract    = Track-ball support
     68 description = Whether there is a trackball on the device.
     69 
     70 # Keyboard support (qwerty/azerty)
     71 name        = hw.keyboard
     72 type        = boolean
     73 default     = yes
     74 abstract    = Keyboard support
     75 description = Whether the device has a QWERTY keyboard.
     76 
     77 # Keyboard lid support
     78 # (I.e. can the qwerty keyboard be closed/hidden or opened/visible)
     79 # this will be ignored if hw.keyboard is false
     80 #
     81 # NOTE: As a special case, the default value will be 'false' if the
     82 #       AVD targets API level 12 or higher. See hwConfig_init()
     83 #       in external/qemu/android/avd/hw-config.c for more details.
     84 #
     85 name        = hw.keyboard.lid
     86 type        = boolean
     87 default     = yes
     88 abstract    = Keyboard lid support
     89 description = Whether the QWERTY keyboard can be opened/closed.
     90 
     91 # The name of the hardware charmap for this device.
     92 #
     93 # NOTE: This should always be the default 'qwerty2' unless you have
     94 #        modified the system image accordingly. This name is sent to
     95 #        the kernel at boot time. Using an incorrect name will result
     96 #        in an unusable machine.
     97 name        = hw.keyboard.charmap
     98 type        = string
     99 default     = qwerty2
    100 abstract    = Keyboard charmap name
    101 description = Name of the system keyboard charmap file.
    102 
    103 # DPad keys
    104 name        = hw.dPad
    105 type        = boolean
    106 default     = yes
    107 abstract    = DPad support
    108 description = Whether the device has DPad keys
    109 
    110 # GSM Modem support
    111 name        = hw.gsmModem
    112 type        = boolean
    113 default     = yes
    114 abstract    = GSM modem support
    115 description = Whether there is a GSM modem in the device.
    116 
    117 # Camera support
    118 name        = hw.camera
    119 type        = boolean
    120 default     = no
    121 abstract    = Camera support
    122 description = Whether the device has a camera.
    123 
    124 name        = hw.camera.maxHorizontalPixels
    125 type        = integer
    126 default     = 640
    127 abstract    = Maximum horizontal camera pixels
    128 
    129 name        = hw.camera.maxVerticalPixels
    130 type        = integer
    131 default     = 480
    132 abstract    = Maximum vertical camera pixels
    133 
    134 # GPS support
    135 name        = hw.gps
    136 type        = boolean
    137 default     = yes
    138 abstract    = GPS support
    139 description = Whether there is a GPS in the device.
    140 
    141 # Battery
    142 name        = hw.battery
    143 type        = boolean
    144 default     = yes
    145 abstract    = Battery support
    146 description = Whether the device can run on a battery.
    147 
    148 # Accelerometer (used for auto-rotation)
    149 name        = hw.accelerometer
    150 type        = boolean
    151 default     = yes
    152 abstract    = Accelerometer
    153 description = Whether there is an accelerometer in the device.
    154 
    155 # Audio input
    156 name        = hw.audioInput
    157 type        = boolean
    158 default     = yes
    159 abstract    = Audio recording support
    160 description = Whether the device can record audio
    161 
    162 # Audio output
    163 name        = hw.audioOutput
    164 type        = boolean
    165 default     = yes
    166 abstract    = Audio playback support
    167 description = Whether the device can play audio
    168 
    169 # SDCard support
    170 name        = hw.sdCard
    171 type        = boolean
    172 default     = yes
    173 abstract    = SD Card support
    174 description = Whether the device supports insertion/removal of virtual SD Cards.
    175 
    176 name        = hw.sdCard.path
    177 type        = string
    178 default     =
    179 abstract    = SD Card image path
    180 
    181 # Cache partition
    182 name        = disk.cachePartition
    183 type        = boolean
    184 default     = yes
    185 abstract    = Cache partition support
    186 description = Whether we use a /cache partition on the device.
    187 
    188 name        = disk.cachePartition.path
    189 type        = string
    190 default     =
    191 abstract    = Cache partition
    192 description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'.
    193 
    194 name        = disk.cachePartition.size
    195 type        = diskSize
    196 abstract    = Cache partition size
    197 default     = 66MB
    198 
    199 # LCD width
    200 name        = hw.lcd.width
    201 type        = integer
    202 default     = 320
    203 abstract    = LCD pixel width
    204 
    205 name        = hw.lcd.height
    206 type        = integer
    207 default     = 640
    208 abstract    = LCD pixel height
    209 
    210 name        = hw.lcd.depth
    211 type        = integer
    212 default     = 16
    213 abstract    = LCD color depth
    214 description = Must be 16 or 32. Color bit depth of emulated framebuffer.
    215 
    216 # LCD density
    217 name        = hw.lcd.density
    218 type        = integer
    219 default     = 160
    220 abstract    = Abstracted LCD density
    221 description = Must be one of 120 / 160 / 240 / 213/ 320. A value used to roughly describe the density of the LCD screen for automatic resource/asset selection.
    222 
    223 # LCD backlight - Enable/Disable LCD backlight simulation
    224 # default = no  : Disabled
    225 # default = yes : Enabled
    226 name        = hw.lcd.backlight
    227 type        = boolean
    228 default     = yes
    229 abstract    = LCD backlight
    230 description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled.
    231 
    232 # Hardware OpenGLES emulation support
    233 #
    234 name        = hw.gpu.enabled
    235 type        = boolean
    236 default     = no
    237 abstract    = GPU emulation
    238 description = Enable/Disable emulated OpenGLES GPU
    239 
    240 # Fake camera support
    241 #
    242 name        = hw.fakeCamera
    243 type        = string
    244 default     = back
    245 abstract    = Fake camera control
    246 description = Must be 'back', if fake camera is facing back, 'front', if fake camera is facing front, or 'off' if fake camera is disabled.
    247 
    248 # Number of emulated web cameras
    249 #
    250 name        = hw.webcam.count
    251 type        = integer
    252 default     = 6
    253 abstract    = Number of emulated web cameras
    254 description = Defines number of web cameras to emulate. 0 disables webcam emulation.
    255 
    256 # Defines name of the emulated webcam with index 0
    257 #
    258 name        = hw.webcam.0.name
    259 type        = string
    260 default     = webcam0
    261 abstract    = Name of the 1-st emulated web camera
    262 description = Emulator-generated platform-independent name identifying a camera in the list of enumerated web cameras.
    263 
    264 # Defines name of the emulated webcam with index 1
    265 #
    266 name        = hw.webcam.1.name
    267 type        = string
    268 default     = webcam1
    269 abstract    = Name of the 2-nd emulated web camera
    270 description = Emulator-generated platform-independent camera name.
    271 
    272 # Defines name of the emulated webcam with index 2
    273 #
    274 name        = hw.webcam.2.name
    275 type        = string
    276 default     = webcam2
    277 abstract    = Name of the 3-rd emulated web camera
    278 description = Emulator-generated platform-independent camera name.
    279 
    280 # Defines name of the emulated webcam with index 3
    281 #
    282 name        = hw.webcam.3.name
    283 type        = string
    284 default     = webcam3
    285 abstract    = Name of the 4-th emulated web camera
    286 description = Emulator-generated platform-independent camera name.
    287 
    288 # Defines name of the emulated webcam with index 4
    289 #
    290 name        = hw.webcam.4.name
    291 type        = string
    292 default     = webcam4
    293 abstract    = Name of the 5-th emulated web camera
    294 description = Emulator-generated platform-independent camera name.
    295 
    296 # Defines name of the emulated webcam with index 5
    297 #
    298 name        = hw.webcam.5.name
    299 type        = string
    300 default     = webcam5
    301 abstract    = Name of the 6-th emulated web camera
    302 description = Emulator-generated platform-independent camera name.
    303 
    304 # Defines direction of the emulated webcam with index 0
    305 #
    306 name        = hw.webcam.0.direction
    307 type        = string
    308 default     = front
    309 abstract    = 1-st emulated web camera direction
    310 description = Direction of the 1-st emulated web camera
    311 
    312 # Defines direction of the emulated webcam with index 1
    313 # Note that first two cameras must face in opposite directions in order to enable
    314 # camera switch in the camera application.
    315 #
    316 name        = hw.webcam.1.direction
    317 type        = string
    318 default     = back
    319 abstract    = 2-nd emulated web camera direction
    320 description = Direction of the 2-nd emulated web camera
    321 
    322 # Defines direction of the emulated webcam with index 2
    323 #
    324 name        = hw.webcam.2.direction
    325 type        = string
    326 default     = front
    327 abstract    = 3-rd emulated web camera direction
    328 description = Direction of the 3-rd emulated web camera
    329 
    330 # Defines direction of the emulated webcam with index 3
    331 #
    332 name        = hw.webcam.3.direction
    333 type        = string
    334 default     = front
    335 abstract    = 4-th emulated web camera direction
    336 description = Direction of the 4-th emulated web camera
    337 
    338 # Defines direction of the emulated webcam with index 4
    339 #
    340 name        = hw.webcam.4.direction
    341 type        = string
    342 default     = front
    343 abstract    = 5-th emulated web camera direction
    344 description = Direction of the 5-th emulated web camera
    345 
    346 # Defines direction of the emulated webcam with index 5
    347 #
    348 name        = hw.webcam.5.direction
    349 type        = string
    350 default     = front
    351 abstract    = 6-th emulated web camera direction
    352 description = Direction of the 6-th emulated web camera
    353 
    354 # Maximum VM heap size
    355 # Higher values are required for high-dpi devices
    356 # Default will depend on RAM size.
    357 name        = vm.heapSize
    358 type        = integer
    359 default     = 0
    360 abstract    = Max VM application heap size
    361 description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes.
    362 
    363 # Proximity sensor
    364 name        = hw.sensors.proximity
    365 type        = boolean
    366 default     = yes
    367 abstract    = Proximity support
    368 description = Whether there is an proximity in the device.
    369 
    370 # Kernel image.
    371 #
    372 # kernel.path        specified the path to the kernel image
    373 # kernel.parameters  specifies the string of kernel boot parameters.
    374 #
    375 name        = kernel.path
    376 type        = string
    377 default     =
    378 abstract    = Path to the kernel image
    379 description = Path to the kernel image.
    380 
    381 name        = kernel.parameters
    382 type        = string
    383 default     =
    384 abstract    = kernel boot parameters string.
    385 
    386 # Path to the ramdisk image.
    387 name        = disk.ramdisk.path
    388 type        = string
    389 default     =
    390 abstract    = Path to the ramdisk image
    391 description = Path to the ramdisk image.
    392 
    393 # System partition image(s).
    394 #
    395 # disk.systemPartition.path points to the read/write system partition image.
    396 #   if empty, a temporary file will be created, initialized with the content
    397 #   of .initPath
    398 #
    399 # disk.systemPartition.initPath is only used when .path is empty. It must
    400 # then point to a read-only initialization system image file.
    401 #
    402 # disk.systemPartition.size is the ideal size of the system partition. The
    403 # size is ignored if the actual system partition image is larger. Otherwise,
    404 # it indicates the maximum size the disk image file can grow to.
    405 #
    406 name        = disk.systemPartition.path
    407 type        = string
    408 default     =
    409 abstract    = Path to runtime system partition image
    410 
    411 name        = disk.systemPartition.initPath
    412 type        = string
    413 default     =
    414 abstract    = Initial system partition image
    415 
    416 name        = disk.systemPartition.size
    417 type        = diskSize
    418 default     = 0
    419 abstract    = Ideal size of system partition
    420 
    421 # Path to the data partition.
    422 name        = disk.dataPartition.path
    423 type        = string
    424 default     = <temp>
    425 abstract    = Path to data partition file
    426 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.
    427 
    428 # Initial path to the data partition.
    429 name        = disk.dataPartition.initPath
    430 type        = string
    431 default     =
    432 abstract    = Initial data partition
    433 description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time.
    434 
    435 # Data partition size.
    436 name        = disk.dataPartition.size
    437 type        = diskSize
    438 default     = 0
    439 abstract    = Ideal size of data partition
    440 
    441 # Path to the snapshots storage file.
    442 name        = disk.snapStorage.path
    443 type        = string
    444 default     =
    445 abstract    = Path to snapshot storage
    446 description = Path to a 'snapshot storage' file, where all snapshots are stored.
    447 
    448 # Android AVD name
    449 # This is set automatically before launching a core.
    450 #
    451 name        = avd.name
    452 type        = string
    453 default     = <build>
    454 abstract    = Name of the AVD being run
    455