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