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 type
     50 name        = hw.screen
     51 type        = string
     52 enum        = touch, multi-touch, no-touch
     53 default     = touch
     54 abstract    = Touch screen type
     55 description = Defines type of the screen.
     56 
     57 # Hardware main keys (back/home)
     58 name        = hw.mainKeys
     59 type        = boolean
     60 default     = yes
     61 abstract    = Hardware Back/Home keys
     62 description = Whether there are hardware back/home keys on the device.
     63 
     64 # Trackball support
     65 name        = hw.trackBall
     66 type        = boolean
     67 default     = yes
     68 abstract    = Track-ball support
     69 description = Whether there is a trackball on the device.
     70 
     71 # Keyboard support (qwerty/azerty)
     72 name        = hw.keyboard
     73 type        = boolean
     74 default     = no
     75 abstract    = Keyboard support
     76 description = Whether the device has a QWERTY keyboard.
     77 
     78 # Keyboard lid support
     79 # (I.e. can the qwerty keyboard be closed/hidden or opened/visible)
     80 # this will be ignored if hw.keyboard is false
     81 #
     82 # NOTE: As a special case, the default value will be 'false' if the
     83 #       AVD targets API level 12 or higher. See hwConfig_init()
     84 #       in external/qemu/android/avd/hw-config.c for more details.
     85 #
     86 name        = hw.keyboard.lid
     87 type        = boolean
     88 default     = yes
     89 abstract    = Keyboard lid support
     90 description = Whether the QWERTY keyboard can be opened/closed.
     91 
     92 # The name of the hardware charmap for this device.
     93 #
     94 # NOTE: This should always be the default 'qwerty2' unless you have
     95 #        modified the system image accordingly. This name is sent to
     96 #        the kernel at boot time. Using an incorrect name will result
     97 #        in an unusable machine.
     98 name        = hw.keyboard.charmap
     99 type        = string
    100 default     = qwerty2
    101 abstract    = Keyboard charmap name
    102 description = Name of the system keyboard charmap file.
    103 
    104 # DPad keys
    105 name        = hw.dPad
    106 type        = boolean
    107 default     = yes
    108 abstract    = DPad support
    109 description = Whether the device has DPad keys
    110 
    111 # GSM Modem support
    112 name        = hw.gsmModem
    113 type        = boolean
    114 default     = yes
    115 abstract    = GSM modem support
    116 description = Whether there is a GSM modem in the device.
    117 
    118 # GPS support
    119 name        = hw.gps
    120 type        = boolean
    121 default     = yes
    122 abstract    = GPS support
    123 description = Whether there is a GPS in the device.
    124 
    125 # Battery
    126 name        = hw.battery
    127 type        = boolean
    128 default     = yes
    129 abstract    = Battery support
    130 description = Whether the device can run on a battery.
    131 
    132 # Accelerometer (used for auto-rotation)
    133 name        = hw.accelerometer
    134 type        = boolean
    135 default     = yes
    136 abstract    = Accelerometer
    137 description = Whether there is an accelerometer in the device.
    138 
    139 # Audio input
    140 name        = hw.audioInput
    141 type        = boolean
    142 default     = yes
    143 abstract    = Audio recording support
    144 description = Whether the device can record audio
    145 
    146 # Audio output
    147 name        = hw.audioOutput
    148 type        = boolean
    149 default     = yes
    150 abstract    = Audio playback support
    151 description = Whether the device can play audio
    152 
    153 # SDCard support
    154 name        = hw.sdCard
    155 type        = boolean
    156 default     = yes
    157 abstract    = SD Card support
    158 description = Whether the device supports insertion/removal of virtual SD Cards.
    159 
    160 name        = hw.sdCard.path
    161 type        = string
    162 default     =
    163 abstract    = SD Card image path
    164 
    165 # Cache partition
    166 name        = disk.cachePartition
    167 type        = boolean
    168 default     = yes
    169 abstract    = Cache partition support
    170 description = Whether we use a /cache partition on the device.
    171 
    172 name        = disk.cachePartition.path
    173 type        = string
    174 default     =
    175 abstract    = Cache partition
    176 description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'.
    177 
    178 name        = disk.cachePartition.size
    179 type        = diskSize
    180 abstract    = Cache partition size
    181 default     = 66MB
    182 
    183 # LCD width
    184 name        = hw.lcd.width
    185 type        = integer
    186 default     = 320
    187 abstract    = LCD pixel width
    188 
    189 name        = hw.lcd.height
    190 type        = integer
    191 default     = 640
    192 abstract    = LCD pixel height
    193 
    194 name        = hw.lcd.depth
    195 type        = integer
    196 enum        = 16, 32
    197 default     = 16
    198 abstract    = LCD color depth
    199 description = Color bit depth of emulated framebuffer.
    200 
    201 # LCD density
    202 name        = hw.lcd.density
    203 type        = integer
    204 enum        = 120, 160, 240, 213, 320
    205 default     = 160
    206 abstract    = Abstracted LCD density
    207 description = A value used to roughly describe the density of the LCD screen for automatic resource/asset selection.
    208 
    209 # LCD backlight - Enable/Disable LCD backlight simulation
    210 # default = no  : Disabled
    211 # default = yes : Enabled
    212 name        = hw.lcd.backlight
    213 type        = boolean
    214 default     = yes
    215 abstract    = LCD backlight
    216 description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled.
    217 
    218 # Hardware OpenGLES emulation support
    219 #
    220 name        = hw.gpu.enabled
    221 type        = boolean
    222 default     = no
    223 abstract    = GPU emulation
    224 description = Enable/Disable emulated OpenGLES GPU
    225 
    226 # Configures camera facing back
    227 #
    228 name        = hw.camera.back
    229 type        = string
    230 enum        = emulated, none, webcam0, ...
    231 default     = emulated
    232 abstract    = Configures camera facing back
    233 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if back camera is disabled.
    234 
    235 # Configures camera facing front
    236 #
    237 name        = hw.camera.front
    238 type        = string
    239 enum        = emulated, none, webcam0, ...
    240 default     = none
    241 abstract    = Configures camera facing front
    242 description = Must be 'emulated' for a fake camera, 'webcam<N>' for a web camera, or 'none' if front camera is disabled.
    243 
    244 # Maximum VM heap size
    245 # Higher values are required for high-dpi devices
    246 # Default will depend on RAM size.
    247 name        = vm.heapSize
    248 type        = integer
    249 default     = 0
    250 abstract    = Max VM application heap size
    251 description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes.
    252 
    253 # Proximity sensor
    254 name        = hw.sensors.proximity
    255 type        = boolean
    256 default     = yes
    257 abstract    = Proximity support
    258 description = Whether there is an proximity in the device.
    259 
    260 # Magnetic field sensor
    261 name        = hw.sensors.magnetic_field
    262 type        = boolean
    263 default     = yes
    264 abstract    = Magnetic field support
    265 description = Provides magnetic field sensor values.
    266 
    267 # Orientation sensor
    268 name        = hw.sensors.orientation
    269 type        = boolean
    270 default     = yes
    271 abstract    = Orientation support
    272 description = Provides orientation sensor values.
    273 
    274 # Temperature sensor
    275 name        = hw.sensors.temperature
    276 type        = boolean
    277 default     = yes
    278 abstract    = Temperature support
    279 description = Provides temperature sensor values.
    280 
    281 # Kernel image.
    282 #
    283 # kernel.path        specified the path to the kernel image
    284 # kernel.parameters  specifies the string of kernel boot parameters.
    285 #
    286 name        = kernel.path
    287 type        = string
    288 default     =
    289 abstract    = Path to the kernel image
    290 description = Path to the kernel image.
    291 
    292 name        = kernel.parameters
    293 type        = string
    294 default     =
    295 abstract    = kernel boot parameters string.
    296 
    297 # Path to the ramdisk image.
    298 name        = disk.ramdisk.path
    299 type        = string
    300 default     =
    301 abstract    = Path to the ramdisk image
    302 description = Path to the ramdisk image.
    303 
    304 # System partition image(s).
    305 #
    306 # disk.systemPartition.path points to the read/write system partition image.
    307 #   if empty, a temporary file will be created, initialized with the content
    308 #   of .initPath
    309 #
    310 # disk.systemPartition.initPath is only used when .path is empty. It must
    311 # then point to a read-only initialization system image file.
    312 #
    313 # disk.systemPartition.size is the ideal size of the system partition. The
    314 # size is ignored if the actual system partition image is larger. Otherwise,
    315 # it indicates the maximum size the disk image file can grow to.
    316 #
    317 name        = disk.systemPartition.path
    318 type        = string
    319 default     =
    320 abstract    = Path to runtime system partition image
    321 
    322 name        = disk.systemPartition.initPath
    323 type        = string
    324 default     =
    325 abstract    = Initial system partition image
    326 
    327 name        = disk.systemPartition.size
    328 type        = diskSize
    329 default     = 0
    330 abstract    = Ideal size of system partition
    331 
    332 # Path to the data partition.
    333 name        = disk.dataPartition.path
    334 type        = string
    335 default     = <temp>
    336 abstract    = Path to data partition file
    337 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.
    338 
    339 # Initial path to the data partition.
    340 name        = disk.dataPartition.initPath
    341 type        = string
    342 default     =
    343 abstract    = Initial data partition
    344 description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time.
    345 
    346 # Data partition size.
    347 name        = disk.dataPartition.size
    348 type        = diskSize
    349 default     = 0
    350 abstract    = Ideal size of data partition
    351 
    352 # Path to the snapshots storage file.
    353 name        = disk.snapStorage.path
    354 type        = string
    355 default     =
    356 abstract    = Path to snapshot storage
    357 description = Path to a 'snapshot storage' file, where all snapshots are stored.
    358 
    359 # Android AVD name
    360 # This is set automatically before launching a core.
    361 #
    362 name        = avd.name
    363 type        = string
    364 default     = <build>
    365 abstract    = Name of the AVD being run
    366