Skip to content

Commit

Permalink
Updated firmware's readme.
Browse files Browse the repository at this point in the history
  • Loading branch information
jeffam70 committed Jan 14, 2019
1 parent b1ffdab commit e1badbe
Showing 1 changed file with 29 additions and 27 deletions.
56 changes: 29 additions & 27 deletions firmware/readme.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,8 @@
# This folder contains Propeller-based firmware for the cyber:bot product.

## Using BlocklyProp
### Make sure you have an account and that the appropriate client/launcher software is installed on your computer
[Getting Started with BlocklyProp](http://learn.parallax.com/tutorials/language/blocklyprop/getting-started-blocklyprop)

### Open the project and load it to your cyber:bot
## _As of this writing, the BlocklyProp contains old firmware, so the SimpleIDE method is recommended here._

1. Connect the cyber:bot board to a 6 to 24 VDC power supply, and turn on the power switch (position 1 or 2)

2. Connect the Prop Plug to the computer, through a USB cable, and connect to the cyber:bot board
* If you have an adapter, connect the Prop Plug, the adapter, and the cyber:bot board using [this orientation](https://github.com/parallaxinc/cyberbot/blob/master/firmware/Adapter.jpg)
* If you don't have an adapter, use the same header, but use jumper wires to make the following connections:
* VSS - The pin closest to the center of the micro:bit board
* !RES - The pin immediately to the left of VSS
* <TX - The pin immediately below *and* to the left of VSS
* \>RX - The pin immediately below VSS

3a. [Open version 0.1](http://demo.blockly.parallax.com/blockly/projectlink?id=2104&key=39344de2-50c5-4bcc-afc4-0414d3de5055) on the Demo site.

3b. [Open version 0.2](http://blockly.parallax.com/blockly/projectlink?id=64207&key=5e20817a-ea20-4ee8-a178-a1ea6137dc93) on the main Blockly site.

3c. [Open version 0.3](http://demo.blockly.parallax.com/blockly/projectlink?id=2123&key=6b8fd72f-054e-4e60-9245-00b3316603c4) on the Demo site.

4. Click the green down-arrow with the bar to load the code to EEPROM.

## Using SimpleIDE
# Updating Your micro:bit Firmware Using SimpleIDE

1. Make sure you have the latest version of SimpleIDE.
* Mac: Open SimpleIDE, click the SimpleIDE menu, and select About SimpleIDE.
Expand All @@ -45,10 +23,34 @@

3. Connect a Prop Plug as indicated in the instructions above.

4. Download and open the MicroBit Bot Firmware v0_3 project in SimpleIDE.
* Method 1: Create a new project in SimpleIDE, and then paste in the code from [MicroBit Bot Firmware v0_3.c](https://github.com/parallaxinc/cyberbot/blob/master/firmware/MicroBit%20Bot%20Firmware%20v0_3.c).
* Method 2: Save the files in these two links to the same folder. [MicroBit Bot Firmware v0_3.c](https://github.com/parallaxinc/cyberbot/blob/master/firmware/MicroBit%20Bot%20Firmware%20v0_3.c) and [MicroBit Bot Firmware v0_3.side](https://github.com/parallaxinc/cyberbot/blob/master/firmware/MicroBit%20Bot%20Firmware%20v0_3.side). Then, open the .side file with SimpleIDE.
4. Open the MicroBit Bot Firmware project in SimpleIDE.
* Method 1: Download and extract the _firmware_ folder contents from the [releases page](https://github.com/parallaxinc/cyberbot/releases) or, for Git users, use your local clone's /firmware folder. Then, open the _.side_ file with SimpleIDE.
* Method 2: Create a new project in SimpleIDE, and then paste in the _.c_ code from the _firmware_ folder contents of the [releases page](https://github.com/parallaxinc/cyberbot/releases).

5. Set SimpleIDE's COM Port dropdown to your PropPlug's port.

6. Click the Load EEPROM & Run button (or select Load EEPROM & Run F11 from the Program menu).

# Updating Your micro:bit Firmware Using BlocklyProp
### Make sure you have an account and that the appropriate client/launcher software is installed on your computer
[Getting Started with BlocklyProp](http://learn.parallax.com/tutorials/language/blocklyprop/getting-started-blocklyprop)

### Open the project and load it to your cyber:bot

1. Connect the cyber:bot board to a 6 to 24 VDC power supply, and turn on the power switch (position 1 or 2)

2. Connect the Prop Plug to the computer, through a USB cable, and connect to the cyber:bot board
* If you have an adapter, connect the Prop Plug, the adapter, and the cyber:bot board using [this orientation](https://github.com/parallaxinc/cyberbot/blob/master/firmware/Adapter.jpg)
* If you don't have an adapter, use the same header, but use jumper wires to make the following connections:
* VSS - The pin closest to the center of the micro:bit board
* !RES - The pin immediately to the left of VSS
* <TX - The pin immediately below *and* to the left of VSS
* \>RX - The pin immediately below VSS

3a. [Open version 0.1](http://demo.blockly.parallax.com/blockly/projectlink?id=2104&key=39344de2-50c5-4bcc-afc4-0414d3de5055) on the Demo site.

3b. [Open version 0.2](http://blockly.parallax.com/blockly/projectlink?id=64207&key=5e20817a-ea20-4ee8-a178-a1ea6137dc93) on the main Blockly site.

3c. [Open version 0.3](http://demo.blockly.parallax.com/blockly/projectlink?id=2123&key=6b8fd72f-054e-4e60-9245-00b3316603c4) on the Demo site.

4. Click the green down-arrow with the bar to load the code to EEPROM.

0 comments on commit e1badbe

Please sign in to comment.