summaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen3/README.evaproprietary.md
blob: 69a33d8c027c5f2f422be374aaf5c58b30209788 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
# R-Car Gen3 Evaluation Software Package for Linux


The meta-rcar-gen3 layer of meta-renesas supports the Click-through licensed
Linux Drivers and Gfx/MMP packages.

This README describes how to use these features and setting local.conf.

```bash
    I/   Build configuration
    II/  Obtain and Install Renesas Graphics Drivers
```

**NOTE:**

* However, to have a completed local.conf, please also refer to Build
Instruction in [meta-renesas/meta-rcar-gen3/README.md](README.md).

* In addition, these libraries are not provided with recipes. If you would like
to use, you will need to get them from Renesas.

## I/ Build configuration


* Add the target board to local.conf

    * For Salvator-X board

    ```bash
       MACHINE = "salvator-x"
    ```

    * For R-Car Starter Kit Premier(H3ULCB) board

    ```bash
       MACHINE = "h3ulcb"
    ```

    * For R-Car Starter Kit Pro(M3ULCB) board

    ```bash
       MACHINE = "m3ulcb"
    ```

    * For R-Car Starter Kit Pro(M3NULCB) board

    ```bash
       MACHINE = "m3nulcb"
    ```

    * For Ebisu board

    ```bash
       MACHINE = "ebisu"
    ```

* Set SOC family name

    * For H3: r8a7795

    ```bash
       SOC_FAMILY = "r8a7795"
    ```

    * For M3: r8a7796

    ```bash
       SOC_FAMILY = "r8a7796"
    ```

    * For M3N: r8a77965

    ```bash
       SOC_FAMILY = "r8a77965"
    ```

    * For E3: r8a77990

    ```bash
        # Already added in machine config: ebisu.conf
        SOC_FAMILY = "r8a77990"
    ```

* When using the click-through version of the gfx/mmp packages, you need to add
the following to your local.conf

```bash
   DISTRO_FEATURES_append = " use_eva_pkg"
```

## II/ Obtain and Install Renesas Graphics Drivers


Before setting up the build environment, you need to download the proprietary
drivers.

* Download Renesas graphic drivers with a "click through" license from
[Renesas website][rcar Linux Drivers] and unzip them into a folder.

**NOTE:**

* You have to register with a free account on MyRenesas and accept the license
conditions before downloading the drivers.
The operation is fast and simple nevertheless mandatory to access evaluation of
non open-source drivers for free.
Once you registered, you can download two zip files.

```bash
$ cd <folder containing the two zip files>
$ unzip -o R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-*.zip
$ unzip -o R-Car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-*.zip
```

To install them into the correct place in the Yocto BSP, a copy script is used.

```bash
$ cd ./meta-renesas
$ sh meta-rcar-gen3/docs/sample/copyscript/copy_evaproprietary_softwares.sh <path to the folder containing the packages>
```

[rcar Linux Drivers]: https://www.renesas.com/us/en/solutions/automotive/rcar-download/rcar-demoboard-2.html