A modern Music Player Daemon based on Rockbox open source high quality audio player
libadwaita audio rust zig deno mpris rockbox mpd

xduoox3: Initial manual

TODO:

* Screenshots
* Plugin keymaps

Change-Id: Iaecaa2f585693eb5c2c301bd07aeaa27cdf2588f

+251 -75
+1 -1
apps/keymaps/keymap-xduoox3.c
··· 85 86 /** Bookmark Screen **/ 87 static const struct button_mapping button_context_bmark[] = { 88 - { ACTION_BMS_DELETE, BUTTON_PLAY|BUTTON_REPEAT, BUTTON_PLAY }, 89 90 LAST_ITEM_IN_LIST__NEXTLIST(CONTEXT_LIST) 91 }; /* button_context_bmark */
··· 85 86 /** Bookmark Screen **/ 87 static const struct button_mapping button_context_bmark[] = { 88 + { ACTION_BMS_DELETE, BUTTON_HOME|BUTTON_REPEAT, BUTTON_PLAY }, 89 90 LAST_ITEM_IN_LIST__NEXTLIST(CONTEXT_LIST) 91 }; /* button_context_bmark */
+2 -1
manual/configure_rockbox/display_options.tex
··· 195 \item[Screen Scrolls Out of View.] 196 Screens can be manually scrolled horizontally by pressing 197 \opt{IRIVER_H10_PAD}{Long \ButtonRew/\ButtonFF}% 198 - \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD% 199 ,touchscreen}{% 200 Long \ButtonRight/\ButtonLeft}. 201 Setting this option to \setting{Yes}
··· 195 \item[Screen Scrolls Out of View.] 196 Screens can be manually scrolled horizontally by pressing 197 \opt{IRIVER_H10_PAD}{Long \ButtonRew/\ButtonFF}% 198 + \opt{IRIVER_H10_PAD,XDUOO_X3_PAD}{Long \ButtonPrev/\ButtonNext}% 199 + \nopt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,XDUOO_X3_PAD% 200 ,touchscreen}{% 201 Long \ButtonRight/\ButtonLeft}. 202 Setting this option to \setting{Yes}
+5 -2
manual/configure_rockbox/sound_settings.tex
··· 336 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd} 337 \opt{IRIVER_H10_PAD}{\ButtonScrollUp} 338 \opt{PBELL_VIBE500_PAD}{\ButtonUp} 339 - \opt{MPIO_HD200_PAD}{\ButtonVolUp} 340 \opt{MPIO_HD300_PAD}{\ButtonScrollUp} 341 \opt{touchscreen}{\TouchMidRight} 342 & ··· 354 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack} 355 \opt{IRIVER_H10_PAD}{\ButtonScrollDown} 356 \opt{PBELL_VIBE500_PAD}{\ButtonDown} 357 - \opt{MPIO_HD200_PAD}{\ButtonVolDown} 358 \opt{MPIO_HD300_PAD}{\ButtonScrollDown} 359 \opt{touchscreen}{\TouchMidLeft} 360 & ··· 377 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolUp} 378 \opt{IAUDIO_RC_PAD}{\ButtonRCUp} 379 &} 380 Moves to the previous EQ band. 381 \\ 382 % ··· 392 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolDown} 393 \opt{IAUDIO_RC_PAD}{\ButtonRCDown} 394 &} 395 Moves to the next EQ band. 396 \\ 397 % ··· 432 \opt{GIGABEAT_RC_PAD}{\ButtonRCDsp} 433 \opt{IAUDIO_RC_PAD}{\ButtonRCRec} 434 &} 435 Exits the graphic EQ screen. 436 \\ 437 \end{btnmap}
··· 336 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd} 337 \opt{IRIVER_H10_PAD}{\ButtonScrollUp} 338 \opt{PBELL_VIBE500_PAD}{\ButtonUp} 339 + \opt{MPIO_HD200_PAD,XDUOO_X3_PAD}{\ButtonVolUp} 340 \opt{MPIO_HD300_PAD}{\ButtonScrollUp} 341 \opt{touchscreen}{\TouchMidRight} 342 & ··· 354 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack} 355 \opt{IRIVER_H10_PAD}{\ButtonScrollDown} 356 \opt{PBELL_VIBE500_PAD}{\ButtonDown} 357 + \opt{MPIO_HD200_PAD,XDUOO_X3_PAD}{\ButtonVolDown} 358 \opt{MPIO_HD300_PAD}{\ButtonScrollDown} 359 \opt{touchscreen}{\TouchMidLeft} 360 & ··· 377 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolUp} 378 \opt{IAUDIO_RC_PAD}{\ButtonRCUp} 379 &} 380 + \opt{XDUOO_X3_PAD}{\ButtonPrev} 381 Moves to the previous EQ band. 382 \\ 383 % ··· 393 \opt{GIGABEAT_RC_PAD}{\ButtonRCVolDown} 394 \opt{IAUDIO_RC_PAD}{\ButtonRCDown} 395 &} 396 + \opt{XDUOO_X3_PAD}{\ButtonNext} 397 Moves to the next EQ band. 398 \\ 399 % ··· 434 \opt{GIGABEAT_RC_PAD}{\ButtonRCDsp} 435 \opt{IAUDIO_RC_PAD}{\ButtonRCRec} 436 &} 437 + \opt{XDUOO_X3_PAD}{\ButtonHome} 438 Exits the graphic EQ screen. 439 \\ 440 \end{btnmap}
+20 -4
manual/configure_rockbox/system_options.tex
··· 319 \opt{SANSA_E200_PAD,GIGABEAT_S_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD% 320 ,IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD% 321 ,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD% 322 - ,SAMSUNG_YH820_PAD}{% 323 Switching modes back and forth is done by pressing the 324 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}% 325 \opt{GIGABEAT_S_PAD,SANSA_CLIP_PAD,MROBE100_PAD,IRIVER_H10_PAD,SANSA_FUZEPLUS_PAD}% ··· 334 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonSelect+\ButtonLeft} 335 \opt{PBELL_VIBE500_PAD}{\ButtonOK+\ButtonRight} 336 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRec+\ButtonFF} 337 keys, respectively.% 338 }% 339 \opt{HAVEREMOTEKEYMAP}{ ··· 355 \opt{SANSA_E200_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD} 356 {\ButtonScrollFwd{} / \ButtonScrollBack} 357 \opt{SANSA_FUZEPLUS_PAD}{\ButtonUp{} / \ButtonDown;} 358 - \opt{GIGABEAT_S_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD} 359 {\ButtonVolUp{} / \ButtonVolDown} 360 \opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown} 361 \opt{MROBE100_PAD,PBELL_VIBE500_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD% ··· 375 \opt{IRIVER_H10_PAD}{\ButtonFF} 376 \opt{IRIVER_VIBE500_PAD}{\ButtonMenu} 377 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRight} 378 & 379 \opt{HAVEREMOTEKEYMAP}{ 380 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCFF}% ··· 387 \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD}{\ButtonUp} 388 \opt{IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD% 389 ,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% 390 - ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonPlay} 391 \opt{GIGABEAT_S_PAD}{\ButtonPlay; \ButtonUp} 392 & 393 \opt{HAVEREMOTEKEYMAP}{ ··· 406 {\ButtonMenu; Long \ButtonPlay} 407 \opt{SANSA_FUZEPLUS_PAD}{Long \ButtonPlay} 408 \opt{PBELL_VIBE500_PAD}{\ButtonCancel; Long \ButtonPlay} 409 - \opt{MROBE100_PAD}{\ButtonDisplay; Long {\ButtonPlay}} 410 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonLeft} 411 & 412 \opt{HAVEREMOTEKEYMAP}{ 413 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCPlay}% ··· 423 {\ButtonLeft} 424 \opt{GIGABEAT_RC_PAD}{\ButtonPrev; \ButtonLeft}% 425 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRew} 426 & 427 \opt{HAVEREMOTEKEYMAP}{ 428 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCRew}% ··· 437 {\ButtonRight} 438 \opt{GIGABEAT_RC_PAD}{\ButtonNext; \ButtonRight}% 439 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF} 440 & 441 \opt{HAVEREMOTEKEYMAP}{ 442 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCFF}% ··· 458 \opt{IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD% 459 ,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% 460 ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonPlay} 461 & 462 \opt{HAVEREMOTEKEYMAP}{ 463 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCPlay}% ··· 473 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{Long \ButtonPlay} 474 \opt{MROBE100_PAD}{\ButtonDisplay; Long \ButtonPlay} 475 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRec} 476 & 477 \opt{HAVEREMOTEKEYMAP}{ 478 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{Long \ButtonRCPlay}% ··· 486 {\ButtonLeft} 487 \opt{GIGABEAT_S_PAD}{\ButtonPrev; \ButtonLeft} 488 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRew} 489 & 490 \opt{HAVEREMOTEKEYMAP}{ 491 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCRew}% ··· 499 {\ButtonRight} 500 \opt{GIGABEAT_S_PAD}{\ButtonNext; \ButtonRight} 501 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF} 502 & 503 \opt{HAVEREMOTEKEYMAP}{ 504 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCFF}% ··· 512 {Long \ButtonLeft} 513 \opt{GIGABEAT_S_PAD}{Long \ButtonPrev; Long \ButtonLeft} 514 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonRew} 515 & 516 \opt{HAVEREMOTEKEYMAP}{ 517 \opt{MROBE100_RC_PAD}{Long \ButtonRCRew}% ··· 525 {Long \ButtonRight} 526 \opt{GIGABEAT_S_PAD}{Long \ButtonNext; Long \ButtonRight} 527 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonFF} 528 & 529 \opt{HAVEREMOTEKEYMAP}{ 530 \opt{MROBE100_RC_PAD}{Long \ButtonRCFF}% ··· 540 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD} 541 {\ButtonMenu} 542 \opt{PBELL_VIBE500_PAD}{\ButtonCancel} 543 & 544 \opt{HAVEREMOTEKEYMAP}{ 545 \opt{MROBE100_RC_PAD}{\ButtonRCDisplay}% ··· 555 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD} 556 {Long \ButtonMenu} 557 \opt{PBELL_VIBE500_PAD}{\ButtonMenu} 558 & 559 \opt{HAVEREMOTEKEYMAP}{ 560 \opt{MROBE100_RC_PAD}{Long \ButtonRCDisplay}% ··· 571 \opt{MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD% 572 ,SAMSUNG_YH820_PAD} 573 {\ButtonUp / \ButtonDown} 574 & 575 \opt{HAVEREMOTEKEYMAP}{ 576 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD} ··· 586 \opt{GIGABEAT_S_PAD}{\ButtonSelect; \ButtonBack} 587 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRight} 588 \opt{PBELL_VIBE500_PAD}{\ButtonOK} 589 & 590 \opt{HAVEREMOTEKEYMAP}{ 591 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCFF}% ··· 600 \opt{GIGABEAT_S_PAD}{Long \ButtonSelect; Long \ButtonBack} 601 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonRight} 602 \opt{PBELL_VIBE500_PAD}{Long \ButtonOK} 603 & 604 \opt{HAVEREMOTEKEYMAP}{ 605 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCRew}%
··· 319 \opt{SANSA_E200_PAD,GIGABEAT_S_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD% 320 ,IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD% 321 ,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD% 322 + ,SAMSUNG_YH820_PAD,XDUOO_X3_PAD}{% 323 Switching modes back and forth is done by pressing the 324 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}% 325 \opt{GIGABEAT_S_PAD,SANSA_CLIP_PAD,MROBE100_PAD,IRIVER_H10_PAD,SANSA_FUZEPLUS_PAD}% ··· 334 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonSelect+\ButtonLeft} 335 \opt{PBELL_VIBE500_PAD}{\ButtonOK+\ButtonRight} 336 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRec+\ButtonFF} 337 + \opt{XDUOO_X3_PAD}{\ButtonOption+\ButtonNext{} or \ButtonOption+\ButtonPrev} 338 keys, respectively.% 339 }% 340 \opt{HAVEREMOTEKEYMAP}{ ··· 356 \opt{SANSA_E200_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD} 357 {\ButtonScrollFwd{} / \ButtonScrollBack} 358 \opt{SANSA_FUZEPLUS_PAD}{\ButtonUp{} / \ButtonDown;} 359 + \opt{GIGABEAT_S_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD} 360 {\ButtonVolUp{} / \ButtonVolDown} 361 \opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown} 362 \opt{MROBE100_PAD,PBELL_VIBE500_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD% ··· 376 \opt{IRIVER_H10_PAD}{\ButtonFF} 377 \opt{IRIVER_VIBE500_PAD}{\ButtonMenu} 378 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRight} 379 + \opt{XDUOO_X3_PAD}{\ButtonPower} 380 & 381 \opt{HAVEREMOTEKEYMAP}{ 382 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCFF}% ··· 389 \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD}{\ButtonUp} 390 \opt{IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD% 391 ,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% 392 + ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD,XDUOO_X3_PAD}{\ButtonPlay} 393 \opt{GIGABEAT_S_PAD}{\ButtonPlay; \ButtonUp} 394 & 395 \opt{HAVEREMOTEKEYMAP}{ ··· 408 {\ButtonMenu; Long \ButtonPlay} 409 \opt{SANSA_FUZEPLUS_PAD}{Long \ButtonPlay} 410 \opt{PBELL_VIBE500_PAD}{\ButtonCancel; Long \ButtonPlay} 411 + \opt{MROBE100_PAD}{\ButtonDisplay; Long \ButtonPlay} 412 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonLeft} 413 + \opt{XDUOO_X3_PAD}{\ButtonHome} 414 & 415 \opt{HAVEREMOTEKEYMAP}{ 416 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCPlay}% ··· 426 {\ButtonLeft} 427 \opt{GIGABEAT_RC_PAD}{\ButtonPrev; \ButtonLeft}% 428 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRew} 429 + \opt{XDUOO_X3_PAD}{\ButtonPrev} 430 & 431 \opt{HAVEREMOTEKEYMAP}{ 432 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCRew}% ··· 441 {\ButtonRight} 442 \opt{GIGABEAT_RC_PAD}{\ButtonNext; \ButtonRight}% 443 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF} 444 + \opt{XDUOO_X3_PAD}{\ButtonNext} 445 & 446 \opt{HAVEREMOTEKEYMAP}{ 447 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCFF}% ··· 463 \opt{IRIVER_H10_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD% 464 ,MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD% 465 ,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonPlay} 466 + \opt{XDUOO_X3_PAD}{\ButtonPower}% 467 & 468 \opt{HAVEREMOTEKEYMAP}{ 469 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCPlay}% ··· 479 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{Long \ButtonPlay} 480 \opt{MROBE100_PAD}{\ButtonDisplay; Long \ButtonPlay} 481 \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRec} 482 + \opt{XDUOO_X3_PAD}{\ButtonHome} 483 & 484 \opt{HAVEREMOTEKEYMAP}{ 485 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{Long \ButtonRCPlay}% ··· 493 {\ButtonLeft} 494 \opt{GIGABEAT_S_PAD}{\ButtonPrev; \ButtonLeft} 495 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRew} 496 + \opt{XDUOO_X3_PAD}{\ButtonPrev} 497 & 498 \opt{HAVEREMOTEKEYMAP}{ 499 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCRew}% ··· 507 {\ButtonRight} 508 \opt{GIGABEAT_S_PAD}{\ButtonNext; \ButtonRight} 509 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF} 510 + \opt{XDUOO_X3_PAD}{\ButtonNext} 511 & 512 \opt{HAVEREMOTEKEYMAP}{ 513 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD}{\ButtonRCFF}% ··· 521 {Long \ButtonLeft} 522 \opt{GIGABEAT_S_PAD}{Long \ButtonPrev; Long \ButtonLeft} 523 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonRew} 524 + \opt{XDUOO_X3_PAD}{Long \ButtonPrev} 525 & 526 \opt{HAVEREMOTEKEYMAP}{ 527 \opt{MROBE100_RC_PAD}{Long \ButtonRCRew}% ··· 535 {Long \ButtonRight} 536 \opt{GIGABEAT_S_PAD}{Long \ButtonNext; Long \ButtonRight} 537 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonFF} 538 + \opt{XDUOO_X3_PAD}{Long \ButtonNext} 539 & 540 \opt{HAVEREMOTEKEYMAP}{ 541 \opt{MROBE100_RC_PAD}{Long \ButtonRCFF}% ··· 551 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD} 552 {\ButtonMenu} 553 \opt{PBELL_VIBE500_PAD}{\ButtonCancel} 554 + \opt{XDUOO_X3_PAD}{\ButtonOption} 555 & 556 \opt{HAVEREMOTEKEYMAP}{ 557 \opt{MROBE100_RC_PAD}{\ButtonRCDisplay}% ··· 567 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,MROBE100_PAD} 568 {Long \ButtonMenu} 569 \opt{PBELL_VIBE500_PAD}{\ButtonMenu} 570 + \opt{XDUOO_X3_PAD}{Long \ButtonOption} 571 & 572 \opt{HAVEREMOTEKEYMAP}{ 573 \opt{MROBE100_RC_PAD}{Long \ButtonRCDisplay}% ··· 584 \opt{MROBE100_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD% 585 ,SAMSUNG_YH820_PAD} 586 {\ButtonUp / \ButtonDown} 587 + \opt{XDUOO_X3_PAD}{\ButtonVolUp{} / \ButtonVolDown} 588 & 589 \opt{HAVEREMOTEKEYMAP}{ 590 \opt{GIGABEAT_RC_PAD,MROBE100_RC_PAD} ··· 600 \opt{GIGABEAT_S_PAD}{\ButtonSelect; \ButtonBack} 601 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonRight} 602 \opt{PBELL_VIBE500_PAD}{\ButtonOK} 603 + \opt{XDUOO_X3_PAD}{\ButtonPlay} 604 & 605 \opt{HAVEREMOTEKEYMAP}{ 606 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCFF}% ··· 615 \opt{GIGABEAT_S_PAD}{Long \ButtonSelect; Long \ButtonBack} 616 \opt{IRIVER_H10_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{Long \ButtonRight} 617 \opt{PBELL_VIBE500_PAD}{Long \ButtonOK} 618 + \opt{XDUOO_X3_PAD}{Long \ButtonPlay} 619 & 620 \opt{HAVEREMOTEKEYMAP}{ 621 \opt{GIGABEAT_RC_PAD}{Long \ButtonRCRew}%
+64 -65
manual/getting_started/installation.tex
··· 5 6 \section{Before Starting} 7 8 - \opt{e200}{\fixme{NOTE: These instructions will not work on the 9 - ``Rhapsody'' version of the E200 series (also known as E200R). Please 10 - follow the instructions at 11 \url{http://www.rockbox.org/wiki/SansaE200RInstallation}.}} 12 13 \opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{ 14 - \begin{description} 15 - \item[Supported hardware versions.] 16 \opt{ipodnano,ipodnano2g}{ 17 The \playertype{} is available in multiple versions, not 18 - all of which run Rockbox. Rockbox presently runs only on 19 the first and second generation Ipod Nano. Rockbox does 20 \emph{not} run on the third, fourth or fifth generation Ipod Nano. 21 For information on identifying which Ipod you own, see this page on ··· 23 } 24 \opt{ipodvideo}{ 25 The \playertype{} is the 5th/5.5th generation \playerman{} only. 26 - For information on identifying which Ipod you own, see this page on Apple's 27 website: \url{http://www.info.apple.com/kbnum/n61688}. 28 } 29 \opt{ipod6g}{ ··· 33 } 34 \opt{c200,c200v2,e200,e200v2}{ 35 The \playertype{} is available in multiple versions, and you need to make 36 - sure which you have by checking the Sandisk firmware version number under 37 Settings $\rightarrow$ Info. The v1 firmware is named 01.xx.xx, while the 38 v2 firmware begins with 03. Make sure that you are following the 39 instructions from the correct manual. ··· 97 \end{description} 98 } 99 \opt{iriverh300}{ 100 - \begin{description} 101 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will 102 \emph{permanently} lose the ability to playback files with DRM. 103 \end{description} 104 } 105 106 \opt{sansaAMS,fuzeplus}{ 107 - \begin{description} 108 \item[DRM capability.] It is possible that installation of the bootloader 109 may lead to you \emph{permanently} losing the ability to playback files 110 with DRM. ··· 112 } 113 114 \nopt{gigabeats}{ 115 - \begin{description} 116 117 \nopt{ipod1g2g}{ 118 \item[USB connection.] ··· 121 \item[Firewire connection.] 122 } 123 To transfer Rockbox to your \dap{} you need to 124 - connect it to your computer. For manual installation/uninstallation, or 125 - should autodetection fail during automatic installation, you need to know 126 - where to access the \dap{}. On Windows this means you need to know 127 the drive letter associated with the \dap{}. On Linux you need to know 128 the mount point of your \dap{}. On Mac OS X you need to know the volume 129 name of your \dap{}. ··· 189 } 190 \opt{gigabeatf}{The installation requires you to change a setting in the 191 original firmware. Make sure the option under \setting{Setup 192 - $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to 193 \setting{gigabeat room}. Also, during installation, do not connect your 194 \dap{} using the cradle but plug the USB cable directly to the \dap{}. 195 } ··· 209 } 210 211 \opt{ipod,sansa}{ 212 - \begin{description} 213 \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox 214 requires you to have administrative (Windows) or root (Linux) rights. 215 Consequently when doing either the automatic or manual bootloader install, ··· 279 most of the Rockbox code is contained in a 280 ``build'' that resides on your \daps{} drive. This makes it easy to 281 update Rockbox. The build consists of a directory called 282 - \fname{.rockbox} which contains all of the Rockbox files, and is 283 located in the root of your \daps{} drive. 284 \end{description} 285 } ··· 320 321 When first starting \caps{Rockbox Utility} run ``Autodetect'', 322 found in the configuration dialog (File $\rightarrow$ Configure). Autodetection 323 - can detect most player types. If autodetection fails or is unable to detect 324 the mountpoint, make sure to enter the correct values. The mountpoint indicates 325 the location of the \dap{} in your filesystem. On Windows, this is the drive 326 letter the \dap{} gets assigned, on other systems this is a path in the ··· 333 the bootloader directly. Instead, we have to patch the Iriver firmware 334 with the Rockbox bootloader. 335 336 - Download a supported version of the Iriver firmware for your 337 - \playername{} from the Iriver website, links can be found on 338 \wikilink{IriverBoot}. 339 - 340 - Supported Iriver firmware versions currently include 341 - \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US, 342 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120; 343 H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}. 344 - Likewise, the iHP110 and iHP115 use the same firmware, called 345 - \fname{ihp\_100.hex}. Be sure to use the correct firmware file for 346 your player.} 347 \opt{iriverh300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J, 1.30EU and 1.31K. 348 \note{The US \playername{} firmware is not supported and cannot be ··· 353 \warn{Installing a non-US firmware on a US \playername{} will 354 \emph{permanently} remove DRM support from the player.}} 355 356 - If the file that you downloaded is a \fname{.zip} file, use an unzip 357 utility like mentioned in the prerequisites section to extract 358 the \fname{.hex} from the \fname{.zip} file 359 - to your desktop. Likewise, if the file that you downloaded is an 360 - \fname{.exe} file, double-click on the \fname{.exe} file to extract 361 the \fname{.hex} file to your desktop. 362 When running Linux you should be able to extract \fname{.exe} 363 files using \fname{unzip}. ··· 369 the bootloader directly. Instead, we have to patch the MPIO firmware 370 with the Rockbox bootloader. 371 372 - Download a supported version of the MPIO firmware for your 373 - \playername{} from the MPIO website, links can be found on 374 \opt{mpiohd200}{\wikilink{MPIOHD200Port}}% 375 \opt{mpiohd300}{\wikilink{MPIOHD300Port}}. 376 ··· 420 \item[Release.] The release version is the latest stable release, free 421 of known critical bugs. For a manual install, the current stable release of Rockbox is 422 available at \url{http://www.rockbox.org/download/}. 423 - 424 \item[Development Build.] The development build is built at each change to 425 the Rockbox source code repository and represents the current state of Rockbox 426 development. This means that the build could contain bugs but most of 427 - the time is safe to use. For a manual install, you can download the current build from 428 \url{http://build.rockbox.org/}. 429 430 \item[Archived Build.] In addition to the release version and the current build, ··· 434 435 \end{description} 436 437 - \note{Because current and archived builds are development versions that 438 - change frequently, they may behave differently than described in this manual, 439 or they may introduce new (and potentially annoying) bugs. Unless you wish to 440 try the latest and greatest features at the price of possibly greater instability, 441 or you wish to help with development, you should stick with the release.\\*} ··· 461 the main data partition. Rockbox \emph{must} be installed onto the main 462 data partition.}} 463 464 - \begin{enumerate} 465 \item Download your chosen version of Rockbox from the links in the 466 previous section. 467 468 - \item Connect your \dap{} to the computer via USB 469 \opt{sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus,samsungyh} 470 { in MSC mode } 471 \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire }as described in 472 the manual that came with your \dap{}. 473 474 \item Take the \fname{.zip} file that you downloaded and use 475 - the ``Extract all'' command of your unzip program to extract 476 the files onto 477 \opt{gigabeats,fuzeplus}{the main data partition of } 478 \opt{cowond2}{either an SD card or the internal memory of } ··· 482 will not be possible to save settings.}} 483 \end{enumerate} 484 485 - \note{The entire contents of the \fname{.zip} file should be extracted 486 directly to the root of your \daps{} drive. Do not try to 487 create a separate directory on your \dap{} for the Rockbox 488 files! The \fname{.zip} file already contains the internal ··· 490 491 % This has nothing to do with swcodec, just that these players need our own 492 % bootloader so we can decide where we want the main binary. 493 - \opt{swcodec}{ 494 - If the contents of the \fname{.zip} file are extracted correctly, you will 495 - have a directory called \fname{.rockbox}, which contains all the files needed 496 - by Rockbox, in the main directory of your \daps{} drive. 497 - } 498 499 \opt{swcodec}{% 500 \nopt{gigabeats}{% ··· 517 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}} 518 \opt{IMX233}{\input{getting_started/IMX233_install.tex}} 519 \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}} 520 } 521 } 522 523 \subsection{Finishing the install}\label{ref:finish_install} 524 525 \opt{gigabeatf}{ 526 - After installing you \emph{need} to power-cycle the 527 \dap{} by doing the following steps. Failure to do so may result in problems. 528 \begin{itemize} 529 \item Safely eject / unmount your \dap{} and unplug the USB cable. 530 \item Unplug any power adapter. 531 \item Hold the \ButtonPower{} button to turn off the \dap{}. 532 - \item Slide the battery switch located on the bottom of the \dap{} from 533 `on' to `off'. 534 \item Slide the battery switch back from `off' to `on'. 535 \end{itemize} 536 } 537 538 \opt{iaudiom3,iaudiom5,iaudiox5}{ 539 - After installing you \emph{need} to power-cycle the 540 \dap{} by doing the following steps. 541 \begin{itemize} 542 \item Safely eject / unmount your \dap{} and unplug the USB cable. 543 \item Hold the 544 \opt{IAUDIO_X5_PAD}{\ButtonPower} 545 \opt{IAUDIO_M3_PAD}{\ButtonPlay} 546 - button to turn off the \dap{}. 547 \item Insert the charger. The Rockbox bootloader will automatically be flashed. 548 \end{itemize} 549 } ··· 564 \opt{iriverh100,iriverh300}{ 565 \begin{itemize} 566 \item Safely eject / unmount your \dap{}. 567 - 568 \item \warn{Before proceeding further, make sure that your player has a full charge 569 or that it is connected to the power adapter. Interrupting the next step 570 due to a power failure most likely will brick your \dap{}.} 571 Update your \daps{} firmware with the patched bootloader. To do this, turn 572 the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu, 573 and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select 574 - \setting{Yes} when asked to confirm if you want to upgrade the 575 firmware. The \playerman{} will display a message indicating that the 576 firmware update is in progress. Do \emph{not} interrupt this process. When the 577 firmware update is complete the player will turn itself off. (The update ··· 618 \index{Speech}\index{Installation!Optional Steps} 619 If you wish to use speech support you will also need a voice file. Voice files 620 allow Rockbox to speak the user interface to you. Rockbox Utility can install 621 - an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml} 622 and unzip it to the root of your \dap{}. 623 Rockbox Utility can also aid you in the creation of voice files with different voices 624 or in other languages if you have a suitable speech engine installed on your computer. ··· 642 \note{ 643 If you have loaded music onto your \dap{} using the \playerman{} 644 firmware, you will not be able to see your music properly in the 645 - \setting{File Browser} as MTP mode changes the location and file names. 646 Files placed on your \dap{} using the \playerman{} firmware can be 647 viewed by initialising and using Rockbox's database. 648 See \reference{ref:database} for more information.} ··· 659 660 \opt{ipod}{ 661 \note{ 662 - If you have loaded music onto your \dap{} using Itunes, 663 - you will not be able to see your music properly in the \setting{File Browser}. 664 - This is because Itunes changes your files' names and hides them in 665 - directories in the \fname{Ipod\_Control} directory. Files placed on your 666 \dap{} using Itunes can be viewed by initialising and using Rockbox's database. 667 See \reference{ref:database} for more information. 668 } ··· 697 \section{Uninstalling Rockbox}\index{Installation!uninstall} 698 699 \nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus}{ 700 - \note{The Rockbox bootloader allows you to choose between Rockbox and 701 the original firmware. (See \reference{ref:Dualboot} for more information.)} 702 } 703 ··· 735 736 \optv{ipod}{ 737 To uninstall Rockbox and go back to using just the original Ipod software, connect 738 - the \dap{} to your computer and follow the instructions to install 739 - the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall 740 instead of \texttt{i} for install. 741 } 742 ··· 766 } 767 768 \opt{sansaAMS,fuzeplus}{ 769 - Copy an unmodified original firmware to your player, and then reboot into 770 the Sandisk firmware. See \reference{ref:Dualboot} for more information. 771 } 772 ··· 803 \end{itemize} 804 805 \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe} 806 - directly to restore your \dap{}. This will format your \dap{}, 807 removing all files.} 808 } 809 810 \section{Troubleshooting} 811 - \begin{description} 812 \opt{sansa,ipod}{ 813 \item[Bootloader install problems] 814 If you have trouble installing the bootloader, ··· 836 \opt{iriverh100,iriverh300,mpiohd200}{\item[``-1 error'']} 837 If you receive a 838 \nopt{iriverh100,iriverh300,mpiohd200}{``File Not Found''} 839 - \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''} 840 - from the bootloader, then the bootloader cannot find the Rockbox firmware. 841 - This is usually a result of not extracting the contents of the \fname{.zip} 842 file to the proper location, and should not happen when Rockbox has been 843 installed with Rockbox Utility. 844 ··· 859 mkdosfs -f 2 -F 32 -S 512 -s 64 -v -n TFAT /path/to/partition/device 860 \end{code} 861 \warn{This will remove all your files.} 862 - 863 \item Copying a \fname{tar}. If you have a Rockbox build environment 864 then you can try generating \fname{rockbox.tar} instead of 865 \fname{rockbox.zip} as follows:
··· 5 6 \section{Before Starting} 7 8 + \opt{e200}{\fixme{NOTE: These instructions will not work on the 9 + ``Rhapsody'' version of the E200 series (also known as E200R). Please 10 + follow the instructions at 11 \url{http://www.rockbox.org/wiki/SansaE200RInstallation}.}} 12 13 \opt{ipodnano,ipodnano2g,ipodvideo,ipod6g,e200,c200,c200v2,e200v2,clipv1,clipv2,cowond2,fuze,fuzev2}{ 14 + \begin{description} 15 + \item[Supported hardware versions.] 16 \opt{ipodnano,ipodnano2g}{ 17 The \playertype{} is available in multiple versions, not 18 + all of which run Rockbox. Rockbox presently runs only on 19 the first and second generation Ipod Nano. Rockbox does 20 \emph{not} run on the third, fourth or fifth generation Ipod Nano. 21 For information on identifying which Ipod you own, see this page on ··· 23 } 24 \opt{ipodvideo}{ 25 The \playertype{} is the 5th/5.5th generation \playerman{} only. 26 + For information on identifying which Ipod you own, see this page on Apple's 27 website: \url{http://www.info.apple.com/kbnum/n61688}. 28 } 29 \opt{ipod6g}{ ··· 33 } 34 \opt{c200,c200v2,e200,e200v2}{ 35 The \playertype{} is available in multiple versions, and you need to make 36 + sure which you have by checking the Sandisk firmware version number under 37 Settings $\rightarrow$ Info. The v1 firmware is named 01.xx.xx, while the 38 v2 firmware begins with 03. Make sure that you are following the 39 instructions from the correct manual. ··· 97 \end{description} 98 } 99 \opt{iriverh300}{ 100 + \begin{description} 101 \item[DRM capability.] If your \dap{} has a US firmware, then by installing Rockbox you will 102 \emph{permanently} lose the ability to playback files with DRM. 103 \end{description} 104 } 105 106 \opt{sansaAMS,fuzeplus}{ 107 + \begin{description} 108 \item[DRM capability.] It is possible that installation of the bootloader 109 may lead to you \emph{permanently} losing the ability to playback files 110 with DRM. ··· 112 } 113 114 \nopt{gigabeats}{ 115 + \begin{description} 116 117 \nopt{ipod1g2g}{ 118 \item[USB connection.] ··· 121 \item[Firewire connection.] 122 } 123 To transfer Rockbox to your \dap{} you need to 124 + connect it to your computer. For manual installation/uninstallation, or 125 + should autodetection fail during automatic installation, you need to know 126 + where to access the \dap{}. On Windows this means you need to know 127 the drive letter associated with the \dap{}. On Linux you need to know 128 the mount point of your \dap{}. On Mac OS X you need to know the volume 129 name of your \dap{}. ··· 189 } 190 \opt{gigabeatf}{The installation requires you to change a setting in the 191 original firmware. Make sure the option under \setting{Setup 192 + $\rightarrow$ Connections $\rightarrow$ PC Connections} is set to 193 \setting{gigabeat room}. Also, during installation, do not connect your 194 \dap{} using the cradle but plug the USB cable directly to the \dap{}. 195 } ··· 209 } 210 211 \opt{ipod,sansa}{ 212 + \begin{description} 213 \item[Administrator/Root rights.] Installing the bootloader portion of Rockbox 214 requires you to have administrative (Windows) or root (Linux) rights. 215 Consequently when doing either the automatic or manual bootloader install, ··· 279 most of the Rockbox code is contained in a 280 ``build'' that resides on your \daps{} drive. This makes it easy to 281 update Rockbox. The build consists of a directory called 282 + \fname{.rockbox} which contains all of the Rockbox files, and is 283 located in the root of your \daps{} drive. 284 \end{description} 285 } ··· 320 321 When first starting \caps{Rockbox Utility} run ``Autodetect'', 322 found in the configuration dialog (File $\rightarrow$ Configure). Autodetection 323 + can detect most player types. If autodetection fails or is unable to detect 324 the mountpoint, make sure to enter the correct values. The mountpoint indicates 325 the location of the \dap{} in your filesystem. On Windows, this is the drive 326 letter the \dap{} gets assigned, on other systems this is a path in the ··· 333 the bootloader directly. Instead, we have to patch the Iriver firmware 334 with the Rockbox bootloader. 335 336 + Download a supported version of the Iriver firmware for your 337 + \playername{} from the Iriver website, links can be found on 338 \wikilink{IriverBoot}. 339 + 340 + Supported Iriver firmware versions currently include 341 + \opt{iriverh100}{1.63US, 1.63EU, 1.63K, 1.65US, 1.65EU, 1.65K, 1.66US, 342 1.66EU and 1.66K. Note that the H140 uses the same firmware as the H120; 343 H120 and H140 owners should use the firmware called \fname{ihp\_120.hex}. 344 + Likewise, the iHP110 and iHP115 use the same firmware, called 345 + \fname{ihp\_100.hex}. Be sure to use the correct firmware file for 346 your player.} 347 \opt{iriverh300}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J, 1.30EU and 1.31K. 348 \note{The US \playername{} firmware is not supported and cannot be ··· 353 \warn{Installing a non-US firmware on a US \playername{} will 354 \emph{permanently} remove DRM support from the player.}} 355 356 + If the file that you downloaded is a \fname{.zip} file, use an unzip 357 utility like mentioned in the prerequisites section to extract 358 the \fname{.hex} from the \fname{.zip} file 359 + to your desktop. Likewise, if the file that you downloaded is an 360 + \fname{.exe} file, double-click on the \fname{.exe} file to extract 361 the \fname{.hex} file to your desktop. 362 When running Linux you should be able to extract \fname{.exe} 363 files using \fname{unzip}. ··· 369 the bootloader directly. Instead, we have to patch the MPIO firmware 370 with the Rockbox bootloader. 371 372 + Download a supported version of the MPIO firmware for your 373 + \playername{} from the MPIO website, links can be found on 374 \opt{mpiohd200}{\wikilink{MPIOHD200Port}}% 375 \opt{mpiohd300}{\wikilink{MPIOHD300Port}}. 376 ··· 420 \item[Release.] The release version is the latest stable release, free 421 of known critical bugs. For a manual install, the current stable release of Rockbox is 422 available at \url{http://www.rockbox.org/download/}. 423 + 424 \item[Development Build.] The development build is built at each change to 425 the Rockbox source code repository and represents the current state of Rockbox 426 development. This means that the build could contain bugs but most of 427 + the time is safe to use. For a manual install, you can download the current build from 428 \url{http://build.rockbox.org/}. 429 430 \item[Archived Build.] In addition to the release version and the current build, ··· 434 435 \end{description} 436 437 + \note{Because current and archived builds are development versions that 438 + change frequently, they may behave differently than described in this manual, 439 or they may introduce new (and potentially annoying) bugs. Unless you wish to 440 try the latest and greatest features at the price of possibly greater instability, 441 or you wish to help with development, you should stick with the release.\\*} ··· 461 the main data partition. Rockbox \emph{must} be installed onto the main 462 data partition.}} 463 464 + \begin{enumerate} 465 \item Download your chosen version of Rockbox from the links in the 466 previous section. 467 468 + \item Connect your \dap{} to the computer via USB 469 \opt{sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus,samsungyh} 470 { in MSC mode } 471 \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire }as described in 472 the manual that came with your \dap{}. 473 474 \item Take the \fname{.zip} file that you downloaded and use 475 + the ``Extract all'' command of your unzip program to extract 476 the files onto 477 \opt{gigabeats,fuzeplus}{the main data partition of } 478 \opt{cowond2}{either an SD card or the internal memory of } ··· 482 will not be possible to save settings.}} 483 \end{enumerate} 484 485 + \note{The entire contents of the \fname{.zip} file should be extracted 486 directly to the root of your \daps{} drive. Do not try to 487 create a separate directory on your \dap{} for the Rockbox 488 files! The \fname{.zip} file already contains the internal ··· 490 491 % This has nothing to do with swcodec, just that these players need our own 492 % bootloader so we can decide where we want the main binary. 493 + If the contents of the \fname{.zip} file are extracted correctly, you will 494 + have a directory called \fname{.rockbox}, which contains all the files needed 495 + by Rockbox, in the main directory of your \daps{} drive. 496 497 \opt{swcodec}{% 498 \nopt{gigabeats}{% ··· 515 \opt{ondavx777}{\input{getting_started/ondavx777_install.tex}} 516 \opt{IMX233}{\input{getting_started/IMX233_install.tex}} 517 \opt{samsungyh}{\input{getting_started/samsungyh_install.tex}} 518 + \opt{xduoox3}{\input{getting_started/xduoox3_install.tex}} 519 } 520 } 521 522 \subsection{Finishing the install}\label{ref:finish_install} 523 524 \opt{gigabeatf}{ 525 + After installing you \emph{need} to power-cycle the 526 \dap{} by doing the following steps. Failure to do so may result in problems. 527 \begin{itemize} 528 \item Safely eject / unmount your \dap{} and unplug the USB cable. 529 \item Unplug any power adapter. 530 \item Hold the \ButtonPower{} button to turn off the \dap{}. 531 + \item Slide the battery switch located on the bottom of the \dap{} from 532 `on' to `off'. 533 \item Slide the battery switch back from `off' to `on'. 534 \end{itemize} 535 } 536 537 \opt{iaudiom3,iaudiom5,iaudiox5}{ 538 + After installing you \emph{need} to power-cycle the 539 \dap{} by doing the following steps. 540 \begin{itemize} 541 \item Safely eject / unmount your \dap{} and unplug the USB cable. 542 \item Hold the 543 \opt{IAUDIO_X5_PAD}{\ButtonPower} 544 \opt{IAUDIO_M3_PAD}{\ButtonPlay} 545 + button to turn off the \dap{}. 546 \item Insert the charger. The Rockbox bootloader will automatically be flashed. 547 \end{itemize} 548 } ··· 563 \opt{iriverh100,iriverh300}{ 564 \begin{itemize} 565 \item Safely eject / unmount your \dap{}. 566 + 567 \item \warn{Before proceeding further, make sure that your player has a full charge 568 or that it is connected to the power adapter. Interrupting the next step 569 due to a power failure most likely will brick your \dap{}.} 570 Update your \daps{} firmware with the patched bootloader. To do this, turn 571 the jukebox on. Press and hold the \ButtonSelect{} button to enter the main menu, 572 and navigate to \setting{General $\rightarrow$ Firmware Upgrade}. Select 573 + \setting{Yes} when asked to confirm if you want to upgrade the 574 firmware. The \playerman{} will display a message indicating that the 575 firmware update is in progress. Do \emph{not} interrupt this process. When the 576 firmware update is complete the player will turn itself off. (The update ··· 617 \index{Speech}\index{Installation!Optional Steps} 618 If you wish to use speech support you will also need a voice file. Voice files 619 allow Rockbox to speak the user interface to you. Rockbox Utility can install 620 + an English voice file, or you can download it from \url{http://www.rockbox.org/daily.shtml} 621 and unzip it to the root of your \dap{}. 622 Rockbox Utility can also aid you in the creation of voice files with different voices 623 or in other languages if you have a suitable speech engine installed on your computer. ··· 641 \note{ 642 If you have loaded music onto your \dap{} using the \playerman{} 643 firmware, you will not be able to see your music properly in the 644 + \setting{File Browser} as MTP mode changes the location and file names. 645 Files placed on your \dap{} using the \playerman{} firmware can be 646 viewed by initialising and using Rockbox's database. 647 See \reference{ref:database} for more information.} ··· 658 659 \opt{ipod}{ 660 \note{ 661 + If you have loaded music onto your \dap{} using Itunes, 662 + you will not be able to see your music properly in the \setting{File Browser}. 663 + This is because Itunes changes your files' names and hides them in 664 + directories in the \fname{Ipod\_Control} directory. Files placed on your 665 \dap{} using Itunes can be viewed by initialising and using Rockbox's database. 666 See \reference{ref:database} for more information. 667 } ··· 696 \section{Uninstalling Rockbox}\index{Installation!uninstall} 697 698 \nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus}{ 699 + \note{The Rockbox bootloader allows you to choose between Rockbox and 700 the original firmware. (See \reference{ref:Dualboot} for more information.)} 701 } 702 ··· 734 735 \optv{ipod}{ 736 To uninstall Rockbox and go back to using just the original Ipod software, connect 737 + the \dap{} to your computer and follow the instructions to install 738 + the bootloader but, when prompted by ipodpatcher, enter \texttt{u} for uninstall 739 instead of \texttt{i} for install. 740 } 741 ··· 765 } 766 767 \opt{sansaAMS,fuzeplus}{ 768 + Copy an unmodified original firmware to your player, and then reboot into 769 the Sandisk firmware. See \reference{ref:Dualboot} for more information. 770 } 771 ··· 802 \end{itemize} 803 804 \note{From Windows, you can also run \fname{gbs\_update\_1\_2\_us.exe} 805 + directly to restore your \dap{}. This will format your \dap{}, 806 removing all files.} 807 } 808 809 \section{Troubleshooting} 810 + \begin{description} 811 \opt{sansa,ipod}{ 812 \item[Bootloader install problems] 813 If you have trouble installing the bootloader, ··· 835 \opt{iriverh100,iriverh300,mpiohd200}{\item[``-1 error'']} 836 If you receive a 837 \nopt{iriverh100,iriverh300,mpiohd200}{``File Not Found''} 838 + \opt{iriverh100,iriverh300,mpiohd200}{``-1 error''} 839 + from the bootloader, then the bootloader cannot find the Rockbox firmware. 840 + This is usually a result of not extracting the contents of the \fname{.zip} 841 file to the proper location, and should not happen when Rockbox has been 842 installed with Rockbox Utility. 843 ··· 858 mkdosfs -f 2 -F 32 -S 512 -s 64 -v -n TFAT /path/to/partition/device 859 \end{code} 860 \warn{This will remove all your files.} 861 + 862 \item Copying a \fname{tar}. If you have a Rockbox build environment 863 then you can try generating \fname{rockbox.tar} instead of 864 \fname{rockbox.zip} as follows:
+28
manual/getting_started/xduoox3_install.tex
···
··· 1 + Installing the bootloader is the trickiest part of the installation. 2 + We cannot distribute the bootloader directly, and thus need to patch a compatible 3 + version of the xDuoo firmware. 4 + 5 + \begin{enumerate} 6 + 7 + \item Download the Rockbox bootloader from 8 + \url{http://download.rockbox.org/bootloader/xduoo/X3-v11.bsdiff} 9 + 10 + \item Get a copy of the original \playertype{} v1.1 firmware from 11 + \url{https://www.xduoo.net/firmware-download/} and extract the .rar file to obtain the 12 + update image (called \fname{update.zip}). 13 + 14 + \item Compile bspatch in rbutil/bspatch/ (run make in the dir). 15 + 16 + \item Run 17 + \begin{code} 18 + ../rbutil/bspatch/bspatch update.zip output.zip X3-v11.bsdiff 19 + \end{code} 20 + 21 + \item Put \fname{output.zip} in the root of the SD card and rename it to \fname{update.zip}. 22 + 23 + \item Disconnect the player from USB and let the original firmware boot. 24 + 25 + \item Go into the 'Setting' menu, and select 'Upgrade'. The player will reboot into Rockbox 26 + upon completion. 27 + 28 + \end{enumerate}
+103
manual/platform/keymap-xduoox3.tex
···
··· 1 + % $Id$ 2 + 3 + \newcommand{\ButtonPrev}{\btnfnt{Prev}} 4 + \newcommand{\ButtonNext}{\btnfnt{Next}} 5 + \newcommand{\ButtonHome}{\btnfnt{Home}} 6 + \newcommand{\ButtonOption}{\btnfnt{Option}} 7 + \newcommand{\ButtonPlay}{\btnfnt{Play}} 8 + \newcommand{\ButtonPower}{\btnfnt{Power}} 9 + \newcommand{\ButtonVolDown}{\btnfnt{Volume Down}} 10 + \newcommand{\ButtonVolUp}{\btnfnt{Volume Up}} 11 + \newcommand{\ButtonHold}{\btnfnt{Hold}} 12 + 13 + %Button actions, standard context 14 + \newcommand{\ActionStdPrev}{\ButtonPrev} 15 + \newcommand{\ActionStdPrevRepeat}{Long \ButtonPrev} 16 + \newcommand{\ActionStdNext}{\ButtonNext} 17 + \newcommand{\ActionStdNextRepeat}{Long \ButtonNext} 18 + \newcommand{\ActionStdContext}{Long \ButtonPlay} 19 + \newcommand{\ActionStdCancel}{\ButtonHome} 20 + \newcommand{\ActionStdOk}{\ButtonPlay} 21 + \newcommand{\ActionStdMenu}{\ButtonOption} 22 + \newcommand{\ActionStdQuickScreen}{Long \ButtonOption} 23 + \newcommand{\ActionQuickScreenExit}{\ButtonPlay{} or \ButtonHome} 24 + \newcommand{\ActionStdUsbCharge}{\ButtonPlay} 25 + 26 + %Button actions, wps context 27 + \newcommand{\ActionWpsPlay}{\ButtonPlay} 28 + \newcommand{\ActionWpsStop}{\ButtonPower} 29 + 30 + \newcommand{\ActionWpsSkipNext}{\ButtonNext} 31 + \newcommand{\ActionWpsSkipPrev}{\ButtonPrev} 32 + \newcommand{\ActionWpsSeekBack}{Long \ButtonPrev} 33 + \newcommand{\ActionWpsSeekFwd}{Long \ButtonNext} 34 + 35 + \newcommand{\ActionWpsVolDown}{\ButtonVolDown} 36 + \newcommand{\ActionWpsVolUp}{\ButtonVolUp} 37 + 38 + \newcommand{\ActionWpsBrowse}{\ButtonHome} 39 + \newcommand{\ActionWpsContext}{Long \ButtonPlay} 40 + \newcommand{\ActionWpsMenu}{\ButtonOption} 41 + \newcommand{\ActionWpsHotkey}{\ButtonHome} 42 + 43 + \newcommand{\ActionWpsAbSetBNextDir}{\ButtonPower{} + \ButtonNext} 44 + \newcommand{\ActionWpsAbSetAPrevDir}{\ButtonPower{} + \ButtonNext} 45 + 46 + \newcommand{\ActionWpsQuickScreen}{} 47 + \newcommand{\ActionWpsAbReset}{} 48 + 49 + %Button actions, tree context 50 + \newcommand{\ActionTreeWps}{\ButtonPower} 51 + \newcommand{\ActionTreeStop}{Long \ButtonPower} 52 + \newcommand{\ActionTreeEnter}{\ButtonPlay} 53 + \newcommand{\ActionTreeParentDirectory}{\ButtonHome} 54 + \newcommand{\ActionTreeHotkey}{Long \ButtonHome} 55 + 56 + %Button actions, YesNo context 57 + \newcommand{\ActionYesNoAccept}{\ButtonPlay} 58 + 59 + %Button actions, Setting context 60 + \newcommand{\ActionSettingInc}{\ButtonVolUp} 61 + \newcommand{\ActionSettingDec}{\ButtonVolDown} 62 + 63 + %Button actions, Virtual Keyboard Context 64 + \newcommand{\ActionKbdLeft}{\ButtonPrev} 65 + \newcommand{\ActionKbdRight}{\ButtonNext} 66 + \newcommand{\ActionKbdDown}{\ButtonOption} 67 + \newcommand{\ActionKbdUp}{\ButtonHome} 68 + \newcommand{\ActionKbdCursorLeft}{\ButtonVolUp} 69 + \newcommand{\ActionKbdCursorRight}{\ButtonVolDown} 70 + \newcommand{\ActionKbdBackSpace}{\ButtonHome} 71 + \newcommand{\ActionKbdSelect}{\ButtonPlay} 72 + \newcommand{\ActionKbdDone}{Long \ButtonPlay} 73 + \newcommand{\ActionKbdAbort}{\ButtonPower} 74 + 75 + \newcommand{\ActionKbdPageFlip}{} 76 + 77 + %Button actions, Pitch Screen context 78 + \newcommand{\ActionPsIncSmall}{\ButtonVolUp} 79 + \newcommand{\ActionPsIncBig}{Long \ButtonVolUp} 80 + \newcommand{\ActionPsDecSmall}{\ButtonVolDown} 81 + \newcommand{\ActionPsDecBig}{Long \ButtonVolDown} 82 + \newcommand{\ActionPsNudgeLeft}{\ButtonNext} 83 + \newcommand{\ActionPsNudgeRight}{\ButtonPrev} 84 + \newcommand{\ActionPsToggleMode}{\ButtonPlay} 85 + \newcommand{\ActionPsReset}{\ButtonPower} 86 + \newcommand{\ActionPsExit}{\ButtonHome} 87 + 88 + %Button actions, Bookmark screen context 89 + \newcommand{\ActionBmDelete}{Long \ButtonHome} 90 + 91 + %Plugin lib actions 92 + \newcommand{\PluginUp}{\ButtonHome} 93 + \newcommand{\PluginDown}{\ButtonOption} 94 + \newcommand{\PluginLeft}{\ButtonPrev} 95 + \newcommand{\PluginRight}{\ButtonNext} 96 + \newcommand{\PluginUpRepeat}{Long \ButtonHome} 97 + \newcommand{\PluginDownRepeat}{Long \ButtonOption} 98 + \newcommand{\PluginLeftRepeat}{Long \ButtonPrev} 99 + \newcommand{\PluginRightRepeat}{Long \ButtonNext} 100 + \newcommand{\PluginCancel}{\ButtonPower} 101 + \newcommand{\PluginExit}{Long \ButtonPower} 102 + \newcommand{\PluginSelect}{\ButtonPlay} 103 + \newcommand{\PluginSelectRepeat}{Long \ButtonPlay}
+26
manual/platform/xduoox3.tex
···
··· 1 + % Id: % 2 + \def\UseOption{xduoox3} 3 + \edef\UseOption{\UseOption,XDUOO_X3_PAD} 4 + \edef\UseOption{\UseOption,HAVE_BACKLIGHT} 5 + \edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH} 6 + 7 + \newcommand{\playerman}{xDuoo} 8 + \newcommand{\playertype}{X3} 9 + \newcommand{\playerlongtype}{\playertype} 10 + \newcommand{\dapdisplaywidth}{128} 11 + \newcommand{\dapdisplayheight}{64} 12 + \newcommand{\dapdisplaydepth}{1} 13 + \newcommand{\specimg}{xduoox3} 14 + %used for specifying screenshot names common to a target "family" 15 + \newcommand{\seriesimg}{xduoox3} 16 + %Used to name the player, e.g. ...to the \dap 17 + \newcommand{\dap}{player} 18 + %For use when referring to the player. E.g. the \daps\ capacity... 19 + \newcommand{\daps}{player's} 20 + \newcommand{\firmwarefilename}{\fname{update.zip}} 21 + \newcommand{\firmwareextension}{\fname{zip}} 22 + \newcommand{\screenshotsize}{3cm} 23 + \newcommand{\disk}{SD card} 24 + 25 + % link external keymap file 26 + \input{platform/keymap-xduoox3.tex}
manual/rockbox_interface/images/xduoox3-front.png

This is a binary file and will not be displayed.

+2 -2
manual/rockbox_interface/main.tex
··· 516 \opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}% 517 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,ONDA_VX777_PAD% 518 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD% 519 - ,SANSA_FUZEPLUS_PAD% 520 }{\ButtonPower}% 521 \opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}% 522 \opt{ONDA_VX777_PAD} {\ButtonPower{}}% ··· 534 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{Long \ButtonPlay}% 535 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD% 536 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD% 537 - ,PBELL_VIBE500_PAD,ONDA_VX777_PAD,SANSA_FUZEPLUS_PAD% 538 }{Long \ButtonPower}% 539 & 540 \opt{HAVEREMOTEKEYMAP}{
··· 516 \opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}% 517 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,ONDA_VX777_PAD% 518 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD% 519 + ,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD% 520 }{\ButtonPower}% 521 \opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}% 522 \opt{ONDA_VX777_PAD} {\ButtonPower{}}% ··· 534 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{Long \ButtonPlay}% 535 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD% 536 ,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD% 537 + ,PBELL_VIBE500_PAD,ONDA_VX777_PAD,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD% 538 }{Long \ButtonPower}% 539 & 540 \opt{HAVEREMOTEKEYMAP}{