Revision: 1438
Author: [email protected]
Date: Sat Oct 31 13:05:20 2009
Log: Fixed blink a led tutorial, added to ditamap, moved images to /images/
http://code.google.com/p/jallib/source/detail?r=1438
Added:
/trunk/doc/dita/tutorials/images/blink_a_led_16f877_pin_info.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_16f877_pinout.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_circuit.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_completed_circuit.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_jalv2_dir.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_micropro_read_pic.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_programmer.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_serial_cable.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_serial_pinout.jpg
/trunk/doc/dita/tutorials/images/blink_a_led_usb_to_serial.jpg
Deleted:
/trunk/doc/dita/tutorials/images/blink_a_led
Modified:
/trunk/doc/dita/tutorials/tutorial_blink_a_led.xml
/trunk/doc/dita/tutorials/tutorials.ditamap
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_16f877_pin_info.jpg Sat
Oct 31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_16f877_pinout.jpg Sat Oct
31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_circuit.jpg Sat Oct 31
13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_completed_circuit.jpg Sat
Oct 31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_jalv2_dir.jpg Sat Oct 31
13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_micropro_read_pic.jpg Sat
Oct 31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_programmer.jpg Sat Oct 31
13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_serial_cable.jpg Sat Oct
31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_serial_pinout.jpg Sat Oct
31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /dev/null
+++ /trunk/doc/dita/tutorials/images/blink_a_led_usb_to_serial.jpg Sat Oct
31 13:05:20 2009
Binary file, no diff available.
=======================================
--- /trunk/doc/dita/tutorials/tutorial_blink_a_led.xml Sat Oct 31 00:03:46
2009
+++ /trunk/doc/dita/tutorials/tutorial_blink_a_led.xml Sat Oct 31 13:05:20
2009
@@ -17,20 +17,21 @@
<title>Setup your workspace</title>
<p>Start by getting out your programmer and connect it to your pc.
Some connect by serial port, some connect via USB. I actually use a serial
port programmer attached to a USB-to-Serial addapter to free up my serial
port for other projects.</p>
<p>If you are using a serial port programmer you need to check that
you have a regular serial cable and is not a null modem cable. Using your
multimeter, check that each pin of your serial cable matches, if pins 7
& 8 are crossed, it is a null modem cable.</p>
- <p><image href="images/blink_a_led/serial_cable.jpg"/><image
href="images/blink_a_led/usb_to_serial.jpg"/><image
href="images/blink_a_led/serial_pinout.jpg"/></p>
+ <p><image href="images/blink_a_led_serial_cable.jpg"/><image
href="images/blink_a_led_usb_to_serial.jpg"/><image
href="images/blink_a_led_serial_pinout.jpg"/></p>
<p>Get out your PIC microcontroller (we will now refer to it as a
PIC). You can use PIC’s 16f877, 16f877A, 18F2550 , 18F452 or 18F4550 for
this project since the port pinouts are the same for all of them. I will
use 16f877A for this blink a led project.</p>
<p>Now check PC connectivity to your programmer. Open your
programming software on your PC, check the settings within your software to
change the serial port number and programmer type (if available). Your
programmer software may tell you that your board is connected, if not, put
your PIC in your programmer and do some basic tests such as “read chip”,
“blank / erase chip”</p>
- <image href="images/blink_a_led/programmer.jpg"/>
- <p>If you are using Micropro, click on “file” -> “port”, and
“file” -> “programmer” -> (your programmer type). If you do not know
the programmer type, you will have to guess untill Micropro says something
like “K149-BC board connected”. Choose your PIC type from the “Chip
Selector” text box. Now do some basic read/erase tests.</p>
+ <image href="images/blink_a_led_programmer.jpg"/>
+ <p>If you are using Micropro, click on “file” -> “port”, and
“file” -> “programmer” -> (your programmer type). If you do not know
the programmer type, you will have to guess untill Micropro says something
like “K149-BC board connected”, Put your PIC in your programmer and choose
your PIC type from the “Chip Selector” text box. Now do some basic
read/erase tests.</p>
+ <image href="images/blink_a_led_micropro_read_pic.jpg"/>
</section>
<section>
<title>Build your circuit</title>
<p>Well, it looks like we’re all set to go, so grab your breadboard
and other components, put together the following circuit:</p>
- <p><image href="images/blink_a_led/blink_circuit.bmp"/></p>
+ <p><image href="images/blink_a_led_circuit.jpg" width="500"/></p>
</section>
<section>
<p>And here’s what it looks like. Notice the additional orange wire
to the left of my PIC, this ensures that I always put my PIC in the correct
position after programming. Do not connect your power 5v supply till your
circuit is complete and checked over at least twice. You will burn your PIC
if power is on while building your circuit. You will want an on/off switch
for your power supply.</p>
- <p><image href="images/blink_a_led/circuit.jpg"/></p>
+ <p><image href="images/blink_a_led_completed_circuit.jpg"/></p>
</section>
<section>
<p>Your circuit is done, and it looks pretty, but it doesn’t do
anything :o(..</p>
@@ -38,7 +39,7 @@
<section>
<title>Understand the jalv2 direcotry structure</title>
<p>First take a look at your jalv2 installation directory on your
PC, wherever you installed it. </p>
- <p><image href="images/blink_a_led/jalv2_dir.bmp"/></p>
+ <p><image href="images/blink_a_led_jalv2_dir.jpg"/></p>
<p><b>compiler</b> – holds the jalv2.exe compiler program to convert
your JAL code to microcontroller hex code</p>
<p><b>jaledit </b>– JAL text editor where you will write your
code</p>
<p><b>lib</b> – A set of libraries to make things work</p>
@@ -51,7 +52,7 @@
</section>
<section>
<title>Let’s write some code</title>
- <p>So now we’re going to write the code that will make our LED
blink. All code will be shown in green text. You can read more about JAL
language useage here: <xref class="-
topic/xref ">http://www.casadeyork.com/jalv2/language.html</xref></p>
+ <p>So now we’re going to write the code that will make our LED
blink. All code will be shown in green text. You can read more about JAL
language useage here: <xref class="- topic/xref "
href="http://www.casadeyork.com/jalv2/language.html";>http://www.casadeyork.com/jalv2/language.html</xref></p>
</section>
<section>
<title>Title & Author Block</title>
@@ -104,10 +105,10 @@
<section>
<title>Choose an output pin</title>
<p>Let’s choose an output pin to control our LED. As you can see
from the circuit, our LED is connected to pin #2. Let’s check our datasheet
to find the pin name from the pinout diagram.</p>
- <p><image href="images/blink_a_led/16f877_pinout.bmp"/></p>
+ <p><image href="images/blink_a_led_16f877_pinout.jpg"/></p>
<p>As you can see, we are using the pin RA0/ANO at pin #2. RA0 is
the pin name we are looking for. AN0 is another name for this same pin
(used in the analog to digital tutorial), but we can ignore it in this
tutorial. In the JAL language RA0 is written as pin_A0</p>
<p>Now let’s read the details of this pin in the PDF file on page
10. As you can see RA0 is a TTL Digital I/O pin. We are checking this to
make sure it is not a open drain output. Open drain outputs (like pin RA4)
require a pull-up resistor from the pin to V+</p>
- <p><image href="images/blink_a_led/16f877_pin_info.bmp"/></p>
+ <p><image href="images/blink_a_led_16f877_pin_info.jpg"
width="500"/></p>
<p>Now write code for pin A0. We are writing an “alias” only because
in the future we can refer to pin 2 (A0) as “led”. This way we no longer
need to remember the name of the pin (exept for the next line of code we
will write)</p>
<p><codeblock>--
-- You may want to change the selected pin:
=======================================
--- /trunk/doc/dita/tutorials/tutorials.ditamap Sun Sep 27 01:21:22 2009
+++ /trunk/doc/dita/tutorials/tutorials.ditamap Sat Oct 31 13:05:20 2009
@@ -27,6 +27,9 @@
<chapter href="tutorial_basics.xml">
<topicref navtitle="Blinking a LED -- TODO"/>
<topicref navtitle="Setting up a serial link (UART) -- TODO"/>
+ <topichead navtitle="Basics">
+ <topicref href="tutorial_blink_a_led.xml"/>
+ </topichead>
</chapter>
<chapter href="tutorial_peripherals.xml">
<topichead navtitle="Pulse Width Modulation (PWM)">
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"jallib" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/jallib?hl=en
-~----------~----~----~----~------~----~------~--~---
