hardware-properties.ini revision 04b20f411ba9398fc2bfac3d93f0997cd93a86f9
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
25name        = hw.cpu.arch
26type        = string
27default     = arm
28abstract    = CPU Architecture
29description = 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.
34name        = hw.cpu.model
35type        = string
36default     =
37abstract    = CPU model
38description = The CPU model (QEMU-specific string)
39
40# Ram size
41# Default value will be computed based on screen pixels
42# or skin version
43name        = hw.ramSize
44type        = integer
45default     = 0
46abstract    = Device ram size
47description = The amount of physical RAM on the device, in megabytes.
48
49# Touch screen type
50name        = hw.screen
51type        = string
52enum        = touch, multi-touch, no-touch
53default     = touch
54abstract    = Touch screen type
55description = Defines type of the screen.
56
57# Hardware main keys (back/home)
58name        = hw.mainKeys
59type        = boolean
60default     = yes
61abstract    = Hardware Back/Home keys
62description = Whether there are hardware back/home keys on the device.
63
64# Trackball support
65name        = hw.trackBall
66type        = boolean
67default     = yes
68abstract    = Track-ball support
69description = Whether there is a trackball on the device.
70
71# Keyboard support (qwerty/azerty)
72name        = hw.keyboard
73type        = boolean
74default     = no
75abstract    = Keyboard support
76description = 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#
86name        = hw.keyboard.lid
87type        = boolean
88default     = yes
89abstract    = Keyboard lid support
90description = 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.
98name        = hw.keyboard.charmap
99type        = string
100default     = qwerty2
101abstract    = Keyboard charmap name
102description = Name of the system keyboard charmap file.
103
104# DPad keys
105name        = hw.dPad
106type        = boolean
107default     = yes
108abstract    = DPad support
109description = Whether the device has DPad keys
110
111# GSM Modem support
112name        = hw.gsmModem
113type        = boolean
114default     = yes
115abstract    = GSM modem support
116description = Whether there is a GSM modem in the device.
117
118# GPS support
119name        = hw.gps
120type        = boolean
121default     = yes
122abstract    = GPS support
123description = Whether there is a GPS in the device.
124
125# Battery
126name        = hw.battery
127type        = boolean
128default     = yes
129abstract    = Battery support
130description = Whether the device can run on a battery.
131
132# Accelerometer (used for auto-rotation)
133name        = hw.accelerometer
134type        = boolean
135default     = yes
136abstract    = Accelerometer
137description = Whether there is an accelerometer in the device.
138
139# Audio input
140name        = hw.audioInput
141type        = boolean
142default     = yes
143abstract    = Audio recording support
144description = Whether the device can record audio
145
146# Audio output
147name        = hw.audioOutput
148type        = boolean
149default     = yes
150abstract    = Audio playback support
151description = Whether the device can play audio
152
153# SDCard support
154name        = hw.sdCard
155type        = boolean
156default     = yes
157abstract    = SD Card support
158description = Whether the device supports insertion/removal of virtual SD Cards.
159
160name        = hw.sdCard.path
161type        = string
162default     =
163abstract    = SD Card image path
164
165# Cache partition
166name        = disk.cachePartition
167type        = boolean
168default     = yes
169abstract    = Cache partition support
170description = Whether we use a /cache partition on the device.
171
172name        = disk.cachePartition.path
173type        = string
174default     =
175abstract    = Cache partition
176description = Cache partition to use on the device. Ignored if disk.cachePartition is not 'yes'.
177
178name        = disk.cachePartition.size
179type        = diskSize
180abstract    = Cache partition size
181default     = 66MB
182
183# LCD width
184name        = hw.lcd.width
185type        = integer
186default     = 320
187abstract    = LCD pixel width
188
189name        = hw.lcd.height
190type        = integer
191default     = 640
192abstract    = LCD pixel height
193
194name        = hw.lcd.depth
195type        = integer
196enum        = 16, 32
197default     = 16
198abstract    = LCD color depth
199description = Color bit depth of emulated framebuffer.
200
201# LCD density
202name        = hw.lcd.density
203type        = integer
204enum        = 120, 160, 240, 213, 320
205default     = 160
206abstract    = Abstracted LCD density
207description = 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
212name        = hw.lcd.backlight
213type        = boolean
214default     = yes
215abstract    = LCD backlight
216description = Enable/Disable LCD backlight simulation,yes-enabled,no-disabled.
217
218# Hardware OpenGLES emulation support
219#
220name        = hw.gpu.enabled
221type        = boolean
222default     = no
223abstract    = GPU emulation
224description = Enable/Disable emulated OpenGLES GPU
225
226# Configures camera facing back
227#
228name        = hw.camera.back
229type        = string
230enum        = emulated, none, webcam0, ...
231default     = emulated
232abstract    = Configures camera facing back
233description = 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#
237name        = hw.camera.front
238type        = string
239enum        = emulated, none, webcam0, ...
240default     = none
241abstract    = Configures camera facing front
242description = 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.
247name        = vm.heapSize
248type        = integer
249default     = 0
250abstract    = Max VM application heap size
251description = The maximum heap size a Dalvik application might allocate before being killed by the system. Value is in megabytes.
252
253# Proximity sensor
254name        = hw.sensors.proximity
255type        = boolean
256default     = yes
257abstract    = Proximity support
258description = Whether there is an proximity in the device.
259
260# Magnetic field sensor
261name        = hw.sensors.magnetic_field
262type        = boolean
263default     = yes
264abstract    = Magnetic field support
265description = Provides magnetic field sensor values.
266
267# Orientation sensor
268name        = hw.sensors.orientation
269type        = boolean
270default     = yes
271abstract    = Orientation support
272description = Provides orientation sensor values.
273
274# Temperature sensor
275name        = hw.sensors.temperature
276type        = boolean
277default     = yes
278abstract    = Temperature support
279description = Provides temperature sensor values.
280
281# File system
282name        = hw.useext4
283type        = boolean
284default     = yes
285abstract    = Use ext4 instead of yaffs2
286description = Specifies which file system to use: ext4 of yaffs2
287
288# Kernel image.
289#
290# kernel.path        specified the path to the kernel image
291# kernel.parameters  specifies the string of kernel boot parameters.
292#
293name        = kernel.path
294type        = string
295default     =
296abstract    = Path to the kernel image
297description = Path to the kernel image.
298
299name        = kernel.parameters
300type        = string
301default     =
302abstract    = kernel boot parameters string.
303
304# Path to the ramdisk image.
305name        = disk.ramdisk.path
306type        = string
307default     =
308abstract    = Path to the ramdisk image
309description = Path to the ramdisk image.
310
311# System partition image(s).
312#
313# disk.systemPartition.path points to the read/write system partition image.
314#   if empty, a temporary file will be created, initialized with the content
315#   of .initPath
316#
317# disk.systemPartition.initPath is only used when .path is empty. It must
318# then point to a read-only initialization system image file.
319#
320# disk.systemPartition.size is the ideal size of the system partition. The
321# size is ignored if the actual system partition image is larger. Otherwise,
322# it indicates the maximum size the disk image file can grow to.
323#
324name        = disk.systemPartition.path
325type        = string
326default     =
327abstract    = Path to runtime system partition image
328
329name        = disk.systemPartition.initPath
330type        = string
331default     =
332abstract    = Initial system partition image
333
334name        = disk.systemPartition.size
335type        = diskSize
336default     = 0
337abstract    = Ideal size of system partition
338
339# Path to the data partition.
340name        = disk.dataPartition.path
341type        = string
342default     = <temp>
343abstract    = Path to data partition file
344description = 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.
345
346# Initial path to the data partition.
347name        = disk.dataPartition.initPath
348type        = string
349default     =
350abstract    = Initial data partition
351description = If not empty, its content will be copied to the disk.dataPartition.path file at boot-time.
352
353# Data partition size.
354name        = disk.dataPartition.size
355type        = diskSize
356default     = 0
357abstract    = Ideal size of data partition
358
359# Path to the snapshots storage file.
360name        = disk.snapStorage.path
361type        = string
362default     =
363abstract    = Path to snapshot storage
364description = Path to a 'snapshot storage' file, where all snapshots are stored.
365
366# Android AVD name
367# This is set automatically before launching a core.
368#
369name        = avd.name
370type        = string
371default     = <build>
372abstract    = Name of the AVD being run
373