View source for Plus Shield

=='''Introduction'''==
Plus Shield helps lead out the 40 pins of Raspberry Pi 2 Module B or Raspberry Pi 1 Module B+ with screening print marks (BCM marks, see figure Plus Shield Pin Arrangement) at each pin. The shield integrates AD-DA chip and RTC chips, both of which use the I2C communication protocol and occupy no pins. For detailed materials of the chips, visit the WIKI section of our website www.sunfounder.com.<br>
[[File:Plus shield.png]]
[[File:Pi plus shield0128.png]]

=='''Software Installation'''==
Take the following procedures of installation step by step. 
===Step 1. Enable I2C and SPI===
Run the command to open Raspberry Pi Software Configuration Tool (raspi-config)
<pre>
sudo raspi-config
</pre>
'''Enable I2C:''' 
Select Advanced Options =>'''I2C''' => '''<Yes>''' => '''<Ok>''' => '''<Yes>''' <br>
'''Enable SPI:'''
Select Advanced Options => '''SPI''' => '''<Yes>''' => '''<Ok>''' => '''<Yes>''' => '''<Ok>'''
Select '''<Finish>'''. Close raspi-config. <br>
If a message of rebooting appears, click '''<No>'''. Before reboot, we still need to complete some configurations.

===Step 2. Add SPI, I2C, 1-Wire and RTC kernel module to the /etc/modules list===

Open /etc/modules
<pre>
sudo nano /etc/modules
</pre>
Add the following contents at the end of the file (but if one or more such lines already exist in the file, you do not need to repeat them; just make sure the following lines are included).
<pre>
snd-bcm2835
spi_bcm2708
spidev
i2c-dev
w1-gpio
w1-therm
rtc-ds1307
</pre>
Save and exit.
===Step 3. Enable I2C, SPI and 1-Wire hardware interfaces===
Open /boot/config.txt
<pre>
sudo nano /boot/config.txt
</pre>
Add the following contents at the end of the file. 
<pre>
dtparam=spi=on
dtparam=i2c_arm=on
dtoverlay=w1-gpio
</pre>
Save and exit.	
===Step 4. Create DS1307 (device creation) at boot===
Open /etc/rc.local
<pre>
sudo nano /etc/rc.local
</pre>
Add before the line exit 0: 
<pre>
# For Raspberry Pi 1
echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-0/new_device

# For Raspberry Pi 2
echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device

exit 0
</pre>
Save and exit. 
===Step 5. Install related software packages===
<pre>
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git i2c-tools python-smbus
</pre>
Git is a code management software that you can use to obtain or update the code we provide. Or you may learn to use Git and GitHub so you can manage and share your code conveniently. <br>
Now you can reboot. 
<pre>
sudo reboot
</pre>
===Step 6. Download source code===
Clone the source code from our GitHub page: 
<pre>
cd ~git clone https://github.com/sunfounder/SunFounder_PiPlus 
</pre>
===Step 7. Install SunFounder_PiPlus package to your Raspberry Pi===
Run setup.py to install
<pre>
cd SunFounder_PiPlus
sudo python setup.py install –c
</pre>
Add '''–c''' at the end, so after the SunFounder_PiPlus package is installed, you can set the time for DS1307.Also you can make the setting anytime by running ds1307setup.py. 
<pre>
sudo python ds1307setup.py
</pre>
Then follow the guide to complete the setting of ds1307 time. 
=='''Application'''== 
There are two chips on the Plus Shield: DS1307 and PCF8591. 
===DS1307===
First, check whether the time of DS1307 is correct: 
<pre>
sudo hwclock –r
</pre>
If it goes wrong, change directory to SunFounder_PiPlus/ and run ds1307setup.py to modify the time. 
<pre>
cd ~/SunFounder_PiPlus/
sudo python ds1307setup.py
</pre>
Run the example:
<pre>
cd ~/SunFounder_PiPlus/shield_example/
sudo python plus_ds1307.py
</pre>
Then you can see the time printed on the screen. 
Open plus_ds1307.py with nano:
<pre>
nano plus_ds1307.py
</pre>
You can see the parameter of '''DS1307(clock)''' is HOUR12. You can restore the function '''get_split_datetime()''' to the 24-hour format. <br>
You may check the application of the function under '''main()''' – comments after #. <br>
<pre>
'''
get_split_datetime(), get date, time seperatelyj
'''
#date, time = DT.get_split_datetime()
#print 'date:', date
#print 'time:', time
<pre>
Delete the mark # at the beginning of the three lines below and comment the part of '''DT.get_datetime()''', as shown below: 
<pre>
def main():
	while True:
		'''
		get_datetime() return the output of 'hwclock -r' 
		command
		'''
		#datetime = DT.get_datetime()
		#print datetime
		'''
		get_split_datetime(), get date, time seperatelyj
		'''
		date, time = DT.get_split_datetime()
		print 'date:', date
		print 'time:', time
</pre>
Press Esc to exit. Type in the command '''wq'''. Save and exit. 
 
Run plus_ds1307.py again
<pre>
sudo python plus_ds1307.py
</pre>
Then you can see the date and time printed separately on the screen. 
 

===PCF8591===
PCF8591 is an AD-DA conversion chip that adopts I2C communication method. Its address is 0x27. Since a 3.3V is applied to the chip, when using the analog pins, please make sure the voltage is no larger than 3.3V. <br>
Plug in an analog module (e.g. one of the modules in the SunFounder Sensor Kit for Raspberry Pi). <br>
Run the example:<br>
<pre>
cd ~/SunFounder_PiPlus/shield_example/
sudo python plus_pcf8591.py
</pre>
The values read of AIN0 and AIN3 will be printed on the screen, as well as the output value of AOUT.<br> 
Open ''plus_pcf8591.py'' with ''nano'':<br>
<pre>
nano plus_pcf8591.py
</pre>
In the '''setup()''' function, '''ADC = PCF8591()''' is to initialize the PCF8591 chip. <br>
In the '''main()''' function, the function '''read_all()''' is to read all the four input analog values. <br>
'''read(channel)''' is to read the analog value of a specific pin. Channel is the input pin among AIN0~AIN3 (can be defined in SunFounder_PiPlus.Shield), which can also be indicated by 0-3.<br>
'''write(value)''' is to output the analog value which ranges from 0~255.<br>
Now try to read a single analog value by read()! <br>
Plug in a device that can output analog values. Modify the sketch and run: <br>
<pre>
sudo python plus_pcf8591.py
</pre>