Merge pull request #67 from Sh3Rm4n/issue-57

Rework PLL calculation and utilize oscillator clock divison

Author: Sh3Rm4n

CHANGELOG.md

@@ -7,9 +7,32 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+### Fixed
+
+- `PLL` was calculated wrong for devices, which do not divide `HSI` ([#67](https://github.com/stm32-rs/stm32f3xx-hal/pull/67))
+
 ### Changed
 
 - **Breaking** The feature gate requires you to select a subvaraint if possible. ([#67](https://github.com/stm32-rs/stm32f3xx-hal/pull/67))
+- **Breaking** Split up `stm32f302` into sub-targets `stm32f302xb`,`stm32f302xc`,`stm32f302xd`,`stm32f302xe`
+- The system clock calculation is more fine grained now. ([#67](https://github.com/stm32-rs/stm32f3xx-hal/pull/67))
+  Now the system clock can be some value, like 14 MHz, which can not a
+  be represented as a multiple of the oscillator clock:
+```rust
+let clocks = rcc
+    .cfgr
+    .use_hse(8.mhz())
+    .sysclk(14.mhz())
+
+// or
+let clocks = rcc
+    .cfgr
+    .use_hse(32.mhz())
+    .sysclk(72.mhz())
+```
+  This is possible through utilizing the divider, which can devide the
+  external oscillator clock on most devices. Some devices have even the
+  possibility to divide the internal oscillator clock.
 
 ## [v0.4.3] - 2020-04-11
 

Cargo.toml

@@ -58,7 +58,11 @@ stm32f301xc = ["stm32f301", "device-selected"]
 stm32f301xd = ["stm32f301", "device-selected"]
 stm32f301xe = ["stm32f301", "device-selected"]
 stm32f318 = ["stm32f3/stm32f3x8", "device-selected"]
-stm32f302 = ["stm32f3/stm32f302", "device-selected"]
+stm32f302 = ["stm32f3/stm32f302", "direct-call-deprecated"]
+stm32f302xb = ["stm32f302", "device-selected"]
+stm32f302xc = ["stm32f302", "device-selected"]
+stm32f302xd = ["stm32f302", "device-selected"]
+stm32f302xe = ["stm32f302", "device-selected"]
 stm32f303 = ["stm32f3/stm32f303", "direct-call-deprecated"]
 stm32f303xb = ["stm32f303", "stm32-usbd/ram_access_1x16", "device-selected"]
 stm32f303xc = ["stm32f303", "stm32-usbd/ram_access_1x16", "device-selected"]

README.md

@@ -55,7 +55,10 @@ Note: `x` denotes any character in [a-z]
 *   stm32f301xd
 *   stm32f301xe
 *   stm32f318
-*   stm32f302
+*   stm32f302xb
+*   stm32f302xc
+*   stm32f302xd
+*   stm32f302xe
 *   stm32f303xb
 *   stm32f303xc
 *   stm32f303xd

src/lib.rs

@@ -11,7 +11,10 @@
    *   stm32f301xd
    *   stm32f301xe
    *   stm32f318
-   *   stm32f302
+   *   stm32f302xb
+   *   stm32f302xc
+   *   stm32f302xd
+   *   stm32f302xe
    *   stm32f303xb
    *   stm32f303xc
    *   stm32f303xd
@@ -45,7 +48,10 @@ compile_error!(
     *   stm32f301xd
     *   stm32f301xe
     *   stm32f318
-    *   stm32f302
+    *   stm32f302xb
+    *   stm32f302xc
+    *   stm32f302xd
+    *   stm32f302xe
     *   stm32f303xb
     *   stm32f303xc
     *   stm32f303xd
@@ -71,8 +77,8 @@ compile_error!(
     "The feature you selected is deprecated, because it was split up into sub-devices.
 
     Example: The STM32F3Discovery board has a STM32F303VCT6 chip.
-    You used to use `--features stm32f303` but now functionalities for the sub-device were added.
-    Replace it with `--features stm32f303xc` to make your code build again.
+    You probably used to use `--features stm32f303` but now functionalities for the sub-device were added.
+    In this case replace it with `--features stm32f303xc` to make your code build again.
 
     Please select one of the chip features stated above."
 );