added external clock docs and built package

dbuezas · Dec 22, 2019 · 1dc0421 · 1dc0421
1 parent 054a58b
commit 1dc0421
Show file tree

Hide file tree

Showing 6 changed files with 54 additions and 9 deletions.
diff --git a/docs/external-clock/clock-source.png b/docs/external-clock/clock-source.png
diff --git a/docs/external-clock/clock.png b/docs/external-clock/clock.png
diff --git a/docs/external-clock/readme.md b/docs/external-clock/readme.md
@@ -0,0 +1,7 @@
+Use when an external 32MHz crystal is connected to LGT8F328P Port B Pin 6 & 7 (see databook for details, in particular about the decoupling capacitors). You can comfortably switch between the internal and external OSC using the tools menu:
+
+<img width="704" alt="image" src="./clock-source.png">
+
+And then pick the speed you want to run at (I tested 16MHz as well as 32MHz, but I kept the other options as well). This directly sets the prescaler to the correct value:
+
+<img width="539" alt="image" src="./clock.png">
diff --git a/lgt8f-1.0.5.zip b/lgt8f-1.0.5.zip
diff --git a/package_lgt8fx_index.json b/package_lgt8fx_index.json
@@ -8,6 +8,39 @@
         "online": "https://github.com/dbuezas/LGT8fx"
       },
       "platforms": [
+        {
+          "name": "LGT8fx Boards",
+          "architecture": "avr",
+          "version": "1.0.5",
+          "category": "lgt8fx",
+          "url": "https://github.com/dbuezas/lgt8fx/releases/download/v1.0.5/lgt8f-1.0.5.zip",
+          "archiveFileName": "lgt8f-1.0.5.zip",
+          "checksum": "SHA-256:6bde3060b7a9102eed89c32a163bd99db4129231ed7847a6245b2fa44433fff5",
+          "size": "598269",
+          "help": {
+            "online": "https://github.com/dbuezas/LGT8fx/issues"
+          },
+          "boards": [
+            {
+              "name": "LGT8F328P-LQFP48 MiniEVB"
+            },
+            {
+              "name": "LGT8F328P-LQFP32 wemos-TTGO-XI"
+            },
+            {
+              "name": "LGT8F328P-LQFP32 MiniEVB"
+            },
+            {
+              "name": "LGT8F328D"
+            },
+            {
+              "name": "LGT8F328D-SSOP20"
+            },
+            {
+              "name": "LGT8F88D-SSOP20"
+            }
+          ]
+        },
         {
           "name": "LGT8fx Boards",
           "architecture": "avr",
@@ -165,4 +198,4 @@
       "tools": []
     }
   ]
-}
+}
diff --git a/readme.md b/readme.md
@@ -13,6 +13,7 @@ Now the boards appear in the IDE and you can also select the clock speed.
 <img src="./docs/arduino/boards_manager.png" alt="Boards Manager" width="400"/>
 <img src="./docs/arduino/variants.png" alt="Variants" width="400"/>
 <img src="./docs/arduino/clock.png" alt="Clock" width="400"/>
+<img src="./docs/external-clock/clock-source.png" alt="External Clock" width="400"/>
 
 32Mhz is twice as fast as a conventional arduino nano!
 
@@ -27,6 +28,7 @@ Now the boards appear in the IDE and you can also select the clock speed.
 - [x] [Differential Amplifier](./docs/differential-amplifier/readme.md). See this [Example](./lgt8f/libraries/differential_amplifier/examples/all_vs_all/all_vs_all.ino).
 - [ ] Computation Accelerator (page 52 of datasheet v1.0.4) [Work by others](https://www.avrfreaks.net/comment/2272366#comment-2272366)
 - [x] [SoftwareSerial @32Mhz](./lgt8f/libraries/SoftwareSerial/SoftwareSerial.cpp#L60) (stable up to 230400 baud)
+- [x] [In-menu external clock support](./docs/external-clock/readme.md) (by [#seisfeld](https://github.com/seisfeld))
 
 # Differences to original core [Larduino_HSP v3.6c](https://github.com/Edragon/LGT/tree/master/HSP%20Patch%20File/Larduino_HSP_3.6c/Larduino_HSP_v3.6c)
 
@@ -39,14 +41,14 @@ Now the boards appear in the IDE and you can also select the clock speed.
 
 # Power consumption @ 5v
 
-| Clock 	| Pro mini style w/o power LED  	| Pro mini      	| Nano style 	|
-|-------	|----------------	|------------------------	|------------	|
-| 32MHz 	| 12.7mA         	| 15.0mA                 	| 32.6mA     	|
-| 16MHz 	| 9.2mA          	| 11.5mA                 	| 27.8mA     	|
-| 8MHz  	| 7.1mA          	| 9.4mA                  	| 25.4mA     	|
-| 4MHz  	| 5.9mA          	| 8.2mA                  	| 23.3mA     	|
-| 2MHz  	| 5.3mA          	| 7.6mA                  	| 23.4mA     	|
-| 1MHz  	| 5.0mA          	| 7.3mA                  	| 22.8mA     	|
+| Clock | Pro mini style w/o power LED | Pro mini | Nano style |
+| ----- | ---------------------------- | -------- | ---------- |
+| 32MHz | 12.7mA                       | 15.0mA   | 32.6mA     |
+| 16MHz | 9.2mA                        | 11.5mA   | 27.8mA     |
+| 8MHz  | 7.1mA                        | 9.4mA    | 25.4mA     |
+| 4MHz  | 5.9mA                        | 8.2mA    | 23.3mA     |
+| 2MHz  | 5.3mA                        | 7.6mA    | 23.4mA     |
+| 1MHz  | 5.0mA                        | 7.3mA    | 22.8mA     |
 
 # Example boards:
 
@@ -79,11 +81,13 @@ Now the boards appear in the IDE and you can also select the clock speed.
 - Larduino ISP for 328d https://github.com/Edragon/LGT/tree/master/Toolchain/ISP/LarduinoISP-master
 - https://www.eevblog.com/forum/projects/anyone-here-interested-in-the-logic-green-avrs-lgt8f328p/
 - http://coultersmithing.com/forums/viewtopic.php?f=6&t=1149
+
 # Disclamer
 
 I have no association with Arduino, Logic Green, Atmel or anything. I just wanted to have a convenient way to use these boards and get them to work without hacks at max speed
 
 # Download stats
+
 http://www.somsubhra.com/github-release-stats/?username=dbuezas&repository=lgt8fx
 
 # Thanks
@@ -93,3 +97,4 @@ http://www.somsubhra.com/github-release-stats/?username=dbuezas&repository=lgt8f
 - [#dcfusor](https://github.com/dcfusor) for help with fast io backporting
 - [#HI-SEBA](https://github.com/HI-SEBA) for help with software serial
 - [#dwillmore](https://github.com/dwillmore) for creating the wiki, serial adapter troubleshooting, more examples of boards and wemos-TTGO-XI board support
+- [#seisfeld](https://github.com/seisfeld) for adding in-menu support for an external clock