JOY-IT RASP EXPLORE 700 Instructions

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

EXPLORER 700

Expansion board

1. GENERAL INFORMATION

Dear customer,

Thank you for purchasing our product. In the following, we will show you
which things should be noted during the use.

Should you encounter any unexpected problems, do not hesitate to contact
us.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

2. CONNECTIONS

0,9" OLED:

SSD1306 driver,

resolution 128 x 64

Buzzer

CP2102 :

USB to UART converter

USB to UART: controlling the Pi

via serial interface

AD / DA IO-interface:

screw terminal

sensor interface:

connecting various sensors

Raspberry Pi GPIO interface:
to connect something with Raspberry Pi

BMP280: pressure sensor,

I2C interface

PCF8591: 8bit AD/DA

converter, I2C interface

PCF8574: I/O expension chip,

I2C interface

DS3231: real time clock

chip, I2C interface

Power indicator

user LED

joystick

LFN0038K IR

receiver

1-WIRE

interface: to

connect

1-WIRE

devices like

DS18B20

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

3. CONNECTING THE EXPANSIONBOARD

The Explorer 700 expansion board supports the Raspberry Pi A+, B+, 2, 3

Model B and 4. Before you can perform the code examples, you should en-

sure that the Explorer 700 is connected to your Raspberry Pi and it is provid­ed by power.

4. EXAMPLE - CHANGING THE LED STATUS

The explorer board has a LED which can be controlled by our code examples.
For that open the Linux console and enter the following commands:

cd ~/Desktop/RB-Explorer700/LED/python
sudo python led.py

Because of the code example, LED1 is now blinking.
Press the keys STRG + C to exit this program.
You can change the LED furthermore with the second code example.

sudo python pwm.py

This program allows the LED to pulsate. It happens trough the change of
brightness step by step.
Press the keys STRG + C to exit happens.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

6. EXAMPLE I/O - PCF8574

The GPIO expansion PCF8574 controlls the LED2 and the Joystick. These can
be used as well as the other functions of the expansionboard.

Open the console and enter the following commands:

cd ~/Desktop/RB-Explorer700/PCF8574/python
sudo python led.py

With this program, LED2 is blinking.
Press the keys STRG + C to exit the program.

sudo python pcf8574.py

This program unites dierent functions of the Explorerboard because if the
joystick is moved into one direction, the buzzer will chime, LED2 will light up
and the console will show the direction.

PCF8574 Test Program!
up
left
down
right

Press the keys STRG + C to exit the program.

7. EXAMPLE BAROMETER - BMP280

These code examples obtain the usage of dierent functions of the
barometer. In two dierent code examples the temperature, air pressure
and the relative height will queried and issued. Therefore, it is to note that
the room temperature can be influenced by the warmth of the Raspberry Pi.

Open for that the console and enter the following commands:

cd ~/Desktop/RB-Explorer700/BMP280/python
sudo python temperature-and-pressure.py

5. EXAMPLE - PRESS FUNCTION OF THE JOYSTICK

The joystick owns next to the pres function the common dircetions of

movement. Our code example shows, when the press function is used.

Open the Linux console and enter the following commands:

cd ~/Desktop/RB-Explorer700/KEY/python
sudo python key.py

By Pressing the Joystick, the console will show the following:

Key Test Program!!!!
KEY PRESS
KEY PRESS
KEY PRESS

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

8. REAL TIME CLOCK EXAMPLE - DS3231

On the Explorerboard is a real time clock which can be used for displays like
in this example. For that you have to open your console and enter the
following commands:

cd ~/Desktop/RB-Explorer700/DS3231/python
sudo python ds3231.py

The console will show the date and the current time as well as the day of the
week.

2018/08/12 18:00:00 Wed
2018/08/12 18:00:00 Wed
2018/08/12 18:00:00 Wed

Press the keys STRG + C to exit the program.

Temperature-and-pressure.py - Display the temperature and pressure.

Press Ctrl+C to exit!

Temperature = 36.25 *C & Pressure = 998.20 mbar
Temperature = 36.25 *C & Pressure = 998.20 mbar
Temperature = 36.26 *C & Pressure = 998.20 mbar

Press the keys STRG + C to exit the program.

sudo python relative-altitude.py

This code example will issue the relative height in your console. This height depends
on the current position of the Raspberry Pi and this will be set within 100 seconds.
During this time you are not allowed to move the Pi.

Relative-altitude - Calculates relative altitude from pressure.

Press Ctrl+C to exit!

Collecting baseline values for 100 seconds. Do not move the sensor!

Relative altitude: 00.00 metres
Relative altitude: 00.05 metres

Press the keys STRG + C to exit the program.

This program will issue the temperature as well as the air pressure:

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

10. IRM EXAMPLE - INFRARED REFLECTING SENSOR

On the board is an infrared receiver which can convert infrared into electric
signals. This signals include the infrared values which are issued by the
console via this code example.

cd ~/Desktop/RB-Explorer700/IRM/python
sudo python irm.py

Therefore, an infrared remote controll is requiered, which is not included in

the scope of delievery. This remote controll should be aimed at the receiver.

IRM test start:
Get the key: 0x0c
Get the key: 0x18cd
Get the key: 0x5e

Press the keys STRG + C to exit the program.

9. EXAMPLE TEMPERATURE SENSOR - DS18B20

cd ~/Desktop/RB-Explorer700/DS18B20/python
sudo python ds18b20.py

The console will issue the temperature in Celsius and in Fahrenheit.

24.687 *C & 76.437 *F

24.750 *C & 76.550 *F

24.812 *C & 76.662 *F

The temperature sensor which is included in the scope of delievery, must be

connected seperately and is not on the board. Thereby, you should note that
the straight side of the sensor is showing to the display and the rounded side
is turned away from the Raspberry Pi.

For this example, open the console and enter the following command:

Press the keys STRG + C to exit the program.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

11. EXAMPLE UART - TRANSMISSON OF SERIAL DATA

The serial interface of the Raspberry Pi is by default deactiveted. For this

program, you must enable this function so that the Raspberry Pi is not

communicating via the serial port. Instead other methods must be used to
communicate with the Raspberry Pi.
To use this code example, you have to change first the serial function in the
configuration of the Raspberry Pi.

For that, enter the following command into the console:

sudo raspi-config

Now navigate via the arrowkey into the option

5 Interfacing Options.

Aer that choose Punkt P6 Serial.

The question

Would you like a login shell to be accessible over serial?

should you answer with No.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

Now you can click on Connect to establish a connection. As the next step,
you must start the code exampleon your Raspberry Pi. For that enter the
following:

cd ~/Desktop/RB-Explorer700/UART/python

sudo python uart.py

The USB to UART interface of your Raspberry Pi allows you to connect the

Pi with your computer and to let them communicate without a
connection with the internet.
In this example, we use HTerm. Download this program here and install
it.

First of all, open HTerm and assume the settings like shown in the
picture. Therefore, it is to note that you set the right baudrate (115200)
and the right port. You should also note that your port could be dierent
which you should ensure in the device manager.

The question

Would you like the serial port hardware to be enabled?

answer with Yes.

In HTerm you will see the following:

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

Now you can sen texts to your Raspberry Pi. The code examples allows that
the Raspberry Pui will send all sended texts from your computer back to
your computer.

You can enter these texts in the text field and send them with

ASend

.

Aer that your computer will receive the following:

You can open the terminal console via the UART connection instead of an

external display or via the internet. Therefore, you can use PuTTY, MobaX-

term or others for the connection. For that, you have to change your settings
again.
First, enter the following command into the console:

sudo raspi-config

Navigate now with the arrow key to the option

5 Interfacing Options.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

Then choose point P6 Serial .

The question

Would you like a login shell to be accessible over serial?

should you answer with Yes.

Aer a reboot, you can connect your Raspberry Pi with your computer.
Now MobaXterm, which you can download here and establish a
connection with the following setting:

Therefore, you should note that you have to choose the connection type
Serial and the right port (viewable in device manager) as well as to set the
baudrate to 115200.
Now,the console will be opened and you must log in on your Raspberry
Pi. If you use our image, the user name is pi and the password is

raspberry

.

Attention, the keystrokes will not be shown if you enter your password.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

12. EXANPLE OLED - DISPLAY

To control the OLED via Python, you have to install fisrt a Python library.
To install this, you must connect your Raspberry Pi with a network and use
the following command:

sudo apt-get install python-pil

Aer you logged in successfully, the console will open and you can use the
terminal of the Raspberry Pi the same way as via SSH only without a internet
connection.

Our code examples can generate dierent displays at the OLED. These
dierentiate in significant aspects from each other.

cd ~/Desktop/RB-Explorer700/OLED/python

sudo python dispachr.py

This script issues a text on the display which can be changen in the source
code.

sudo python image.py

This script displays a picture on the display. This image can also be changed
in the code.

sudo python animate.py

The last script generates a animation on your OLED.

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

13. INSTALLATION OF THE LIBRARIES

To use API examples which we oer, certain libraries are required which

should be installed manually. Python libraries for Raspbian (includes

Raspberry Pi, GPIO and spidev installation packages.
See: https://pypi.python.org/pypi/RPi.GPIO https://pypi.python.org/pypi/

spidev ) You get them with the command

wget

.

Please note that the Raspberry Pi must be connected with the internet if you
want to us this command to install the library. Beforehand, you can use the
following command to update your soware to the latest.

sudo apt-get update

Enter now the following command to install the Python-dev package.

sudo apt-get install python-dev

Copy the installation package RPi, GPIO (GPIO interface functions) on your
Raspberry Pi board and unzip it. Select the unzipped file and enter the
following commands for the installation:

wget https://files.pythonhosted.org/packages/cb/88/
d3817eb11fc77a8d9a63abeab8fe303266b1e3b85e2952238f0da43fed4e/RPi.GPIO-0.7.0.tar.gz
tar -xvzf RPi.GPIO-0.7.0.tar.gz
cd RPi.GPIO-0.7.0.tar.gz
sudo python setup.py install

Now enter the following command to install the library smbus (I2C interface
functions):

sudo apt-get install python-smbus

Enter the following command to install the serial library which includes the
UART interface functions.

sudo apt-get install python-serial

Install the library spidev (SPI functions). Copy the installation package
spidev on your Raspberry Pi and unzip it. Select via console the unzipped
file and enter the following command to install the library:

wget https://files.pythonhosted.org/packages/

fb/14/4c2e1640f0cb04862c76d9d76ed7c945b0f67876e503ac02f7f675fe86a0/spidev-

3.4.tar.gz
tar -xvzf spidev-3.4.tar.gz
cd spidev-3.4
sudo python setup.py install

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

14. CONFIGURATION OF THE INTERFACES

(Before you perform the API codes which we oer, you should activate the

drivers of the interface accordingly. In the ready to use system-image file are

I2C as well as SPI active by default. But the serial port is still in the console
debug function.)

To allow the I2C function, enter the following command to configurate your
Raspberry Pi:

sudo raspi-config

Choose

Interfacing Options → I2C

→

yes

to start the drivers. Aer that, you
must modify the configuration file. Enter the following command to open
these:

sudo nano /etc/modules

Add these lines to the configuration file:

Press the keys Strg+X to leave the menu and enter Y to save the adjustments.
Aer that restart the module that the settings come into eect.
The serail port of the Raspberry Pi is set on the serial console debug function
by default. If you want to use the serial port as I/O, you must modify the
settings of the Raspberry Pi and activate the serial function. If the console
debug function is disabled, you can not reach the Raspberry console via the
serial port. If you want to control the Raspberry Pi again via the serial
interface, you must enable this function.

Choose

Interfacing Options → Serial

. Select the option NO to disable the se­rial debug function. You can activate the serial port aerwards with YES. You
must restart the device so that your settings are valid. Now, you can use the
port for the serial communication.

The serial port of the Raspberry Pi model B is bnot useable because pin 14
and pin 15 are connected with a own Bluetooth module.

i2c-bcm2708
i2c-dev

sudo raspi-config

To activate the SPI function, enter the following command into the console:

sudo raspi-config

Choose

Interfacing Options → SPI

→

yes

, to activate the SPI core drivers.

15. DOWNLOAD OF THE CODE EXAMPLES

To alleviate the access of our code examples, naturally you can download
them. For that, follow the link to get our download package.

https://joy-it.net/files/files/Produkte/RB-Explorer700/Explorer700-1.zip

www.joy-it.net

Pascalstr. 8 47506 Neukirchen-Vluyn

17. SUPPORT

If any questions remained open or problems may arise aer your
purchase,we are available by e-mail, telephone and ticket support
system to answer these.

E-Mail: [e-mail]
Ticket-system: http://support.joy-it.net
Telephone: [phone] – 66 (10 - 17 o'clock)

For further information visit our website:

www.joy-it.net

Published: 14.11.2019

www.joy-it.net

Simac Electronics Handel GmbH

Pascalstr. 8 47506 Neukirchen-Vluyn

16. OTHER INFORMATION

Our Information and Take-back Obligations according to the
German Electronic Law (ElektroG)

Symbol on Electrial and Electronic Products:

This crossed-out bin means that electrical and electronic products
do not belong into the household waste. You must hand over your old
appliance to a registration place. Before you can hand over the old
appliance, you must remove used batteries and replacement batteries
which are not enclosed by the device.

Return Options:
As the end user, you can hand over your old appliance (which has
essentially the same functions as the new one bought with us) free of
charge for disposal with the purchase of a new device.
Small devices, which do not have outer dimensions bigger than 25 cm
can be handed in for disposal independently of the purchase of a new
product in normal household quantities.

1. Possibility of return at our company location during our opening hours
Simac Electronics Handel GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn

2. Possibility of return nearby
We will send you a parcel stamp with which you can send us your old
appliance free of charge. For this possibility, please contact us via e-mail
at [e-mail] or via telephone, then please dial 02845 93 60 -23

Information about Package:
Please package your old appliance safe for transport. Should you not
have suitable packaging material or you do not want to use your own
material, you can contact us and we will send you an appropriate
package.