Author: robhamerling
Date: Sat Jul 4 12:46:18 2009
New Revision: 1082
Modified:
trunk/doc/html/devicefiles.html
Log:
Added some clarifications
Modified: trunk/doc/html/devicefiles.html
==============================================================================
--- trunk/doc/html/devicefiles.html (original)
+++ trunk/doc/html/devicefiles.html Sat Jul 4 12:46:18 2009
@@ -344,6 +344,48 @@
physical pin configuration
and and makes it to a large extent device independent.
+<p>There are some exceptions.
+Some function pins can be on one or another pin of a PIC, controlled
+by a register or a configuration bit setting.
+In these cases the name has to be suffixed to prevent duplicate names.
+The 16F737 for example can have the CCP2 bit on pin_B3 or pin_C1,
+controlled by a configuration bit (fuse_def CCP2MUX).
+<pre>
+var volatile bit pin_CCP2_RB3 is pin_B3
+var volatile bit pin_CCP2_RC1 is pin_C1
+</pre>
+The program or library has to detect the actual use of the CCP2 pin.
+
+
+<h3>Names of MSSP modules</h3>
+<p>Names of registers of MSSP modules have been normalized as follows:
+<ul>
+<li>MSSP module of midrange PICs
+<pre>
+ SSPADD
+ SSPBUF
+ SSPCON - first or only control register
+ SSPCON2 - second control register (if present)
+ SSPSTAT
+</pre>
+<li>First or only MSSP module of 18F family:
+<pre>
+ SSP1ADD
+ SSP1BUF
+ SSP1CON - first or only control register
+ SSP1CON2 - second control register (if present)
+ SSP1MASK
+ SSP1STAT
+</pre>
+<li>Second MSSP module of 18F family
+<pre>
+ SSP2ADD
+ SSP2BUF
+ SSP2CON - control register second module
+ SSP2CON2 - second control register (if present)
+ SSP2STAT
+</pre>
+</ul>
<h3>Names of ANSEL bits</h3>
<p>For the selection of the ADC channel the ADC library has to set the
@@ -390,37 +432,7 @@
somewhat more complicated!</i>.
-<h3>Names of MSSP modules</h3>
-<p>Names of registers of MSSP modules have been normalized as follows:
-<ul>
-<li>MSSP module of midrange PICs
-<pre>
- SSPADD
- SSPBUF
- SSPCON - first or only control register
- SSPCON2 - second control register (if present)
- SSPSTAT
-</pre>
-<li>First or only MSSP module of 18F family:
-<pre>
- SSP1ADD
- SSP1BUF
- SSP1CON - first or only control register
- SSP1CON2 - second control register (if present)
- SSP1MASK
- SSP1STAT
-</pre>
-<li>Second MSSP module of 18F family
-<pre>
- SSP2ADD
- SSP2BUF
- SSP2CON - control register second module
- SSP2CON2 - second control register (if present)
- SSP2STAT
-</pre>
-</ul>
-
-<h3>Names of ADC modules</h3>
+<h3>Names of other ADC registers and subfields</h3>
<p>Names of registers and subfields of ADC modules have been normalized as
follows:
<p>When the ADCONx_VCFG subfield is a multi-bit field it is declared
@@ -494,6 +506,11 @@
var bit led_red is pin_A0
</pre>
and use 'led_red = on' or 'led_red = off' in your program.
+
+<p><B>Note: the pin aliases in the device files are declared in this
+way and therefore are also make use of the port shadowing provided by
+the device files.</b>
+
<p>You should <b>avoid direct pin and I/O port manipulation</b>, because
it will be overruled by the automatic shadowing mechanism. For example
--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---
