Plastic Logic 303040 User manual

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 1of 16
QUICK START GUIDE
5.4” Iridis®Display module
With
Display Connector Board
Sojus 5.5
Part-No. 303040
Revision 1
June 02nd 2021

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 2of 16
Revision
Status
Date
Author
Reason of Modification
1
2021/06/02
MH
Initial Version

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 3of 16
Inhalt
1Safety Points ................................................................................................................ 4
2About this document ................................................................................................... 4
3Getting Started ............................................................................................................. 4
3.1 Unpacking the Kit.................................................................................................... 4
3.2 Connecting the Display with the Kit......................................................................... 6
3.3 System Boot and Image Display ............................................................................. 6
3.4 Starting the EPD ..................................................................................................... 6
3.5 Stopping and Starting the Slideshow....................................................................... 7
3.6 Setting Waveform and VCOM................................................................................. 7
3.7 References.............................................................................................................. 7
4Controlling the Kit from a PC ...................................................................................... 7
4.1 Connecting the Kit to a PC via USB ........................................................................ 7
5Transferring Files......................................................................................................... 9
5.1 Ethernet via USB..................................................................................................... 9
5.2 Further Information.................................................................................................10
5.2.1 Change the display type..................................................................................10
6SD-Card Content .........................................................................................................10
7Software Overview......................................................................................................13
7.1 Steps to set up a customized slideshow.................................................................13
7.2 EPDC-Scripts.........................................................................................................13
7.2.1 $ slideshow_start.sh........................................................................................13
7.2.2 $ slideshow-stop.sh.........................................................................................14
7.2.3 $ slideshow-select [display-type].....................................................................14
7.2.4 $ slideshow-enable.sh.....................................................................................14
7.2.5 $ slideshow-disable.sh....................................................................................14
7.2.6 $ setup-environment.sh...................................................................................15
8Manual Image Update..................................................................................................15
8.1 Image Format.........................................................................................................15
8.2 Clear Update..........................................................................................................15
8.3 Image Update.........................................................................................................16
9Troubleshooting..........................................................................................................16

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 4of 16
1 Safety Points
Warning:
•To avoid risk of electric shock or damage to the display, disconnect the
display module from its power source before handling it.
•Do not touch the connections or circuits whilst the display is in
operation.
Caution:
•Follow ESD handling procedures to avoid circuit damage. Use a
grounded wrist strap.
•Do not press on the display panel or its edges as damage can result.
Important Notice
The Plastic Logic Display Evaluation Kit (“the Kit”) is intended for use for
ENGINEERING DEVELOPMENT, DEMONSTRATION OR EVALUATION PURPOSES
ONLY and is not considered by Plastic Logic to be a finished end-product fit for
general consumer use. Persons handling the Kit must have electronics training and
observe good engineering practice standards. As such, the kit being provided is not
intended to be complete in terms of required design-, marketing-, and/or
manufacturing-related protective considerations, including product safety and
environmental measures typically found in end products that incorporate such
semiconductor components or circuit boards. The kit does not fall within the scope of
the European directives regarding electromagnetic compatibility, restricted
substances (RoHS), recycling (WEEE), FCC, CE or UL, and therefore may not meet the
technical requirements of these directives or other related directives.
2 About this document
This document is a quick start guide for the Sojus 5.5 adapter component for driving 5.4”
Iridis® Display module.
3 Getting Started
Prior to unpacking the kit, the user is strongly urged to take appropriate ESD and safety
precautions.
3.1 Unpacking the Kit
The Sojus 5.5 evaluation kit component is part of the Plastic Logic Display Evaluation Kit for
5.4” Iridis® Display module. Please ensure that the items listed have been included in your
kit. Remove the kit from the anti-static bags and perform a visual inspection.

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 5of 16
No.
No.
Item
Description
1
BeagleBoneBlack
User interface board.
2
Falcon 4.1 Board
Display driver board.
3
Power Extension Board
Additional power board.
Sojus 5.5 Board
Display connector board.
4
Ribbon Cable (40pin)
Connection between display driver and connector board.
5
Micro - SD Card
Contains slide-show images, display specific waveforms and
vcoms, documentation.
6
USB cable
Connection between BeagleBoneBlack and PC.
7
Power Supply
DC 5.0/4A power supply with regional adapters.
8
Display Module
5.4” Iridis® Display module
Ribbon Cable
Display Module
Sojus 5.5
Falcon 4.1
BeagleBoneBlack
Power Extension Board
Micro - SD-Card

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 6of 16
3.2 Connecting the Display with the Kit
Plug the display into the display connector of the Sojus 5.5 connector board first. It is important to
connect the display before powering up the kit to avoid damages of any parts!
Attention: Do not connect or disconnect a display during the kit is powered up!
3.3 System Boot and Image Display
After the display is plugged in use the power supply (DC 5V/4A) to power up the kit. The image
slideshow will start after a couple of seconds. Do not run the kit powered from USB only! This will
cause errors and malfunction. Though the system boots the display is not going to operate correctly.
3.4 Starting the EPD
Once after startup or after significant changes to the configuration, it is needed to start the EPDC.
Power Supply
USB cable

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 7of 16
Use epdc-app –start_epdc [nvm-content] [clear screen]. The Parameters are optional. Set the clear
screen option to 1 to clear the screen on epdc init.
3.5 Stopping and Starting the Slideshow
To start the slideshow use the command slideshow-start.sh. The slideshow will show the png-images
in the images folder /boot/uboot/[DisplayType*]/img.
The command slideshow-stop.sh stops the slideshow.
To enable the slideshow at startup use the command slideshow-enable.sh
To disable the slideshow at startup use the command slideshow-disable.sh
The slideshow scripts are located on the SD-Card (/boot/uboot/)epdc/bin.
3.6 Setting Waveform and VCOM
The Waveform and the VCOM are set in the config file epdc.config on the
/boot/uboot/[DisplayType*]
3.7 References
[1] www.chiark.greenend.org.uk/~sgtatham/putty/download.html
[2] http://beagleboard.org/Products/BeagleBone
*) See the available display types either on the SD-Card (Display data is stored in folders with the
display type name) or in the table in section 4
4 Controlling the Kit from a PC
4.1 Connecting the Kit to a PC via USB
To control the kit remotely it is required to set up a connection. It is recommended to use a serial
connection over USB. Plug in the included USB cable into the PC first. Plug in the cable into the kit
afterwards.
If the connection fails by some reason it is important to remove the mini USB cable from the kit and
reconnect it.
Execute the following steps to establish the connection:
•Click on the Windows “Start” button and select “Devices and Printers”.
•Double-Click “BeagleBone…”.

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 8of 16
•Click the “Hardware” tab.
•Find out the COM port of the USB Serial Port.
•Use “PuTTY” to connect the PC to the kit. This is a free SSH implementation for Windows which
also supports serial connections. It can be downloaded from:
www.chiark.greenend.org.uk/~sgtatham/putty/download.html.
•Choose connection type “Serial” and configure the COM port and the speed (115200).

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 9of 16
•Click “Open” and a terminal window will appear.
•Press “ENTER” and the Debian Linux login screen appears.
•Log in using the following credentials: login “root”, password “”.
•Now you are successfully logged-in and can use the shell.
5 Transferring Files
5.1 Ethernet via USB
If the system is powered up and the slideshow is running connect the kit with the provided mini USB
cable to your PC. Ethernet over USB will be enabled automatically on the kit after plugging in the USB
cable. A USB Ethernet/RNDIS gadget will be installed on the PC automatically. This device can be
found in the “Devices and Printers” dialog.
Now your Ethernet connection is enabled. The kit runs a DHCP server so that it is not required to
change the network settings of the RNDIS/Ethernet Gadget on the PC. The kit uses the IP address
192.168.7.2 and the PC uses the IP address 192.168.7.1.
Check the “Network and Sharing Center” to verify the network settings on the PC. Use “Change
adapter settings” to list all available network connections. Open the local area connection which
belongs to the USB Ethernet/RNDIS Gadget. Open “Details” to check the IP address which is actually
used. Close the dialog and open “Properties” and then open the “Internet Protocol Version 4”
properties. This should have “Obtain an IP address automatically” selected.

QuickStartGuide_B_S5.2_301001 All rights reserved. Revision 2
Page 10 of 16
With the Ethernet connection enabled the kit can be accessed via FTP and SSH. The FTP connection
does not require a user or a password. The SSH connection uses the same credentials as the serial
connection (login “root”, password “”).
5.2 Further Information
The “C_FN2” Evaluation kit is to be used to drive a wide variety of Plasticlogic displays. For detailed
information on this components, please refer to their respective documentation.
Please remove the Micro-SD card from the switched off kit and insert it into a PC. Please check the
folders “Source” and “Documentation” for further information.
The SD-Card content and source code can be found on github. Make sure to use the same version of
both repositories.
5.2.1 Change the display type
To change the display type, remove the SD-Card from the Beaglebones SD-Card slot and open the file
config.txt with a text editor. Edit the line “display type [old Display Type]” to “display type [new
Display Type]” and restart the application (epdc-app –start_epdc).
6 SD-Card Content
The PLDEK is preinstalled on the shipped SD-Card and runs out of the box. Since the PLDEK is installed
on a standard BeagleBone image, there are a lot of files on the SD-Card which are not directly related
to the PLDEK content. Furthermore the PLDEK-SD-Card is shared between the microcontroller
platform and the BeagleBone Platform, so some files on the SD-Card are necessary for the
BeagleBone and not for the microcontroller, for not the BeagleBone and for the microcontroller or
both.