Warning message

The Propeller Object Exchange system is decommissioned and replaced with a GitHub repository to house the same existing and future Propeller objects. As of 12/5/2019, this site is read-only. You can continue to browse and download objects from here for a limited time; however, please begin using the Parallax Propeller repository for future reference.
  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0
Request group membership
By: created: 2006-11-27 | updated: 2013-08-23

Provides clock timing functions to:

  • Set clock mode and frequency at run-time using similar clock setting constants as with the _clkmode system constant; like the constant: xtal1_pll16x
  • Pause execution in units of microseconds, milliseconds, or seconds, 
  • Synchronize code to the start of time-windows in units of microseconds, milliseconds, or seconds.

Example of Use:

  clk : "Clock"                  'Include Clock object in parent object
PUB Main
  clk.Init(5_000_000)            'Initialize Clock object with external frequency 5 MHz
  clk.SetMode(XTAL1_PLL2X)       'Switch system clock to gain 1 and 2x wind-up (10 MHz)
  clk.PauseMS(100)               'Pause for approximately 100 ms
Clock Demo:
The Clock Demo.spin object indicates the effects of clock source changes (speed changes) through the use of eight LEDs on the Propeller Demo Board; "scrolling" a lit LED back and forth across the eight-LED-display at a clock-dependant rate. The clock-dependant rate is created by using waitcnt with a fixed count, rather than relying on a factor of clkfreq (which changes according to clock speed).
When run, the eight-LED-display will flash when the clock source (and thus clock speed) has changed, and then will scroll the LEDs back and forth to demonstrate the relative speed of the clock.  The demo starts scrolling LEDs with a clock mode of xtal1+pll1x (5 MHz) then progressively increases up to xtal1+pll16x (80 MHz), then progressively decreases down to RCSLOW (≈20 MHz) and repeats the process again.


Version 1.2 (07/14/2012)
Package icon Clock (Clock v1.2) - Archive [Date 2013.05.02 Time 08.04].zip18.98 KB


Original File Upload
Binary Data Clock.spin45.35 KB
Version 1.2 (07/14/2012)
  • Updated to fix oscillator start-up delay bug that prevented proper operation in certain cases.
  • Heavily revised to make setting the clock mode 12x faster, code smaller, and made the object conform to the Gold Standard.
  • Added the SetMode method.
  • Deprecated the SetClock method.
Version 1.1 (11/27/2006) [Clock.spin]
  • Updated to fix clock mode value when new mode is XINPUT.