Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Documentation fixes #133

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Documentation fixes #133

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ad44e0d
Added nproc to GNU make calls
alxhoff Mar 25, 2020
731fdd7
Added some more possible problems 'white screen' help documentation
alxhoff Mar 25, 2020
54072ed
Review #133
alxhoff Apr 3, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ cd fbcp-ili9341
mkdir build
cd build
cmake [options] ..
make -j
make -j `nproc`
sudo ./fbcp-ili9341
```

Expand Down Expand Up @@ -188,7 +188,7 @@ cd fbcp-ili9341
mkdir build
cd build
cmake -DSPI_BUS_CLOCK_DIVISOR=6 -DADAFRUIT_ILI9341_PITFT=ON ..
make -j
make -j `nproc`
sudo ./fbcp-ili9341
```

Expand Down Expand Up @@ -394,7 +394,7 @@ Enable the option `#define DISPLAY_ROTATE_180_DEGREES` in `config.h`. This shoul

Edit the file `config.h` in a text editor (a command line one such as `pico`, `vim`, `nano`, or SSH map the drive to your host), and find the appropriate line in the file. Add comment lines `//` in front of that text to disable the option, or remove the `//` characters to enable it.

After having edited and saved the file, reissue `make -j` in the build directory and restart fbcp-ili9341.
After having edited and saved the file, reissue ``make -j `nproc` `` in the build directory and restart fbcp-ili9341.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, is make -j not enough to get to parallel compilation? Or does that not work in some cases?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be honest I don't really know if -j is a problem. The docs say

If there is nothing looking like an integer after the ‘-j’ option, there is no limit on the number of job slots.

What effect that has I don't know, I'm just used to always using nproc.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, let's go with just make -j then, no need to specify the nproc.


Some options are passed to the build from the CMake configuration script. You can run with `make VERBOSE=1` to see which configuration items the CMake build is passing. See the above *Configuring Build Options* section to customize the CMake configure items. For example, to remove the statistics overlay, pass `-DSTATISTICS=0` directive to CMake.

Expand Down Expand Up @@ -471,6 +471,9 @@ Unfortunately there are a number of things to go wrong that all result in a whit
- shut down and physically power off the Pi and the display in between multiple tests. Driving a display with a wrong initialization routine may put it in a bad state that needs a physical power off for it to reset,
- if there is a reset pin on the display, make sure to pass it in CMake line. Or alternatively, try driving fbcp-ili9341 without specifying the reset pin,
- make sure the display is configured to run 4-wire SPI mode, and not in parallel mode or 3-wire SPI mode. You may need to solder or desolder some connections or set a jumper to configure the specific driving mode. Support for 3-wire SPI displays does exist, but it is more limited and a bit experimental.
- If connecting the wires directly ensure that the values given are BCM pin numbers and not the physical pin numbers. See [RPi pinout](https://pinout.xyz/#).
- If nothing else works, try changing the BCM pins used for the reset, backlight and data control.


#### The display stays blank at boot without lighting up

Expand Down