Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 8fd7bfbe8496c18e6ff09fdc4faac7330da89a61 / . / Bliss OS / troubleshooting / index.html
blob: 8a0538b6faa70950a2b2736fcd18f93ca0935448 [file] [log] [blame]
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]2<!doctype html>
3<html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]8
9
10
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]11 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]12 <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]13
14
15
16 <title>Troubleshooting - Team Bliss</title>
17
18
19
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]20 <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]21
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]22
23 <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css">
24
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]25
26
27
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]28
29
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]30
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]31 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]32 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
33 <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]34
35
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]36
37
38
39
40
41
42 </head>
43
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]44
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]45
46
47
48
49
50 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
51
52
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]53 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
54 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]55 <label class="md-overlay" for="__drawer"></label>
56 <div data-md-component="skip">
57
58
59 <a href="#troubleshooting" class="md-skip">
60 Skip to content
61 </a>
62
63 </div>
64 <div data-md-component="announce">
65
66 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]67
68 <header class="md-header" data-md-component="header">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]69 <nav class="md-header-nav md-grid" aria-label="Header">
70 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss">
71
72
73 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
74
75 </a>
76 <label class="md-header-nav__button md-icon" for="__drawer">
77 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
78 </label>
79 <div class="md-header-nav__title" data-md-component="header-title">
80
81 <div class="md-header-nav__ellipsis">
82 <span class="md-header-nav__topic md-ellipsis">
83 Team Bliss
84 </span>
85 <span class="md-header-nav__topic md-ellipsis">
86
87 Troubleshooting
88
89 </span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]90 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]91
92 </div>
93
94 <label class="md-header-nav__button md-icon" for="__search">
95 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
96 </label>
97
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]98<div class="md-search" data-md-component="search" role="dialog">
99 <label class="md-search__overlay" for="__search"></label>
100 <div class="md-search__inner" role="search">
101 <form class="md-search__form" name="search">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]102 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active">
103 <label class="md-search__icon md-icon" for="__search">
104 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
105 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
106 </label>
107 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
108 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]109 </button>
110 </form>
111 <div class="md-search__output">
112 <div class="md-search__scrollwrap" data-md-scrollfix>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]113 <div class="md-search-result" data-md-component="search-result">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]114 <div class="md-search-result__meta">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]115 Initializing search
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]116 </div>
117 <ol class="md-search-result__list"></ol>
118 </div>
119 </div>
120 </div>
121 </div>
122</div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]123
124
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]125 </nav>
126</header>
127
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]128 <div class="md-container" data-md-component="container">
129
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]130
131
132
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]133 <main class="md-main" data-md-component="main">
134 <div class="md-main__inner md-grid">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]135
136
137 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
138 <div class="md-sidebar__scrollwrap">
139 <div class="md-sidebar__inner">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]140 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
141 <label class="md-nav__title" for="__drawer">
142 <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]143
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]144
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
146
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]147 </a>
148 Team Bliss
149 </label>
150
151 <ul class="md-nav__list" data-md-scrollfix>
152
153
154
155
156
157
158 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]159 <a href="../.." title="Home" class="md-nav__link">
160 Home
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]161 </a>
162 </li>
163
164
165
166
167
168
169
170
171
172 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
173
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]174 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]175
176 <label class="md-nav__link" for="nav-2">
177 Bliss OS
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]178 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]179 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]180 <nav class="md-nav" aria-label="Bliss OS" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]181 <label class="md-nav__title" for="nav-2">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]182 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]183 Bliss OS
184 </label>
185 <ul class="md-nav__list" data-md-scrollfix>
186
187
188
189
190
191
192
193 <li class="md-nav__item">
194 <a href="../" title="Index" class="md-nav__link">
195 Index
196 </a>
197 </li>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]206 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
207 Build Guide
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]218 <a href="../extras/" title="Extras" class="md-nav__link">
219 Extras
220 </a>
221 </li>
222
223
224
225
226
227
228
229 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]230 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
231 Installation Guide (Misc)
232 </a>
233 </li>
234
235
236
237
238
239
240
241 <li class="md-nav__item">
242 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
243 Installation Guide (Surface devices)
244 </a>
245 </li>
246
247
248
249
250
251
252
253 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]254 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
255 Installation Guide
256 </a>
257 </li>
258
259
260
261
262
263
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]264
265 <li class="md-nav__item">
266 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
267 Taking bug reports
268 </a>
269 </li>
270
271
272
273
274
275
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]276
277
278
279 <li class="md-nav__item md-nav__item--active">
280
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]281 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]282
283
284
285
286 <label class="md-nav__link md-nav__link--active" for="__toc">
287 Troubleshooting
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]288 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]289 </label>
290
291 <a href="./" title="Troubleshooting" class="md-nav__link md-nav__link--active">
292 Troubleshooting
293 </a>
294
295
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]296<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]297
298
299
300
301
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]302 <label class="md-nav__title" for="__toc">
303 <span class="md-nav__icon md-icon"></span>
304 Table of contents
305 </label>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]306 <ul class="md-nav__list" data-md-scrollfix>
307
308 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]309 <a href="#32-bit-processors-only-intel-atom-and-similar" class="md-nav__link">
310 32-bit processors only (Intel Atom and similar)
311 </a>
312
313</li>
314
315 <li class="md-nav__item">
316 <a href="#grub2-kernel-parameters-and-options" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]317 grub2 kernel parameters and options
318 </a>
319
320</li>
321
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]322 </ul>
323
324</nav>
325
326 </li>
327
328
329 </ul>
330 </nav>
331 </li>
332
333
334
335
336
337
338
339 <li class="md-nav__item md-nav__item--nested">
340
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]341 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]342
343 <label class="md-nav__link" for="nav-3">
344 BlissRoms
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]345 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]346 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]347 <nav class="md-nav" aria-label="BlissRoms" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]348 <label class="md-nav__title" for="nav-3">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]349 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]350 BlissRoms
351 </label>
352 <ul class="md-nav__list" data-md-scrollfix>
353
354
355
356
357
358
359
360 <li class="md-nav__item">
361 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
362 Index
363 </a>
364 </li>
365
366
367
368
369
370
371
372 <li class="md-nav__item">
373 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
374 Build Guide
375 </a>
376 </li>
377
378
379
380
381
382
383
384 <li class="md-nav__item">
385 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
386 Build Tips
387 </a>
388 </li>
389
390
391 </ul>
392 </nav>
393 </li>
394
395
396
397
398
399
400
401 <li class="md-nav__item md-nav__item--nested">
402
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]403 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]404
405 <label class="md-nav__link" for="nav-4">
406 Common
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]407 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]408 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]409 <nav class="md-nav" aria-label="Common" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]410 <label class="md-nav__title" for="nav-4">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]411 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]412 Common
413 </label>
414 <ul class="md-nav__list" data-md-scrollfix>
415
416
417
418
419
420
421
422 <li class="md-nav__item">
423 <a href="../../common/" title="Index" class="md-nav__link">
424 Index
425 </a>
426 </li>
427
428
429
430
431
432
433
434 <li class="md-nav__item">
435 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
436 Git Started
437 </a>
438 </li>
439
440
441
442
443
444
445
446 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]447 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
448 Maintaining proper authorship
449 </a>
450 </li>
451
452
453
454
455
456
457
458 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]459 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
460 Using `dippy-bird`
461 </a>
462 </li>
463
464
465 </ul>
466 </nav>
467 </li>
468
469
470
471
472
473
474
475 <li class="md-nav__item md-nav__item--nested">
476
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]477 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]478
479 <label class="md-nav__link" for="nav-5">
480 Infrastructure
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]481 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]482 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]483 <nav class="md-nav" aria-label="Infrastructure" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]484 <label class="md-nav__title" for="nav-5">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]485 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]486 Infrastructure
487 </label>
488 <ul class="md-nav__list" data-md-scrollfix>
489
490
491
492
493
494
495
496 <li class="md-nav__item">
497 <a href="../../infrastructure/" title="Index" class="md-nav__link">
498 Index
499 </a>
500 </li>
501
502
503 </ul>
504 </nav>
505 </li>
506
507
508 </ul>
509</nav>
510 </div>
511 </div>
512 </div>
513
514
515 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
516 <div class="md-sidebar__scrollwrap">
517 <div class="md-sidebar__inner">
518
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]519<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]520
521
522
523
524
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]525 <label class="md-nav__title" for="__toc">
526 <span class="md-nav__icon md-icon"></span>
527 Table of contents
528 </label>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]529 <ul class="md-nav__list" data-md-scrollfix>
530
531 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]532 <a href="#32-bit-processors-only-intel-atom-and-similar" class="md-nav__link">
533 32-bit processors only (Intel Atom and similar)
534 </a>
535
536</li>
537
538 <li class="md-nav__item">
539 <a href="#grub2-kernel-parameters-and-options" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]540 grub2 kernel parameters and options
541 </a>
542
543</li>
544
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]545 </ul>
546
547</nav>
548 </div>
549 </div>
550 </div>
551
552
553 <div class="md-content">
554 <article class="md-content__inner md-typeset">
555
556
557
558 <h1 id="troubleshooting">Troubleshooting</h1>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]559<p>Welcome to the troubleshooting section of Bliss OS!</p>
560<p>If you believe you have found a bug, <a href="../taking-bug-reports/">please send us a bug report!</a></p>
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]561<h2 id="32-bit-processors-only-intel-atom-and-similar">32-bit processors only (Intel Atom and similar)</h2>
562<ol>
Eric Parkfaec4202019-10-21 01:46:53 +0800[diff] [blame]563<li>Install <a href="https://www.android-x86.org/">Android-x86 32-bit OS from here</a> (doesn't matter which version, as long as it's 32-bit)</li>
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]564<li>Update with Bliss OS 32-bit (current version is 11.9). After reboot you should be able to access the <code>grub</code> menu.</li>
565<li>In <code>grub</code> menu select "Debug mode"</li>
566<li>Run the following commands:
567 <pre><code>mount -o remount, rw /mnt
568cd /mnt/grub
Eric Parkfaec4202019-10-21 01:46:53 +0800[diff] [blame]569nano menu.lst</code></pre></li>
Eric Park4f3099f2019-10-21 08:56:15 +0800[diff] [blame]570<li>Add <code>nomodeset</code> before every <code>SCR=/bliss...</code> line. For example, your configuration should look something like this:
571 <pre><code>default=0
572timeout=6
573splashimage=/grub/android-x86.xpm.gz
574root (hd0,0)
575title Bliss-OS 11.7
576 kernel /bliss-x86-11.7/kernel quiet root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7
577 initrd /bliss-x86-11.7/initrd.img
578title Bliss-OS 11.7 (Legacy modprobe mode)
579 kernel /bliss-x86-11.7/kernel root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M androidboot.hardware=android_x86_64 AUTO_LOAD=old nomodeset SRC=/bliss-x86-11.7
580 initrd /bliss-x86-11.7/initrd.img
581title Bliss-OS 11.7 (Debug mode)
582 kernel /bliss-x86-11.7/kernel root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7
583 initrd /bliss-x86-11.7/initrd.img
584title Bliss-OS 11.7 (Debug nomodeset)
585 kernel /bliss-x86-11.7/kernel nomodeset root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7
586 initrd /bliss-x86-11.7/initrd.img
587title Bliss-OS 11.7 (Debug video=LVDS-1:d)
588 kernel /bliss-x86-11.7/kernel video=LVDS-1:d root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 nomodeset SRC=/bliss-x86-11.7
589 initrd /bliss-x86-11.7/initrd.img</code></pre></li>
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]590<li>Press Ctrl+O to save, and then Ctrl+X to close.</li>
591<li>Type <code>reboot -f</code></li>
592</ol>
593<p>You should be finished! If all goes well you will boot into Bliss OS on your 32-bit machine.</p>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]594<h2 id="grub2-kernel-parameters-and-options"><code>grub2</code> kernel parameters and options</h2>
595<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>
596<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>
597<p>Brief options overview:</p>
598<ul>
599<li><code>parameter</code>: Description</li>
600<li><code>root=</code>: Root filesystem.</li>
601<li><code>rootflags=</code>: Root filesystem mount options.</li>
602<li><code>initrd=</code>: Specify the location of the initial ramdisk.</li>
603<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>
604<li><code>init=/bin/sh</code>: Boot to shell.</li>
605<li><code>systemd.unit=</code>: Boot to a specified target.</li>
606<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>
607<li><code>panic=</code>: Time before automatic reboot on kernel panic.</li>
608<li><code>debug</code>: Enable kernel debugging (events log level).</li>
609<li><code>mem=</code>: Force usage of a specific amount of memory to be used.</li>
610<li><code>maxcpus=</code>: Maximum number of processors that an SMP kernel will bring up during bootup.</li>
611<li><code>selinux=</code>: Disable or enable SELinux at boot time.</li>
612<li><code>netdev=</code>: Network devices parameters.</li>
613<li><code>video=&lt;videosetting&gt;</code>: Override framebuffer video defaults.</li>
614<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>
615<li><code>acpi_sleep=s3_bios,s3_mode</code>: Sometimes needed for older machines to enter sleep mode properly</li>
616<li><code>SETUPWIZARD=0</code>: This command will skip SetupWizard on boot. (Only needs to be run once!)</li>
617<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>
618<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>
619<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>
620<li><code>HWACCELL=1</code>: This will disable graphics hardware acceleration, enabling rendering through Swiftshader. (Must use this if running headless)</li>
621<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>
622<li><code>DPI=xxx</code>: This will manually set the DPI on init. Use this if things are too big/small for you.</li>
623<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>
Eric Park5ae1c6c2019-08-21 11:08:22 -0700[diff] [blame]624<li><code>VULKAN=1</code>: Required for Vulkan-supported chipsets. This enables <code>hwcomposer</code> to work right with screenshots and other things.</li>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]625</ul>
Eric Park30fb8392020-02-02 12:23:28 +0900[diff] [blame]626<div class="admonition warning">
627<p class="admonition-title">Warning</p>
628<p>The following options can only be used on Android 9/10 builds released after 2020-02-02.</p>
629</div>
630<ul>
631<li><code>HWC=xxx</code>: Define <code>DRM_HWComposer</code> - options include <code>drm</code>, <code>drm_minigbm</code>, and <code>intel</code>.</li>
632<li><code>GRALLOC=xxx</code>: Define <code>DRM_Gralloc</code> - options include <code>gbm</code>, <code>minigbm</code>, and <code>intel</code>.</li>
633</ul>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]634<p>As an example, here are a few of the boot options used in testing:</p>
635<pre><code>menuentry 'Bliss-x86 Test-Oreo' --class bliss {
636 search --file --no-floppy --set=root /AndroidOS/android.boot
637 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet sleep.earlysuspend=2 DATA=
638 initrd /AndroidOS/initrd.img
639}
640
641menuentry 'Bliss-x86 Test-Oreo AUTO_LOAD=old' --class bliss {
642 search --file --no-floppy --set=root /AndroidOS/android.boot
643 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet DATA= AUTO_LOAD=old
644 initrd /AndroidOS/initrd.img
645}
646
647menuentry 'Bliss-x86 Test-Oreo - SETUP_WIZARD=0' --class bliss {
648 search --file --no-floppy --set=root /AndroidOS/android.boot
649 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive buildvariant=eng SETUPWIZARD=0 quiet DATA=
650 initrd /AndroidOS/initrd.img
651}
652
653menuentry 'Bliss-x86 Test-Oreo - debug=1' --class bliss {
654 search --file --no-floppy --set=root /AndroidOS/android.boot
655 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=1
656 initrd /AndroidOS/initrd.img
657}
658
659menuentry 'Bliss-x86 Test-Oreo - debug=2' --class bliss {
660 search --file --no-floppy --set=root /AndroidOS/android.boot
661 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=2
662 initrd /AndroidOS/initrd.img
663}
664</code></pre>
665
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]666
667
668
669
670
671
672 </article>
673 </div>
674 </div>
675 </main>
676
677
678<footer class="md-footer">
679
680 <div class="md-footer-nav">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]681 <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]682
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]683 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
684 <div class="md-footer-nav__button md-icon">
685 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]686 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]687 <div class="md-footer-nav__title">
688 <div class="md-ellipsis">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]689 <span class="md-footer-nav__direction">
690 Previous
691 </span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]692 Taking bug reports
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]693 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]694 </div>
695 </a>
696
697
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]698 <a href="../../BlissRoms/" title="Index" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
699 <div class="md-footer-nav__title">
700 <div class="md-ellipsis">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]701 <span class="md-footer-nav__direction">
702 Next
703 </span>
704 Index
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]705 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]706 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]707 <div class="md-footer-nav__button md-icon">
708 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]709 </div>
710 </a>
711
712 </nav>
713 </div>
714
715 <div class="md-footer-meta md-typeset">
716 <div class="md-footer-meta__inner md-grid">
717 <div class="md-footer-copyright">
718
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]719 Made with
720 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
721 Material for MkDocs
722 </a>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]723 </div>
724
725 </div>
726 </div>
727</footer>
728
729 </div>
730
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]731 <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script>
732 <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]733
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]734 <script>
735 app = initialize({
736 base: "../..",
737 features: [],
738 search: Object.assign({
739 worker: "../../assets/javascripts/worker/search.4ac00218.min.js"
740 }, typeof search !== "undefined" && search)
741 })
742 </script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]743
744
745 </body>
746</html>