This is the documentation page for the SPI_LCD and I2C_LCD boards. That you can buy in the [http://www.bitwizard.nl/shop/displays BitWizard shop].

== Overview ==

== Overview ==

Line 22:

Line 22:

For the SPI version the second SPI port can be used as an ICSP connector. You need to toggle the solder jumper for this. The I2C or SPI bus cannot be left connected during programming.

For the SPI version the second SPI port can be used as an ICSP connector. You need to toggle the solder jumper for this. The I2C or SPI bus cannot be left connected during programming.

+

+

The contrast setting depends strongly on the voltage of the power line. We test the boards with our powersupply and deliver them with a contrast setting that works for us. However if your powersupply has a higher or lower voltage, the proper contrast setting might be different.

== External resources ==

== External resources ==

Line 41:

Line 43:

−

For use with a raspberry pi there are a few options. For the I2C version, you can get http://www.bitwizard.nl/software/bw_rpi_tools-20120616.tgz . The GPIO directory in that archive contains some programs to communicate with the LCD with a userspace driver. There is also a kernel-space driver for the I2C module, but I haven't looked at accessing that from userspace yet. (the kernel-space driver will allow other kernel drivers, for example for a temperature sensor, to access the I2C bus).

+

For use with the raspberry pi use the [https://github.com/rewolff/bw_rpi_tools bw_rpi_tools package from github](and then only the bw_tool program).

−

+

=== Related projects ===

−

For SPI on the raspberry pi, the same gpio directory contains "send_spi". It will allow you to send stuff to the SPI display.

−

−

For SPI there is also a beta kernel driver. That is what the other directory bw_spi is for.

−

=== Related projects ===

+

* [[Beginners_guide_to_SPI_on_Raspberry_Pi]]

== Pinout ==

== Pinout ==

Line 53:

Line 52:

For the SPI connector see: [[SPI_connector_pinout]]. <br>

For the SPI connector see: [[SPI_connector_pinout]]. <br>

For the I2C connector see: [[I2C_connector_pinout]].

For the I2C connector see: [[I2C_connector_pinout]].

+

+

To connect the I2C board to a raspberry pi without a converter board ("rpi_serial"), you can use 4 separate wires. This is shown here: [[File:DSC04800.JPG|none|thumb|300px|alt=I2C without RPI_serial|I2C without RPI_serial]]

Line 72:

Line 73:

For the intro to the SPI and I2C protocols read: [[SPI versus I2C protocols]]

For the intro to the SPI and I2C protocols read: [[SPI versus I2C protocols]]

−

The board specific protocol can be found here: [[spi_lcd 1.3_protocol]] [[spi_lcd_1.2_protocol]] [[i2c_lcd_protocol]]

+

The board specific protocol can be found here: [[lcd protocol 1.6]] (both I2C and SPI).

+

For reference: here are older versions of the document: [[spi_lcd 1.3_protocol]] [[spi_lcd_1.2_protocol]] [[i2c_lcd_protocol]]

You should also read the [[General_SPI_protocol]] notes.

You should also read the [[General_SPI_protocol]] notes.

Line 79:

Line 81:

This is a demo to send things using SPI to the lcd board. The SPI routines there are applicable for LCD boards as well.

This is a demo to send things using SPI to the lcd board. The SPI routines there are applicable for LCD boards as well.

+

+

== Troubleshooting ==

+

+

If your display stays blank while turning on your system, this might be an indication of that the power supply is rising too slowly. In that case, the processor on your spi_lcd or i2c_lcd board is booting before the controller on the LCD sub-assembly has enough power to work. In that case, you need to send a dummy byte to the 0x14 port. This will reinitialise the LCD.

== The software ==

== The software ==

+

If you are going to connect your I2C_LCD or SPI_LCD to a raspbery pi, read: [[getting started with rpi_serial and BitWizard expansion boards]]

== Future hardware enhancements ==

== Future hardware enhancements ==

+

hardware potentiometer for the contrast. (option).

== Future software enhancements ==

== Future software enhancements ==

Latest revision as of 11:52, 11 November 2015

The SPI_LCD board

This is the documentation page for the SPI_LCD and I2C_LCD boards. That you can buy in the BitWizard shop.

Overview

Assembly instructions

The board comes fully assembled, as depicted in the picture on the top right of this page..

We assemble the ones with LCD with just a pin header between the board and the LCD, so you could do the same. Make sure you put the LCD in correctly. I'm not sure everything survives the wrong polarity.

Recommended configuration

Also possible

Not recommended configuration

Possible Configurations

For the SPI version the second SPI port can be used as an ICSP connector. You need to toggle the solder jumper for this. The I2C or SPI bus cannot be left connected during programming.

The contrast setting depends strongly on the voltage of the power line. We test the boards with our powersupply and deliver them with a contrast setting that works for us. However if your powersupply has a higher or lower voltage, the proper contrast setting might be different.

Related projects

Pinout

To connect the I2C board to a raspberry pi without a converter board ("rpi_serial"), you can use 4 separate wires. This is shown here:

I2C without RPI_serial

LEDs

The only LED is a power indicator.

Jumper settings

There are two solder jumpers. The one between the two 6-pin SPI connectors controls the function of the SPI connector furthest from the CPU.

In the default configuration the second SPI connector is a daisy-chain connector for the SPI bus.
In the other configuration, the second SPI connector is the ICSP connector.

There is a 10 mil (very small) PCB trace in the solder jumper in the default configuration. You'll have to cut this trace to move the solderjumper to the other position. If you later decide you want the other configuration again, some solder-wick can be used to remove the solder from one position and then it can be added to the other position.

For arduino, a sample PDE is available, called ardemo_lcd.pde, also at BitWizard software download directory .

This is a demo to send things using SPI to the lcd board. The SPI routines there are applicable for LCD boards as well.

Troubleshooting

If your display stays blank while turning on your system, this might be an indication of that the power supply is rising too slowly. In that case, the processor on your spi_lcd or i2c_lcd board is booting before the controller on the LCD sub-assembly has enough power to work. In that case, you need to send a dummy byte to the 0x14 port. This will reinitialise the LCD.