add details for the pin descriptions

tenbaht · tenbaht · commit 38131446abf6 · 2017-02-10T10:34:30.000+01:00
diff --git a/docs/hardware/esp14.png b/docs/hardware/esp14.png
diff --git a/docs/hardware/esp14.svg b/docs/hardware/esp14.svg
@@ -15,7 +15,10 @@
    id="svg2"
    version="1.1"
    inkscape:version="0.91 r13725"
-   sodipodi:docname="esp14a.svg">
+   sodipodi:docname="esp14.svg"
+   inkscape:export-filename="/home/mmayer/rsync/stm8/docs/hardware/esp14.png"
+   inkscape:export-xdpi="100"
+   inkscape:export-ydpi="100">
   <defs
      id="defs4" />
   <sodipodi:namedview
@@ -26,8 +29,8 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="2.3910096"
-     inkscape:cx="62.725795"
-     inkscape:cy="339.90315"
+     inkscape:cx="159.98964"
+     inkscape:cy="155.044"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="true"
@@ -97,7 +100,7 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
+        <dc:title />
       </cc:Work>
     </rdf:RDF>
   </metadata>
@@ -727,7 +730,7 @@
            id="tspan4598"
            x="243.81367"
            y="506.7485"
-           style="font-size:12.5px;text-align:center;text-anchor:middle;fill:#ffffff;fill-opacity:1">D3</tspan></text>
+           style="font-size:12.5px;text-align:center;text-anchor:middle;fill:#ffffff;fill-opacity:1">D3*</tspan></text>
     </g>
     <g
        id="g4600"
@@ -752,7 +755,7 @@
            y="506.7485"
            x="243.81367"
            id="tspan4606"
-           sodipodi:role="line">D4</tspan></text>
+           sodipodi:role="line">D4*</tspan></text>
     </g>
     <g
        transform="translate(236.48518,19.971792)"
diff --git a/docs/hardware/stm8blue.md b/docs/hardware/stm8blue.md
@@ -66,16 +66,26 @@ this mapping:
 
 ![STM8S103 breakout board pin mapping](stm8blue.png)
 
+The pins D3/D4 (SDA/SCL, PB5/PB4) are different from the others as they are
+true open drain pins. That means, they only can drive the output low or
+open. To drive it high, they require the of an external pull-up resistor.
+This is the reason why the LED on this breakout is connected between +3.3V
+and the pins and not between the pin GND as usual. This way it is possible
+to drive the LED by writing a zero to the output register.
+
+
+
 sduino pin	| STM8S103 CPU port pin
 ----------	| ---------------------
- 0-2		| PA1-PA3
+ 0-2		| PA1-PA3 (PA1 and PA2 only weak output drivers)
  3-4		| PB5-PB4 (reverse order)
  5-9		| PC3-PC7
 10-15		| PD1-PD6
 
 serial: 14,15  
 SPI: 2,7,8,9  
-I2C: 3,4  
+I2C: 3,4 (true open drain. can't drive a high signal without an external
+pull-up resistor)
 Analog: 6,11,12,14,15  
 PWM: 2,5,6,12 plus either only 13 or 7-9 but not 13 (via alternate mapping)  
 
diff --git a/examples/sdcc-examples-stm8/blinky.c b/examples/sdcc-examples-stm8/blinky.c
@@ -1,4 +1,4 @@
-#include "stm8l.h"
+#include "stm8s.h"
 
 int main() {
 	int d;

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-#include "stm8l.h"`
	`1`	`+#include "stm8s.h"`
`2`	`2`
`3`	`3`	`int main() {`
`4`	`4`	`int d;`