diff options
-rw-r--r-- | documentation/bsp-guide/bsp.xml | 59 |
1 files changed, 34 insertions, 25 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml index 076c08cf60..ea9b0017f3 100644 --- a/documentation/bsp-guide/bsp.xml +++ b/documentation/bsp-guide/bsp.xml | |||
@@ -533,19 +533,22 @@ FILESEXTRAPATHS := "${THISDIR}/${PN}" | |||
533 | </para> | 533 | </para> |
534 | 534 | ||
535 | <para> | 535 | <para> |
536 | For cases where you can substitute something and still maintain functionality, the Poky website will make | 536 | For cases where you can substitute something and still maintain functionality, |
537 | available a 'de-featured' BSP completely free of the encumbered IP. | 537 | the Yocto Project website at |
538 | In that case you can use the substitution directly and without any further licensing requirements. | 538 | <ulink url='http://yoctoproject.org/download/board-support-package-bsp-downloads'></ulink> |
539 | If present, this fully 'de-featured' BSP will be named meta-<bsp_name> (i.e. the | 539 | will make available a 'de-featured' BSP completely free of the encumbered IP. |
540 | normal default naming convention). | 540 | In that case you can use the substitution directly and without any further licensing |
541 | If available, this is the simplest the most preferred option. | 541 | requirements. |
542 | If present, this fully 'de-featured' BSP will be named appropiately different | ||
543 | than the normal encumbered BSP. | ||
544 | If available, this substitution is the simplest and most preferred option. | ||
542 | This, of course, assumes the resulting functionality meets requirements. | 545 | This, of course, assumes the resulting functionality meets requirements. |
543 | </para> | 546 | </para> |
544 | 547 | ||
545 | <para> | 548 | <para> |
546 | If however, a non-encumbered version is unavailable or the 'free' version would provide unsuitable | 549 | If however, a non-encumbered version is unavailable or the 'free' version |
547 | functionality or quality, an encumbered version can be used. | 550 | would provide unsuitable functionality or quality, you can use |
548 | Encumbered versions of a BSP are given names of the form meta-<bsp_name>-nonfree. | 551 | an encumbered version. |
549 | </para> | 552 | </para> |
550 | 553 | ||
551 | <para> | 554 | <para> |
@@ -559,14 +562,23 @@ FILESEXTRAPATHS := "${THISDIR}/${PN}" | |||
559 | 562 | ||
560 | <para> | 563 | <para> |
561 | Get a license key (or keys) for the encumbered BSP by visiting | 564 | Get a license key (or keys) for the encumbered BSP by visiting |
565 | a website and providing the name of the BSB and your email address | ||
566 | through a web form. | ||
567 | </para> | ||
568 | |||
569 | <!-- | ||
562 | <ulink url='https://pokylinux.org/bsp-keys.html'>https://pokylinux.org/bsp-keys.html</ulink> | 570 | <ulink url='https://pokylinux.org/bsp-keys.html'>https://pokylinux.org/bsp-keys.html</ulink> |
563 | and give the name of the BSP and your e-mail address in the web form. | 571 | and give the name of the BSP and your e-mail address in the web form. |
564 | </para> | 572 | </para> |
565 | 573 | ||
574 | COMMENT: This link is not implemented at this point. | ||
575 | |||
566 | <programlisting> | 576 | <programlisting> |
567 | [screenshot of dialog box] | 577 | [screenshot of dialog box] |
568 | </programlisting> | 578 | </programlisting> |
569 | 579 | ||
580 | --> | ||
581 | |||
570 | <para> | 582 | <para> |
571 | After agreeing to any applicable license terms, the | 583 | After agreeing to any applicable license terms, the |
572 | BSP key(s) will be immediately sent to the address | 584 | BSP key(s) will be immediately sent to the address |
@@ -609,7 +621,8 @@ FILESEXTRAPATHS := "${THISDIR}/${PN}" | |||
609 | encumbered BSP. | 621 | encumbered BSP. |
610 | These prompts usually take the form of instructions | 622 | These prompts usually take the form of instructions |
611 | needed to manually fetch the encumbered package(s) | 623 | needed to manually fetch the encumbered package(s) |
612 | and md5 sums into the required directory (e.g. the poky/build/downloads) | 624 | and md5 sums into the required directory |
625 | (e.g. the <filename>poky/build/downloads</filename>). | ||
613 | Once the manual package fetch has been | 626 | Once the manual package fetch has been |
614 | completed, restart the build to continue where | 627 | completed, restart the build to continue where |
615 | it left off. | 628 | it left off. |
@@ -619,25 +632,21 @@ FILESEXTRAPATHS := "${THISDIR}/${PN}" | |||
619 | </listitem> | 632 | </listitem> |
620 | <listitem> | 633 | <listitem> |
621 | <para> | 634 | <para> |
622 | Get a full-featured BSP recipe rather than a key, by | 635 | Get a full-featured BSP recipe rather than a key. |
623 | visiting | 636 | You can do this by visiting the applicable BSP download page from the Yocto |
624 | <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>. | 637 | Project website at |
625 | Accepting the license agreement(s) presented will | 638 | <ulink url='http://yoctoproject.org/download/board-support-package-bsp-downloads'></ulink>. |
626 | subsequently allow you to download a tarball | 639 | BSP tarballs that have proprietary information can be downloaded after agreeing |
627 | containing a full-featured BSP that is legally cleared for | 640 | to licensing requirements as part of the download process. |
628 | your use by the just-given license agreement(s). | 641 | Obtaining the code this way allows you to build an encumbered image with |
629 | This method will also allow the encumbered image to | 642 | no changes at all as compared to the normal build. |
630 | be built with no change at all to the normal build | 643 | </para> |
631 | process. | ||
632 | </para> | ||
633 | </listitem> | 644 | </listitem> |
634 | </orderedlist> | 645 | </orderedlist> |
635 | <para> | 646 | <para> |
636 | Note that the third method is also the only option available | 647 | Note that the third method is also the only option available |
637 | when downloading pre-compiled images generated from | 648 | when downloading pre-compiled images generated from non-free BSPs. |
638 | non-free BSPs. | 649 | Those images are likewise available at from the Yocto Project website. |
639 | Those images are likewise available at | ||
640 | <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>. | ||
641 | </para> | 650 | </para> |
642 | </section> | 651 | </section> |
643 | 652 | ||