Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 5e3a101ae14d3f8fd12fec6fd6e71dbd9c2a4e99 / . / Bliss OS / troubleshooting / index.html
blob: a9a20f61bd99851218765ed397b320c489cd1373 [file] [log] [blame]
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1
2
3
4
5<!doctype html>
6<html lang="en" class="no-js">
7 <head>
8
9 <meta charset="utf-8">
10 <meta name="viewport" content="width=device-width,initial-scale=1">
11 <meta http-equiv="x-ua-compatible" content="ie=edge">
12
13
14
15
16 <meta name="lang:clipboard.copy" content="Copy to clipboard">
17
18 <meta name="lang:clipboard.copied" content="Copied to clipboard">
19
20 <meta name="lang:search.language" content="en">
21
22 <meta name="lang:search.pipeline.stopwords" content="True">
23
24 <meta name="lang:search.pipeline.trimmer" content="True">
25
26 <meta name="lang:search.result.none" content="No matching documents">
27
28 <meta name="lang:search.result.one" content="1 matching document">
29
30 <meta name="lang:search.result.other" content="# matching documents">
31
32 <meta name="lang:search.tokenizer" content="[\s\-]+">
33
34 <link rel="shortcut icon" href="../../assets/images/favicon.png">
35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.0">
36
37
38
39 <title>Troubleshooting - Team Bliss</title>
40
41
42
43 <link rel="stylesheet" href="../../assets/stylesheets/application.0284f74d.css">
44
45
46
47
48 <script src="../../assets/javascripts/modernizr.74668098.js"></script>
49
50
51
52 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono&display=fallback">
54 <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
55
56
57 <link rel="stylesheet" href="../../assets/fonts/material-icons.css">
58
59
60
61
62
63
64 </head>
65
66 <body dir="ltr">
67
68 <svg class="md-svg">
69 <defs>
70
71
72 </defs>
73 </svg>
74 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
75 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
76 <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
77
78 <a href="#troubleshooting" tabindex="1" class="md-skip">
79 Skip to content
80 </a>
81
82
83 <header class="md-header" data-md-component="header">
84 <nav class="md-header-nav md-grid">
85 <div class="md-flex">
86 <div class="md-flex__cell md-flex__cell--shrink">
87 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo">
88
89 <i class="md-icon"></i>
90
91 </a>
92 </div>
93 <div class="md-flex__cell md-flex__cell--shrink">
94 <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
95 </div>
96 <div class="md-flex__cell md-flex__cell--stretch">
97 <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
98
99 <span class="md-header-nav__topic">
100 Team Bliss
101 </span>
102 <span class="md-header-nav__topic">
103
104 Troubleshooting
105
106 </span>
107
108 </div>
109 </div>
110 <div class="md-flex__cell md-flex__cell--shrink">
111
112 <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
113
114<div class="md-search" data-md-component="search" role="dialog">
115 <label class="md-search__overlay" for="__search"></label>
116 <div class="md-search__inner" role="search">
117 <form class="md-search__form" name="search">
118 <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
119 <label class="md-icon md-search__icon" for="__search"></label>
120 <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
121 &#xE5CD;
122 </button>
123 </form>
124 <div class="md-search__output">
125 <div class="md-search__scrollwrap" data-md-scrollfix>
126 <div class="md-search-result" data-md-component="result">
127 <div class="md-search-result__meta">
128 Type to start searching
129 </div>
130 <ol class="md-search-result__list"></ol>
131 </div>
132 </div>
133 </div>
134 </div>
135</div>
136
137 </div>
138
139 </div>
140 </nav>
141</header>
142
143 <div class="md-container">
144
145
146
147
148 <main class="md-main">
149 <div class="md-main__inner md-grid" data-md-component="container">
150
151
152 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
153 <div class="md-sidebar__scrollwrap">
154 <div class="md-sidebar__inner">
155 <nav class="md-nav md-nav--primary" data-md-level="0">
156 <label class="md-nav__title md-nav__title--site" for="__drawer">
157 <a href="../.." title="Team Bliss" class="md-nav__button md-logo">
158
159 <i class="md-icon"></i>
160
161 </a>
162 Team Bliss
163 </label>
164
165 <ul class="md-nav__list" data-md-scrollfix>
166
167
168
169
170
171
172 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame^]173 <a href="../.." title="Home" class="md-nav__link">
174 Home
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]175 </a>
176 </li>
177
178
179
180
181
182
183
184
185
186 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
187
188 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
189
190 <label class="md-nav__link" for="nav-2">
191 Bliss OS
192 </label>
193 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
194 <label class="md-nav__title" for="nav-2">
195 Bliss OS
196 </label>
197 <ul class="md-nav__list" data-md-scrollfix>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../" title="Index" class="md-nav__link">
207 Index
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame^]218 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
219 Build Guide
220 </a>
221 </li>
222
223
224
225
226
227
228
229 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]230 <a href="../extras/" title="Extras" class="md-nav__link">
231 Extras
232 </a>
233 </li>
234
235
236
237
238
239
240
241 <li class="md-nav__item">
242 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
243 Installation Guide
244 </a>
245 </li>
246
247
248
249
250
251
252
253
254
255 <li class="md-nav__item md-nav__item--active">
256
257 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
258
259
260
261
262 <label class="md-nav__link md-nav__link--active" for="__toc">
263 Troubleshooting
264 </label>
265
266 <a href="./" title="Troubleshooting" class="md-nav__link md-nav__link--active">
267 Troubleshooting
268 </a>
269
270
271<nav class="md-nav md-nav--secondary">
272
273
274
275
276
277 <label class="md-nav__title" for="__toc">Table of contents</label>
278 <ul class="md-nav__list" data-md-scrollfix>
279
280 <li class="md-nav__item">
281 <a href="#grub2-kernel-parameters-and-options" title="grub2 kernel parameters and options" class="md-nav__link">
282 grub2 kernel parameters and options
283 </a>
284
285</li>
286
287
288
289
290
291 </ul>
292
293</nav>
294
295 </li>
296
297
298 </ul>
299 </nav>
300 </li>
301
302
303
304
305
306
307
308 <li class="md-nav__item md-nav__item--nested">
309
310 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
311
312 <label class="md-nav__link" for="nav-3">
313 BlissRoms
314 </label>
315 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
316 <label class="md-nav__title" for="nav-3">
317 BlissRoms
318 </label>
319 <ul class="md-nav__list" data-md-scrollfix>
320
321
322
323
324
325
326
327 <li class="md-nav__item">
328 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
329 Index
330 </a>
331 </li>
332
333
334
335
336
337
338
339 <li class="md-nav__item">
340 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
341 Build Guide
342 </a>
343 </li>
344
345
346
347
348
349
350
351 <li class="md-nav__item">
352 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
353 Build Tips
354 </a>
355 </li>
356
357
358 </ul>
359 </nav>
360 </li>
361
362
363
364
365
366
367
368 <li class="md-nav__item md-nav__item--nested">
369
370 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
371
372 <label class="md-nav__link" for="nav-4">
373 Common
374 </label>
375 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
376 <label class="md-nav__title" for="nav-4">
377 Common
378 </label>
379 <ul class="md-nav__list" data-md-scrollfix>
380
381
382
383
384
385
386
387 <li class="md-nav__item">
388 <a href="../../common/" title="Index" class="md-nav__link">
389 Index
390 </a>
391 </li>
392
393
394
395
396
397
398
399 <li class="md-nav__item">
400 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
401 Git Started
402 </a>
403 </li>
404
405
406
407
408
409
410
411 <li class="md-nav__item">
412 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
413 Using `dippy-bird`
414 </a>
415 </li>
416
417
418 </ul>
419 </nav>
420 </li>
421
422
423
424
425
426
427
428 <li class="md-nav__item md-nav__item--nested">
429
430 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
431
432 <label class="md-nav__link" for="nav-5">
433 Infrastructure
434 </label>
435 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
436 <label class="md-nav__title" for="nav-5">
437 Infrastructure
438 </label>
439 <ul class="md-nav__list" data-md-scrollfix>
440
441
442
443
444
445
446
447 <li class="md-nav__item">
448 <a href="../../infrastructure/" title="Index" class="md-nav__link">
449 Index
450 </a>
451 </li>
452
453
454 </ul>
455 </nav>
456 </li>
457
458
459 </ul>
460</nav>
461 </div>
462 </div>
463 </div>
464
465
466 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
467 <div class="md-sidebar__scrollwrap">
468 <div class="md-sidebar__inner">
469
470<nav class="md-nav md-nav--secondary">
471
472
473
474
475
476 <label class="md-nav__title" for="__toc">Table of contents</label>
477 <ul class="md-nav__list" data-md-scrollfix>
478
479 <li class="md-nav__item">
480 <a href="#grub2-kernel-parameters-and-options" title="grub2 kernel parameters and options" class="md-nav__link">
481 grub2 kernel parameters and options
482 </a>
483
484</li>
485
486
487
488
489
490 </ul>
491
492</nav>
493 </div>
494 </div>
495 </div>
496
497
498 <div class="md-content">
499 <article class="md-content__inner md-typeset">
500
501
502
503 <h1 id="troubleshooting">Troubleshooting</h1>
504<h2 id="grub2-kernel-parameters-and-options"><code>grub2</code> kernel parameters and options</h2>
505<p><strong>You will want to pay attention here!</strong> With Bliss OS on the PC, we tend to use quite a few command line options to get things working right. We've gathered a few of them here to explain them a little bit.</p>
506<p><a href="https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt">A full list of available kernel parameters can be found here.</a></p>
507<p>Brief options overview:</p>
508<ul>
509<li><code>parameter</code>: Description</li>
510<li><code>root=</code>: Root filesystem.</li>
511<li><code>rootflags=</code>: Root filesystem mount options.</li>
512<li><code>initrd=</code>: Specify the location of the initial ramdisk.</li>
513<li><code>init=</code>: Run specified binary instead of <code>/sbin/init</code> (symlinked to <code>systemd</code> in Arch) as <code>init</code> process.</li>
514<li><code>init=/bin/sh</code>: Boot to shell.</li>
515<li><code>systemd.unit=</code>: Boot to a specified target.</li>
516<li><code>nomodeset</code>: Disable kernel mode setting (useful for fixing video driver panics) This will load mostly everything in software rendering/support mode. No hardware acceleration. Good for debugging. </li>
517<li><code>panic=</code>: Time before automatic reboot on kernel panic.</li>
518<li><code>debug</code>: Enable kernel debugging (events log level).</li>
519<li><code>mem=</code>: Force usage of a specific amount of memory to be used.</li>
520<li><code>maxcpus=</code>: Maximum number of processors that an SMP kernel will bring up during bootup.</li>
521<li><code>selinux=</code>: Disable or enable SELinux at boot time.</li>
522<li><code>netdev=</code>: Network devices parameters.</li>
523<li><code>video=&lt;videosetting&gt;</code>: Override framebuffer video defaults.</li>
524<li><code>sleep=1</code>: This will enable the system.prop value for <code>sleep.earlysuspend=1</code>, and on some machines, it enables the proper sleep state.</li>
525<li><code>acpi_sleep=s3_bios,s3_mode</code>: Sometimes needed for older machines to enter sleep mode properly</li>
526<li><code>SETUPWIZARD=0</code>: This command will skip SetupWizard on boot. (Only needs to be run once!)</li>
527<li><code>AUTO_LOAD=old</code>: This will load android-x86 variants using the old <code>modprobe</code> method to init devices. We sometimes use this to debug devices not starting. </li>
528<li><code>DEBUG=1 &amp; DEBUG=2</code>: These enable verbose console debugging, giving another command shell after loading kernel modules, but before Android <code>init</code></li>
529<li><code>vga=xxx &amp; video=</code>: These are the common video modes that you can boot into if it doesn't pick the best choice automagically. You can also use <code>video=</code> as resolution parameters: <code>video=LVDS-1:d video=1366x800</code>. <a href="https://groups.google.com/forum/#!msg/android-x86/jSF3RnADnqA/1sfYdGV_AQAJ">Learn more from our own Henri Koivuneva!</a></li>
530<li><code>HWACCELL=1</code>: This will disable graphics hardware acceleration, enabling rendering through Swiftshader. (Must use this if running headless)</li>
531<li><code>buildvariant=eng, user, userdebug</code>: This is the commandline parameter to run the current build as <code>eng</code>, <code>userdebug</code>, or <code>user</code> </li>
532<li><code>DPI=xxx</code>: This will manually set the DPI on init. Use this if things are too big/small for you.</li>
533<li><code>fbcon=variablename</code>: This is to configure framebuffer to use various options. Usually used to help fix video settings, etc. Even default rotation on some Atom tablets. Example: <code>video=efifb fbcon=rotate:1</code></li>
534</ul>
535<p>As an example, here are a few of the boot options used in testing:</p>
536<pre><code>menuentry 'Bliss-x86 Test-Oreo' --class bliss {
537 search --file --no-floppy --set=root /AndroidOS/android.boot
538 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet sleep.earlysuspend=2 DATA=
539 initrd /AndroidOS/initrd.img
540}
541
542menuentry 'Bliss-x86 Test-Oreo AUTO_LOAD=old' --class bliss {
543 search --file --no-floppy --set=root /AndroidOS/android.boot
544 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet DATA= AUTO_LOAD=old
545 initrd /AndroidOS/initrd.img
546}
547
548menuentry 'Bliss-x86 Test-Oreo - SETUP_WIZARD=0' --class bliss {
549 search --file --no-floppy --set=root /AndroidOS/android.boot
550 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive buildvariant=eng SETUPWIZARD=0 quiet DATA=
551 initrd /AndroidOS/initrd.img
552}
553
554menuentry 'Bliss-x86 Test-Oreo - debug=1' --class bliss {
555 search --file --no-floppy --set=root /AndroidOS/android.boot
556 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=1
557 initrd /AndroidOS/initrd.img
558}
559
560menuentry 'Bliss-x86 Test-Oreo - debug=2' --class bliss {
561 search --file --no-floppy --set=root /AndroidOS/android.boot
562 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=2
563 initrd /AndroidOS/initrd.img
564}
565</code></pre>
566
567
568
569
570
571
572
573
574
575 </article>
576 </div>
577 </div>
578 </main>
579
580
581<footer class="md-footer">
582
583 <div class="md-footer-nav">
584 <nav class="md-footer-nav__inner md-grid">
585
586 <a href="../installation-guide/" title="Installation Guide" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
587 <div class="md-flex__cell md-flex__cell--shrink">
588 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
589 </div>
590 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
591 <span class="md-flex__ellipsis">
592 <span class="md-footer-nav__direction">
593 Previous
594 </span>
595 Installation Guide
596 </span>
597 </div>
598 </a>
599
600
601 <a href="../../BlissRoms/" title="Index" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
602 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
603 <span class="md-flex__ellipsis">
604 <span class="md-footer-nav__direction">
605 Next
606 </span>
607 Index
608 </span>
609 </div>
610 <div class="md-flex__cell md-flex__cell--shrink">
611 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
612 </div>
613 </a>
614
615 </nav>
616 </div>
617
618 <div class="md-footer-meta md-typeset">
619 <div class="md-footer-meta__inner md-grid">
620 <div class="md-footer-copyright">
621
622 powered by
623 <a href="https://www.mkdocs.org">MkDocs</a>
624 and
625 <a href="https://squidfunk.github.io/mkdocs-material/">
626 Material for MkDocs</a>
627 </div>
628
629 </div>
630 </div>
631</footer>
632
633 </div>
634
635 <script src="../../assets/javascripts/application.245445c6.js"></script>
636
637 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
638
639
640 </body>
641</html>