Home
What if?
Features
MCUs
Examples
Testimonies
Downloads
Forum
Purchase!
Contact Us

StickOS User's Guide

CPUStick User's Guide

Copyright © 2008-2012 CPUStick.com;
all rights reserved.
Patent U.S. 8,117,587.

  rtestardi@live.com

CPUStick™ and StickOS® -- Downloads

StickOS® BASIC

Downloads, for evaluation purposes only, with no warranty whatsoever:

StickOS Quick Reference (.PDF)
StickOS User's Guide (.PDF)
StickOS Microchip MCU Details (.PDF)
StickOS Freescale MCU Details (.PDF)
StickOS Revision History and Known Bugs

CPUStick.inf file needed for Windows USB with StickOS v1.80 and later -- save to a file, right-click, and select "Install"
(If you are on Windows 8, these might work better -- save both to files and "Install" the inf:
w8/cpustick.w8.zip)

For chipKIT, see: Introduction to chipKIT
For FSLBOT, see: Introduction to FSLBOT
For Firebird32, see: Introduction to Firebird32
For bootloader versions of StickOS, see: Bootloader Instructions

StickOS for Microchip PIC32MX7-F512H CUI32Stem Board Bootloader (v1.92*) (.HEX, CUI32Stem avrdude bootloader image)
StickOS for Microchip PIC32MX4-F512H CUI32 Board Bootloader (v1.92*) (.HEX, CUI32 HID bootloader image)
StickOS for Microchip PIC32MX7-F512H DuinoMite-Mega Board Bootloader (v1.92* beta) (.HEX, DMHID bootloader image)

StickOS for Microchip PIC32MX7-F512L UBW32v2 Board Bootloader (v1.92*) (.HEX, UBW32v2 HID bootloader image)
StickOS for Microchip PIC32MX4-F512L UBW32v1 Board Bootloader (v1.92*) (.HEX, UBW32v1 HID bootloader image)
StickOS for Microchip PIC32MX7-F512L chipKIT Max32 Bootloader (v1.92*) (.HEX, Max32 avrdude bootloader image)
StickOS for Microchip PIC32MX3-F128H chipKIT Uno32 Bootloader (v1.92*) (.HEX, Uno32 avrdude bootloader image)
StickOS for Microchip PIC32MX7-F256/512L (v1.92*) (.HEX, PIC32 binary image, checksum 0x294)
StickOS for Microchip PIC32MX7-F256/512H (v1.92*) (.HEX, PIC32 binary image, checksum 0x19e9)
StickOS for Microchip PIC32MX3/4-F256/512L (v1.92*) (.HEX, PIC32 binary image, checksum 0xf88e)
StickOS for Microchip PIC32MX3/4-F256/512H (v1.92*) (.HEX, PIC32 binary image, checksum 0x117a)
StickOS for Freescale MCF52259 FSLBOT and TWR-MECH (v1.92*) (.S19, ColdFire binary image, checksum 0x1d7)
StickOS for Freescale MCF5225x Demo Kit Bootloader (v1.92*) (.S19, ColdFire Demo Kit MST bootloader image)
StickOS for Freescale MCF5225x and CPUStick (v1.92*) (.S19, ColdFire binary image, checksum 0xeb57)
StickOS for Freescale MCF5223x (v1.82*) (.S19, ColdFire binary image, checksum 0xdb1b)
StickOS for Freescale MCF5222x (v1.82*) (.S19, ColdFire binary image, checksum 0xf57c)
StickOS for Freescale MCF521x (v1.82*) (.S19, ColdFire binary image, checksum 0xe261)
StickOS for Freescale MCF51JM128 Firebird32 (v1.84*) (.S19, ColdFire binary image, checksum 0x1c5)
StickOS for Freescale MCF51JM128 Firebird32 Nano and Mini (v1.84*) (.S19, ColdFire binary image, checksum 0x9670)
StickOS for Freescale MCF51JM128 Badge Board Bootloader (v1.82*) (.S19, ColdFire Badge Board MST bootloader image)
StickOS for Freescale MCF51JM128 (v1.82*) (.S19, ColdFire binary image, checksum 0x9a11)
StickOS for Freescale MCF51CN128 (v1.82*) (.S19, ColdFire binary image, checksum 0x968a)
StickOS for Freescale MCF51QE128 (v1.82*) (.S19, ColdFire binary image, checksum 0x251f)
StickOS for Freescale MC9S12DP512 (v1.82*) (.SX, HCS12 binary image)
StickOS for Freescale MC9S12DT256 (v1.82*) (.SX, HCS12 binary image)
StickOS for Freescale MC9S08QE128 (v1.82*) (.SX, HCS08 binary image)

* This image of StickOS is released under a free, irrevocable, perpetual license to U.S. Patent 8,117,587 for personal, educational, or non-commercial purposes.  This version of StickOS is released "as-is" with no warranty of merchantability and no warranty of fitness for any purpose.  This license shall not be implied to cover any future releases of StickOS which are not expressly released under such a license.  For information on commercial licenses, please contact cpustick.com.

Old files are available here.

StickOS for Windows (.EXE, software simulation of StickOS running on MCF52221)


CPUStick™

CPUStick User's Guide (.PDF)

You can build a CPUStick (with Freescale MCF52252 and integrated Freescale MC13201 2.4GHz ZigFlea Wireless Transceiver) from:

CPUStick Schematic and BOM (.PDF)
CPUStick Gerber, Drill, and PickPlace Files (.ZIP)

Note that you need a Freescale development board and a QSPI connection to the new CPUStick to download StickOS bits initially, using the "clone" or "download" command as described here.


Other Boards

You can run StickOS on any of these Microchip boards available from either mouser.com, microchipdirect.com, digilentinc.com, or sparkfun.com, or basically on any MCU meeting the crystal and pin requirements listed in the MCU Details, above:

  • chipKIT Uno32 or Max32 from digilentinc.com
  • CUI32Stem (with PIC32MX7) (soon) from seeedstudio.com
  • CUI32 (with PIC32MX4) from sparkfun.com
  • UBW32 (with PIC32MX4 or PIC32MX7) from sparkfun.com
  • PIC32 Ethernet Starter Board (with PIC32MX7)
  • PIC32 USB Starter Board (with PIC32MX4)
  • PIC32 Starter Board (with PIC32MX3)

You can run StickOS on any of these Freescale boards available from either mouser.com, freescale.com, firebird32.com, or technologicalarts.com, or basically on any MCU meeting the crystal and pin requirements listed in the MCU Details, above:

  • FSLBOT and TWR-MECH (with MCF52259)
  • Firebird32, Firebird32-nano, or Firebird32-mini (with 51JM128) from firebird32.com
  • Tower System (with MCF5225x or MCF51CN128)
  • M52259DEMOKIT (with MCF52259)
  • M52233DEMO (with MCF52233)
  • M52221DEMO (with MCF52221)
  • M5211DEMO (with MCF5211)
  • Badge Board/JMBADGE2008 (with MCF51JM128) -- See an accelerometer-based pong/paddleball game with sound effects that won 2nd place in the Freescale "Can Your Badge Do This Contest", along with the contest entry video for an MCU-Resident Rapid Prototyping and Education Environment for highly integrated MCUs, including ZigFlea Wireless Support, submitted by Rich Testardi!
  • DEMOJM (with MCF51JM128)
  • DEMOQE (with MCF51QE128)
  • APS12DT256SLK (with MC9S12DT256)
  • Adapt9S12D (with MC9S12DP512) from technologicalarts.com
  • DEMOQE (with MC9S08QE128)
  • 1320xRFC RF daughter card (with MC13202) - You can use the 2.4GHz ZigBee Wireless Transceiver from the 1320xRFC RF daughter card, which plugs directly into the top of the DEMOQE, DEMOJM, M5211DEMO, M52221DEMO, or M52233DEMO boards.

Use the "help pins" command to see MCU-specific pin names and capabilities; use the "pins" command to display or set the StickOS pin assignments; see the Supported MCUs page for MCU-specific feature sets.

Or just try out the Windows version, above...  Most everything works the same except zigflea, the I/O pins, StickOS upgrade, and some line editing features.


Skeleton Project

You can find the full source code to StickOS on github here: https://github.com/cpustick/history.git

We also have a skeleton source code project, with a simple command line interface including features like a zigflea wireless transport (with a telnet/rlogin-like interface), USB, Ethernet, i2c/qspi/UART/timer control, pin control, firmware upgrades, flash cloning, etc., here, with no restrictions on the source code and no warranty whatsoever.  The skeleton source code project also includes a StickOS BASIC library, for evaluation purposes only, with no warranty whatsoever.  There may be missing file warnings you can ignore.

  • skeleton.zip
  • (v1.82)
    • for MPLAB 8.53 and PIC32MX3/PIC32MX4/PIC32MX7, open pic32.mcw
    • for CodeWarrior 7.2 and MCF5211/MCF52221/MCF52233/MCF52259, open project.mcp
    • for CodeWarrior 6.3 and MC9S08QE128/MCF51QE128/MCF51CN128/MCF51JM128, open flexis.mcp
    • for CodeWarrior 4.7 and MC9S12DT256/MC9S12DP512, open hcs12.mcp
  • skeleton.zip
  • (v1.84)
    • for MPLAB X & C32 v1.12 and PIC32MX3/PIC32MX4/PIC32MX7, open pic32.X
    • for CodeWarrior 7.2 and MCF5211/MCF52221/MCF52233/MCF52259, open project.mcp
    • for CodeWarrior 6.3 and MC9S08QE128/MCF51QE128/MCF51CN128/MCF51JM128, open flexis.mcp
    • for CodeWarrior 4.7 and MC9S12DT256/MC9S12DP512, open hcs12.mcp
  • skeleton.zip
  • (v1.92)
    • for MPLAB X & C32 v2.02 and PIC32MX3/PIC32MX4/PIC32MX7, open pic32.X
    • for CodeWarrior 10* and MCF5211/MCF52221/MCF52233/MCF52259*, open project.mcp
    • for CodeWarrior 6.3 and MC9S08QE128/MCF51QE128/MCF51CN128/MCF51JM128, open flexis.mcp
    • for CodeWarrior 4.7 and MC9S12DT256/MC9S12DP512, open hcs12.mcp
  • skeleton.zip (beta for MX2)

* Note that I am currently building MCF52259 v1.92 bits in CodeWarrior 10 with a hacked imported project that is not in the skeleton project, until the next release of CodeWarrior 10 when hopefully I can make a formal project.  For the TWR-MECH port of StickOS there is also a special StickOS_52259.a library to use all available flash.

To regenerate the compressed help in cpustick/basic0.c:

  1. don't change the #if 1 -- keep the "include help.c" live
  2. change the help inside the "dead" part of the #if (between GENERATE_HELP_BEGIN and GENERATE_HELP_END)
  3. download the Win32 version of StickOS: https://github.com/rtestardi/StickOS/downloads/StickOS.v1.82.exe
  4. in a shell window, cd to the cpustick directory
  5. run: "StickOS.v1.82.exe help <basic0.c >help.c"
  6. rebuild

Once you have your StickOS BASIC programs running, you can actually port them to C using the skeleton source code project and have identical functionality for MCU initialization, internal peripheral control, external pin control, zigflea wireless transport, etc., providing a very simple rapid prototyping environment!


keywords: rich testardi microcontroller hobby rapid prototype breadboard middle-school high-school university software development environment sde stickosbasic.com