Eric Park | 608ce5a | 2019-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"> |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 35 | <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.3"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 36 | |
| 37 | |
| 38 | |
| 39 | <title>Troubleshooting - Team Bliss</title> |
| 40 | |
| 41 | |
| 42 | |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 43 | <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.css"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 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 |  |
| 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 | |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 148 | <main class="md-main" role="main"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 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 Park | 5e3a101 | 2019-08-12 13:17:03 +0800 | [diff] [blame] | 173 | <a href="../.." title="Home" class="md-nav__link"> |
| 174 | Home |
Eric Park | 608ce5a | 2019-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 Park | 5e3a101 | 2019-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 Park | 608ce5a | 2019-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"> |
Eric Park | d09b00e | 2020-02-15 11:07:48 +0900 | [diff] [blame] | 242 | <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link"> |
| 243 | Installation Guide (Misc) |
| 244 | </a> |
| 245 | </li> |
| 246 | |
| 247 | |
| 248 | |
| 249 | |
| 250 | |
| 251 | |
| 252 | |
| 253 | <li class="md-nav__item"> |
| 254 | <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link"> |
| 255 | Installation Guide (Surface devices) |
| 256 | </a> |
| 257 | </li> |
| 258 | |
| 259 | |
| 260 | |
| 261 | |
| 262 | |
| 263 | |
| 264 | |
| 265 | <li class="md-nav__item"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 266 | <a href="../installation-guide/" title="Installation Guide" class="md-nav__link"> |
| 267 | Installation Guide |
| 268 | </a> |
| 269 | </li> |
| 270 | |
| 271 | |
| 272 | |
| 273 | |
| 274 | |
| 275 | |
Eric Park | 0509f65 | 2020-03-01 01:54:39 +0900 | [diff] [blame^] | 276 | |
| 277 | <li class="md-nav__item"> |
| 278 | <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link"> |
| 279 | Taking bug reports |
| 280 | </a> |
| 281 | </li> |
| 282 | |
| 283 | |
| 284 | |
| 285 | |
| 286 | |
| 287 | |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 288 | |
| 289 | |
| 290 | |
| 291 | <li class="md-nav__item md-nav__item--active"> |
| 292 | |
| 293 | <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc"> |
| 294 | |
| 295 | |
| 296 | |
| 297 | |
| 298 | <label class="md-nav__link md-nav__link--active" for="__toc"> |
| 299 | Troubleshooting |
| 300 | </label> |
| 301 | |
| 302 | <a href="./" title="Troubleshooting" class="md-nav__link md-nav__link--active"> |
| 303 | Troubleshooting |
| 304 | </a> |
| 305 | |
| 306 | |
| 307 | <nav class="md-nav md-nav--secondary"> |
| 308 | |
| 309 | |
| 310 | |
| 311 | |
| 312 | |
| 313 | <label class="md-nav__title" for="__toc">Table of contents</label> |
| 314 | <ul class="md-nav__list" data-md-scrollfix> |
| 315 | |
| 316 | <li class="md-nav__item"> |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 317 | <a href="#32-bit-processors-only-intel-atom-and-similar" class="md-nav__link"> |
| 318 | 32-bit processors only (Intel Atom and similar) |
| 319 | </a> |
| 320 | |
| 321 | </li> |
| 322 | |
| 323 | <li class="md-nav__item"> |
| 324 | <a href="#grub2-kernel-parameters-and-options" class="md-nav__link"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 325 | grub2 kernel parameters and options |
| 326 | </a> |
| 327 | |
| 328 | </li> |
| 329 | |
| 330 | |
| 331 | |
| 332 | |
| 333 | |
| 334 | </ul> |
| 335 | |
| 336 | </nav> |
| 337 | |
| 338 | </li> |
| 339 | |
| 340 | |
| 341 | </ul> |
| 342 | </nav> |
| 343 | </li> |
| 344 | |
| 345 | |
| 346 | |
| 347 | |
| 348 | |
| 349 | |
| 350 | |
| 351 | <li class="md-nav__item md-nav__item--nested"> |
| 352 | |
| 353 | <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3"> |
| 354 | |
| 355 | <label class="md-nav__link" for="nav-3"> |
| 356 | BlissRoms |
| 357 | </label> |
| 358 | <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> |
| 359 | <label class="md-nav__title" for="nav-3"> |
| 360 | BlissRoms |
| 361 | </label> |
| 362 | <ul class="md-nav__list" data-md-scrollfix> |
| 363 | |
| 364 | |
| 365 | |
| 366 | |
| 367 | |
| 368 | |
| 369 | |
| 370 | <li class="md-nav__item"> |
| 371 | <a href="../../BlissRoms/" title="Index" class="md-nav__link"> |
| 372 | Index |
| 373 | </a> |
| 374 | </li> |
| 375 | |
| 376 | |
| 377 | |
| 378 | |
| 379 | |
| 380 | |
| 381 | |
| 382 | <li class="md-nav__item"> |
| 383 | <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link"> |
| 384 | Build Guide |
| 385 | </a> |
| 386 | </li> |
| 387 | |
| 388 | |
| 389 | |
| 390 | |
| 391 | |
| 392 | |
| 393 | |
| 394 | <li class="md-nav__item"> |
| 395 | <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link"> |
| 396 | Build Tips |
| 397 | </a> |
| 398 | </li> |
| 399 | |
| 400 | |
| 401 | </ul> |
| 402 | </nav> |
| 403 | </li> |
| 404 | |
| 405 | |
| 406 | |
| 407 | |
| 408 | |
| 409 | |
| 410 | |
| 411 | <li class="md-nav__item md-nav__item--nested"> |
| 412 | |
| 413 | <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4"> |
| 414 | |
| 415 | <label class="md-nav__link" for="nav-4"> |
| 416 | Common |
| 417 | </label> |
| 418 | <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> |
| 419 | <label class="md-nav__title" for="nav-4"> |
| 420 | Common |
| 421 | </label> |
| 422 | <ul class="md-nav__list" data-md-scrollfix> |
| 423 | |
| 424 | |
| 425 | |
| 426 | |
| 427 | |
| 428 | |
| 429 | |
| 430 | <li class="md-nav__item"> |
| 431 | <a href="../../common/" title="Index" class="md-nav__link"> |
| 432 | Index |
| 433 | </a> |
| 434 | </li> |
| 435 | |
| 436 | |
| 437 | |
| 438 | |
| 439 | |
| 440 | |
| 441 | |
| 442 | <li class="md-nav__item"> |
| 443 | <a href="../../common/git-started/" title="Git Started" class="md-nav__link"> |
| 444 | Git Started |
| 445 | </a> |
| 446 | </li> |
| 447 | |
| 448 | |
| 449 | |
| 450 | |
| 451 | |
| 452 | |
| 453 | |
| 454 | <li class="md-nav__item"> |
Eric Park | 8584eda | 2019-09-02 09:45:55 +0800 | [diff] [blame] | 455 | <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link"> |
| 456 | Maintaining proper authorship |
| 457 | </a> |
| 458 | </li> |
| 459 | |
| 460 | |
| 461 | |
| 462 | |
| 463 | |
| 464 | |
| 465 | |
| 466 | <li class="md-nav__item"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 467 | <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link"> |
| 468 | Using `dippy-bird` |
| 469 | </a> |
| 470 | </li> |
| 471 | |
| 472 | |
| 473 | </ul> |
| 474 | </nav> |
| 475 | </li> |
| 476 | |
| 477 | |
| 478 | |
| 479 | |
| 480 | |
| 481 | |
| 482 | |
| 483 | <li class="md-nav__item md-nav__item--nested"> |
| 484 | |
| 485 | <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5"> |
| 486 | |
| 487 | <label class="md-nav__link" for="nav-5"> |
| 488 | Infrastructure |
| 489 | </label> |
| 490 | <nav class="md-nav" data-md-component="collapsible" data-md-level="1"> |
| 491 | <label class="md-nav__title" for="nav-5"> |
| 492 | Infrastructure |
| 493 | </label> |
| 494 | <ul class="md-nav__list" data-md-scrollfix> |
| 495 | |
| 496 | |
| 497 | |
| 498 | |
| 499 | |
| 500 | |
| 501 | |
| 502 | <li class="md-nav__item"> |
| 503 | <a href="../../infrastructure/" title="Index" class="md-nav__link"> |
| 504 | Index |
| 505 | </a> |
| 506 | </li> |
| 507 | |
| 508 | |
| 509 | </ul> |
| 510 | </nav> |
| 511 | </li> |
| 512 | |
| 513 | |
| 514 | </ul> |
| 515 | </nav> |
| 516 | </div> |
| 517 | </div> |
| 518 | </div> |
| 519 | |
| 520 | |
| 521 | <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> |
| 522 | <div class="md-sidebar__scrollwrap"> |
| 523 | <div class="md-sidebar__inner"> |
| 524 | |
| 525 | <nav class="md-nav md-nav--secondary"> |
| 526 | |
| 527 | |
| 528 | |
| 529 | |
| 530 | |
| 531 | <label class="md-nav__title" for="__toc">Table of contents</label> |
| 532 | <ul class="md-nav__list" data-md-scrollfix> |
| 533 | |
| 534 | <li class="md-nav__item"> |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 535 | <a href="#32-bit-processors-only-intel-atom-and-similar" class="md-nav__link"> |
| 536 | 32-bit processors only (Intel Atom and similar) |
| 537 | </a> |
| 538 | |
| 539 | </li> |
| 540 | |
| 541 | <li class="md-nav__item"> |
| 542 | <a href="#grub2-kernel-parameters-and-options" class="md-nav__link"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 543 | grub2 kernel parameters and options |
| 544 | </a> |
| 545 | |
| 546 | </li> |
| 547 | |
| 548 | |
| 549 | |
| 550 | |
| 551 | |
| 552 | </ul> |
| 553 | |
| 554 | </nav> |
| 555 | </div> |
| 556 | </div> |
| 557 | </div> |
| 558 | |
| 559 | |
| 560 | <div class="md-content"> |
| 561 | <article class="md-content__inner md-typeset"> |
| 562 | |
| 563 | |
| 564 | |
| 565 | <h1 id="troubleshooting">Troubleshooting</h1> |
Eric Park | 0509f65 | 2020-03-01 01:54:39 +0900 | [diff] [blame^] | 566 | <p>Welcome to the troubleshooting section of Bliss OS!</p> |
| 567 | <p>If you believe you have found a bug, <a href="../taking-bug-reports/">please send us a bug report!</a></p> |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 568 | <h2 id="32-bit-processors-only-intel-atom-and-similar">32-bit processors only (Intel Atom and similar)</h2> |
| 569 | <ol> |
Eric Park | faec420 | 2019-10-21 01:46:53 +0800 | [diff] [blame] | 570 | <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 Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 571 | <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> |
| 572 | <li>In <code>grub</code> menu select "Debug mode"</li> |
| 573 | <li>Run the following commands: |
| 574 | <pre><code>mount -o remount, rw /mnt |
| 575 | cd /mnt/grub |
Eric Park | faec420 | 2019-10-21 01:46:53 +0800 | [diff] [blame] | 576 | nano menu.lst</code></pre></li> |
Eric Park | 4f3099f | 2019-10-21 08:56:15 +0800 | [diff] [blame] | 577 | <li>Add <code>nomodeset</code> before every <code>SCR=/bliss...</code> line. For example, your configuration should look something like this: |
| 578 | <pre><code>default=0 |
| 579 | timeout=6 |
| 580 | splashimage=/grub/android-x86.xpm.gz |
| 581 | root (hd0,0) |
| 582 | title Bliss-OS 11.7 |
| 583 | 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 |
| 584 | initrd /bliss-x86-11.7/initrd.img |
| 585 | title Bliss-OS 11.7 (Legacy modprobe mode) |
| 586 | 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 |
| 587 | initrd /bliss-x86-11.7/initrd.img |
| 588 | title Bliss-OS 11.7 (Debug mode) |
| 589 | 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 |
| 590 | initrd /bliss-x86-11.7/initrd.img |
| 591 | title Bliss-OS 11.7 (Debug nomodeset) |
| 592 | 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 |
| 593 | initrd /bliss-x86-11.7/initrd.img |
| 594 | title Bliss-OS 11.7 (Debug video=LVDS-1:d) |
| 595 | 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 |
| 596 | initrd /bliss-x86-11.7/initrd.img</code></pre></li> |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 597 | <li>Press Ctrl+O to save, and then Ctrl+X to close.</li> |
| 598 | <li>Type <code>reboot -f</code></li> |
| 599 | </ol> |
| 600 | <p>You should be finished! If all goes well you will boot into Bliss OS on your 32-bit machine.</p> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 601 | <h2 id="grub2-kernel-parameters-and-options"><code>grub2</code> kernel parameters and options</h2> |
| 602 | <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> |
| 603 | <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> |
| 604 | <p>Brief options overview:</p> |
| 605 | <ul> |
| 606 | <li><code>parameter</code>: Description</li> |
| 607 | <li><code>root=</code>: Root filesystem.</li> |
| 608 | <li><code>rootflags=</code>: Root filesystem mount options.</li> |
| 609 | <li><code>initrd=</code>: Specify the location of the initial ramdisk.</li> |
| 610 | <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> |
| 611 | <li><code>init=/bin/sh</code>: Boot to shell.</li> |
| 612 | <li><code>systemd.unit=</code>: Boot to a specified target.</li> |
| 613 | <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> |
| 614 | <li><code>panic=</code>: Time before automatic reboot on kernel panic.</li> |
| 615 | <li><code>debug</code>: Enable kernel debugging (events log level).</li> |
| 616 | <li><code>mem=</code>: Force usage of a specific amount of memory to be used.</li> |
| 617 | <li><code>maxcpus=</code>: Maximum number of processors that an SMP kernel will bring up during bootup.</li> |
| 618 | <li><code>selinux=</code>: Disable or enable SELinux at boot time.</li> |
| 619 | <li><code>netdev=</code>: Network devices parameters.</li> |
| 620 | <li><code>video=<videosetting></code>: Override framebuffer video defaults.</li> |
| 621 | <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> |
| 622 | <li><code>acpi_sleep=s3_bios,s3_mode</code>: Sometimes needed for older machines to enter sleep mode properly</li> |
| 623 | <li><code>SETUPWIZARD=0</code>: This command will skip SetupWizard on boot. (Only needs to be run once!)</li> |
| 624 | <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> |
| 625 | <li><code>DEBUG=1 & DEBUG=2</code>: These enable verbose console debugging, giving another command shell after loading kernel modules, but before Android <code>init</code></li> |
| 626 | <li><code>vga=xxx & 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> |
| 627 | <li><code>HWACCELL=1</code>: This will disable graphics hardware acceleration, enabling rendering through Swiftshader. (Must use this if running headless)</li> |
| 628 | <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> |
| 629 | <li><code>DPI=xxx</code>: This will manually set the DPI on init. Use this if things are too big/small for you.</li> |
| 630 | <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 Park | 5ae1c6c | 2019-08-21 11:08:22 -0700 | [diff] [blame] | 631 | <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 Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 632 | </ul> |
Eric Park | 30fb839 | 2020-02-02 12:23:28 +0900 | [diff] [blame] | 633 | <div class="admonition warning"> |
| 634 | <p class="admonition-title">Warning</p> |
| 635 | <p>The following options can only be used on Android 9/10 builds released after 2020-02-02.</p> |
| 636 | </div> |
| 637 | <ul> |
| 638 | <li><code>HWC=xxx</code>: Define <code>DRM_HWComposer</code> - options include <code>drm</code>, <code>drm_minigbm</code>, and <code>intel</code>.</li> |
| 639 | <li><code>GRALLOC=xxx</code>: Define <code>DRM_Gralloc</code> - options include <code>gbm</code>, <code>minigbm</code>, and <code>intel</code>.</li> |
| 640 | </ul> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 641 | <p>As an example, here are a few of the boot options used in testing:</p> |
| 642 | <pre><code>menuentry 'Bliss-x86 Test-Oreo' --class bliss { |
| 643 | search --file --no-floppy --set=root /AndroidOS/android.boot |
| 644 | linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet sleep.earlysuspend=2 DATA= |
| 645 | initrd /AndroidOS/initrd.img |
| 646 | } |
| 647 | |
| 648 | menuentry 'Bliss-x86 Test-Oreo AUTO_LOAD=old' --class bliss { |
| 649 | search --file --no-floppy --set=root /AndroidOS/android.boot |
| 650 | linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet DATA= AUTO_LOAD=old |
| 651 | initrd /AndroidOS/initrd.img |
| 652 | } |
| 653 | |
| 654 | menuentry 'Bliss-x86 Test-Oreo - SETUP_WIZARD=0' --class bliss { |
| 655 | search --file --no-floppy --set=root /AndroidOS/android.boot |
| 656 | linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive buildvariant=eng SETUPWIZARD=0 quiet DATA= |
| 657 | initrd /AndroidOS/initrd.img |
| 658 | } |
| 659 | |
| 660 | menuentry 'Bliss-x86 Test-Oreo - debug=1' --class bliss { |
| 661 | search --file --no-floppy --set=root /AndroidOS/android.boot |
| 662 | linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=1 |
| 663 | initrd /AndroidOS/initrd.img |
| 664 | } |
| 665 | |
| 666 | menuentry 'Bliss-x86 Test-Oreo - debug=2' --class bliss { |
| 667 | search --file --no-floppy --set=root /AndroidOS/android.boot |
| 668 | linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=2 |
| 669 | initrd /AndroidOS/initrd.img |
| 670 | } |
| 671 | </code></pre> |
| 672 | |
| 673 | |
| 674 | |
| 675 | |
| 676 | |
| 677 | |
| 678 | |
| 679 | |
| 680 | |
| 681 | </article> |
| 682 | </div> |
| 683 | </div> |
| 684 | </main> |
| 685 | |
| 686 | |
| 687 | <footer class="md-footer"> |
| 688 | |
| 689 | <div class="md-footer-nav"> |
| 690 | <nav class="md-footer-nav__inner md-grid"> |
| 691 | |
Eric Park | 0509f65 | 2020-03-01 01:54:39 +0900 | [diff] [blame^] | 692 | <a href="../taking-bug-reports/" title="Taking bug reports" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 693 | <div class="md-flex__cell md-flex__cell--shrink"> |
| 694 | <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> |
| 695 | </div> |
| 696 | <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> |
| 697 | <span class="md-flex__ellipsis"> |
| 698 | <span class="md-footer-nav__direction"> |
| 699 | Previous |
| 700 | </span> |
Eric Park | 0509f65 | 2020-03-01 01:54:39 +0900 | [diff] [blame^] | 701 | Taking bug reports |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 702 | </span> |
| 703 | </div> |
| 704 | </a> |
| 705 | |
| 706 | |
| 707 | <a href="../../BlissRoms/" title="Index" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> |
| 708 | <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> |
| 709 | <span class="md-flex__ellipsis"> |
| 710 | <span class="md-footer-nav__direction"> |
| 711 | Next |
| 712 | </span> |
| 713 | Index |
| 714 | </span> |
| 715 | </div> |
| 716 | <div class="md-flex__cell md-flex__cell--shrink"> |
| 717 | <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> |
| 718 | </div> |
| 719 | </a> |
| 720 | |
| 721 | </nav> |
| 722 | </div> |
| 723 | |
| 724 | <div class="md-footer-meta md-typeset"> |
| 725 | <div class="md-footer-meta__inner md-grid"> |
| 726 | <div class="md-footer-copyright"> |
| 727 | |
| 728 | powered by |
| 729 | <a href="https://www.mkdocs.org">MkDocs</a> |
| 730 | and |
| 731 | <a href="https://squidfunk.github.io/mkdocs-material/"> |
| 732 | Material for MkDocs</a> |
| 733 | </div> |
| 734 | |
| 735 | </div> |
| 736 | </div> |
| 737 | </footer> |
| 738 | |
| 739 | </div> |
| 740 | |
Eric Park | 45174ca | 2019-10-21 01:38:33 +0800 | [diff] [blame] | 741 | <script src="../../assets/javascripts/application.ac79c3b0.js"></script> |
Eric Park | 608ce5a | 2019-08-07 21:27:46 +0800 | [diff] [blame] | 742 | |
| 743 | <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script> |
| 744 | |
| 745 | |
| 746 | </body> |
| 747 | </html> |