mimxrt: Update the PWM section.

robert-hh · robert-hh · commit 257e95889dac · 2021-09-04T15:37:20.000+02:00
The feature set has been reduced.
diff --git a/docs/mimxrt/machine.PWM.rst b/docs/mimxrt/machine.PWM.rst
@@ -35,7 +35,7 @@ Example usage::
 Constructors
 ------------
 
-.. class:: PWM(dest, freq, \*, duty_u16, duty_ns, keyword_arguments)
+.. class:: PWM(dest, freq, \*, duty, duty_u16, duty_ns, keyword_arguments)
   :noindex:
 
     Construct and return a new PWM object using the following parameters:
@@ -47,7 +47,8 @@ Constructors
         If the object tuple is specified, the two pins act in complementary
         mode. These two pins must be the A/B channels of the same submodule.
       - *freq* should be an integer which sets the frequency in Hz for the
-        PWM cycle. The valid frequency range is 15 Hz - > 1 MHz.
+        PWM cycle. The valid frequency range is 15 Hz or 18Hz up to > 1 MHz.
+      - *duty* sets the duty cycle as a percent value .
       - *duty_u16* sets the duty cycle as a ratio ``duty_u16 / 65536``.
         The duty cycle of a X channel can only be changed, if the A and B channel
         of the respective submodule is not used. Otherwise the duty_16 value of the
@@ -80,9 +81,6 @@ Constructors
       - *sync*\=True|False. If a channel of a module's submodule 0 is already active, other
         submodules of the same module can be forced to be synchronous to submodule 0. Their
         pulse period start then at at same clock cycle. The default is False.
-      - *start*\=True|False. Start the PWM clock immediately. If set to False, you can define
-        a group of channels first and then start them using the PWM.start() method. The
-        default is True.
       - *xor*\=0|1|2. If set to 1 or 2, the channel will output the XORed signal from channels
         A or B. If set to 1 on channel A or B, both A and B will show the same signal. If set
         to 2, A and B will show alternating signals. For details and an illustration, please
@@ -92,14 +90,14 @@ Constructors
         channels are set to low. That allows connected H-bridges to switch off one side
         of a push-pull driver before switch on the other side.
 
-    *freq*, *duty_u16* and *duty_ns* may be given as keyword arguments as well. Only the
+    *freq*, *duty*, *duty_u16* and *duty_ns* may be given as keyword arguments as well. Only the
     *freq* argument is mandatory.
 
 
 Methods
 -------
 
-.. method:: PWM.init(freq, \*, duty_u16, duty_ns, keyword_arguments)
+.. method:: PWM.init(freq, \*, duty, duty_u16, duty_ns, keyword_arguments)
   :noindex:
 
    Modify settings for the PWM object.  See the above constructor for details
@@ -121,6 +119,17 @@ Methods
    With a single *value* argument the frequency is set to that value in Hz.  The
    method may raise a ``ValueError`` if the frequency is outside the valid range.
 
+.. method:: PWM.duty([value])
+  :noindex:
+
+   Get or set the current percent duty cycle of the PWM output, as an unsigned
+   value in the range 0 to 100 inclusive.
+
+   With no arguments the duty cycle is returned.
+
+   With a single *value* argument the duty cycle is set to that value, measured
+   as the ratio ``value / 65536``.
+
 .. method:: PWM.duty_u16([value])
   :noindex:
 
@@ -141,29 +150,13 @@ Methods
 
    With a single *value* argument the pulse width is set to that value.
 
-.. method:: PWM.center([value])
-
-   Get or set the current pulse center of the PWM output, as an unsigned 16-bit
-   value in the range 0 to 65535 inclusive.
-
-   With no arguments the center position is returned.
-
-   With a single *value* argument the center position is set to that value.
-
-.. method:: PWM.start([mask])
-
-   Start the PWM of the respective FLEXPWM submodule or QTMR channel. If a mask is specified,
-   the bits of it designate the respective submodules or channels.
-
-.. method:: PWM.stop([mask])
-
-   This is an alias to PWM.deinit.
-
 Pin Assignment
 --------------
 
-Each FLEX submodule or QTMR module may run at different frequencies. The frequency range
-is 5 Hz to >1 MHz, with increasing error for frequency an duty cycle at higher frequencies.
+Each FLEX submodule or QTMR module may run at different frequencies. The lowest frequency
+is clock_freq/2**25, or 15Hz for MIMXRT1010 and MIMXRT1020, and 18 Hz for the other
+boards. The highest frequency with U16 resolution is clock_frequency/2**18 (1907 and 2288 Hz),
+the highest frequency with 1 percent resolution is clock_frequency/400 (1.25 and 1.5 MHz).
 Pins are specified in the same way as for the Pin class.
 
 The following table shows the assignment of the board Pins to PWM units:
diff --git a/lib/nxp_driver b/lib/nxp_driver
@@ -1 +1 @@
-Subproject commit 5b985fe563e2ac75e56ccbef29e8e8a90b180394
+Subproject commit b618cb1d521cc9e133bdcd0fca154dee2d925dfe
diff --git a/lib/tinyusb b/lib/tinyusb
@@ -1 +1 @@
-Subproject commit f6fea0fdcabfc078eab88fed1b45dc34cba90c46
+Subproject commit d49938d0f5052bce70e55c652b657c0a6a7e84fe
