This repository has been archived by the owner on May 2, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
/
index.html
281 lines (252 loc) · 13.1 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
<html>
<head>
<title>Scratch Create 2 Extension</title>
<link rel="stylesheet" type="text/css" href="style.css">
</head>
<body>
<div id="main_content" class="index">
<a href="http://www.irobot.com/About-iRobot/STEM/Create-2.aspx" target="_blank"></li>
<img height="285" width="632" src="images/iRobotCreate2-Title.png"></a>
<h1>Contents</h1>
<ul>
<li><a href="#intro" class="listlink" >Introduction</a></li>
<li><a href="#equipment" class="listlink" >Equipment</a></li>
<li><a href="#started" class="listlink" >Getting Started</a></li>
<li><a href="#blocks" class="listlink" >Scratch Blocks</a></li>
<li><a href="#examples" class="listlink" >Example Projects</a></li>
<li><a href="#sensors" class="listlink" >Sensors</a></li>
<li><a href="#troubleshoot" class="listlink" >Troubleshooting</a></li>
</ul>
<br />
<br />
<h1><a name="intro" class="title-btn title-margin-bottom">Introduction</a></h1>
<p>Create 2 is an affordable STEM resource for educators, students and developers. Use Create to grasp the fundamentals of robotics, computer science and engineering. Ready to get hacking?</p>
<br /><br />
<h1><a name="equipment" class="title-btn title-margin-bottom">Equipment</a></h1>
<p>What you will need to use this extension:</p>
<ul>
<li>The <a href="http://www.irobot.com/About-iRobot/STEM/Create-2.aspx" class="listlink">iRobot Create 2 Programmable Robot</a></li>
<li>The <a href="http://store.irobot.com/communication-cable-create-2/product.jsp?productId=54235746&cp=3335976&parentPage=family" class="listlink">Communication Cable for The Create 2</a> (Comes with the Create 2 Robot)</a></li>
</ul>
<br /><br />
<h1><a name="started" class="title-btn title-margin-bottom">Getting Started</a></h1>
Now that you have the hardware, follow these few steps and you'll be controlling a robot in no time!
<ol>
<li>Install the latest version of <a href="https://get.adobe.com/flashplayer/otherversions/" class="listlink">Adobe flash</a></li>
<li>Install the <a href="https://www.mozilla.org/en-US/firefox/organizations/all/" class="listlink">32 bit ESR version of Firefox</a>. This is the only browser that works with the Scratch plugin</li>
<li>Install the <a href="https://scratch.mit.edu/info/ext_download/" class="listlink" >Scratch Extension Browser Plugin</a></li>
<li>Connect the Communication Cable to the Create 2 robot and your computer.</li>
<ul>
<li>Note: It may take a minute for the drivers to install the first time you connect the cable.</li>
</ul>
<li>Make sure the robot is on (indicated by the Clean button LED). If it is not, press the button once to turn it on.</li>
<ul>
<li>Note: If the Clean button LED is red, the robot needs to be charged.</li>
</ul>
<li><a href="http://scratchx.org/?url=http://iRobotSTEM.github.io/CreateScratchX/roomba600Extension.js" class="listlink" target="_blank" >Load the Create 2 extension on ScratchX</a></li>
</ol>
<table width="600" border="0" cellspacing="3" cellpadding="7">
<tbody>
<tr>
<td><img height="190" src="images/roombaConnected.png" style="border:#64a70b; border-width:thin" /></td>
<td><img src="images/greenarrow.png" width="10" height="19" /></td>
<td>When you see the indicator light in the <strong>More Blocks</strong> tab turn green you're ready to robot!</td>
</tr>
<tr>
<td><img height="170" src="images/dirtDetect.png" style="border:#64a70b; border-width:thin" /> </td>
<td><img src="images/greenarrow.png" width="10" height="19" alt=""/></td>
<td>The blue <q>Dirt Detect</q> light should also be on to indicate the robot is ready as well.</td>
</tr>
</tbody>
</table>
<p>At this point you are ready to start programming with the <a name="blocks" class="listlink" >Scratch Blocks</a> below. Use these <a href="#examples" class="listlink" >Example Projects</a> and <a href="#sensors" class="listlink" >Sensor Diagrams</a> to help you get started.</p>
<p> </p>
<h1><a class="title-btn title-margin-bottom" name="blocks">Scratch Blocks</a></h1>
<p>Here is a short description of each of the blocks included in this extension:</p>
<table width="700" border="0" bordercolor="64a70b" cellspacing="3" cellpadding="7" >
<tbody>
<tr>
<td colspan="2">
<hr>
</td></tr>
<td width="100"><img height="52" src="images/blocks/when-sensor.png" />
</td>
<td width="250"><p>Runs when the selected robot sensor is triggered. The selectable sensors include wall and cliff detection.</p>
</td>
</tr>
<tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/when-press.png" /></td>
<td><p>Runs when the selected robot button or bumper is pressed.</p></td>
</tr>
<tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/sensor-read.png" /></td>
<td><p>Checks if the selected robot sensor is triggered. The selectable sensors include wall and cliff detection.</p></td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/press-read.png" /></td>
<td><p>Checks if the selected robot button or bumper is pressed.</p></td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><a name="set-tempo">
<img height="52" src="images/blocks/set-tempo.png" />
</td>
<td><p>Sets the tempo in beats per minute that the robot will play notes sent by the <a name="play-note" class="listlink" >Play Note Block</a> at.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><a name="play-note">
<img height="100" src="images/blocks/play-note.png" /></td>
<td><p>Plays the selected note for the selected beats through the robot speaker at the tempo selected in the <a name="set-tempo" class="listlink" >Set Tempo block</a>. If you click the down arrow next to the note number, it will drop a piano roll down to make note selection easier.</p></td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><a name="set-speed">
<img height="52" src="images/blocks/set-drive-speed.png" />
</td>
<td><p>Sets the speed the robot will drive at. The valid range for the drive speed is between 0% (stopped) and 100% (full speed). The default speed is 100%. Note: The robot will not drive until one of the drive blocks below is sent.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/drive.png" /></td>
<td><p>Drives the robot at the most recently selected drive speed from the <a name="set-speed" class="listlink" >Set Drive Speed Block</a>.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/drive-distance.png" /></td>
<td><p>Drives the robot at the most recently selected drive speed from the <a name="set-speed" class="listlink" >Set Drive Speed Block</a> for the given distance. The distance must be between -1500 and 1500 cm. Note: A negative distance will drive the robot backwards and a positive distance forward.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/turn-ccw.png" /></td>
<td><p>Turns the robot in place counter-clockwise the given number of degrees. The degrees must be between 0 and 360 (one full rotation).</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/turn-cw.png" /></td>
<td><p>Turns the robot in place clockwise the given number of degrees. The degrees must be between 0 and 360 (one full rotation).</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/stop-driving.png" /></td>
<td><p>Stops the robot from moving. This includes driving forward and turning.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/set-led.png" /></td>
<td><p>Turns the selected robot LED on or off.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/set-display.png" /></td>
<td><p>Displays the 4 digits on the robot display. Each digit must be a single character.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/set-clean-brightness.png" /></td>
<td><p>Set the brightness of the Clean button LED. The brightness must be between 0 (off) and 100% (full).</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/set-clean-color.png" /></td>
<td><p>Set the color of the Clean button LED.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
<tr>
<td><img height="52" src="images/blocks/dock.png" /></td>
<td><p>Start a robot docking mission. The 'leave' dock mission must be run to safely drive the robot off the dock. The 'go to' dock mission should only be run if the robot is near the charging dock. Please be aware that this may cause the robot to drive away from your computer and pull or damage the Communication Cable.</p>
</td>
</tr> <tr>
<td colspan="2">
<hr>
</td></tr>
</tbody>
</table>
<br /><br />
<h1><a name="examples" class="title-btn title-margin-bottom">Example Projects</a></h1>
<ul>
<li><a href="http://scratchx.org/?url=http://irobotstem.github.io/CreateScratchX/examples/Create%20Example%20-%20Tethered%20Driving.sbx#scratch" class="listlink" >Tethered Driving</a></li>
<li><a href="http://scratchx.org/?url=http://irobotstem.github.io/CreateScratchX/examples/Create%20Example%20-%20Square.sbx#scratch" class="listlink" >Drive in a square</a></li>
<li><a href="http://scratchx.org/?url=http://irobotstem.github.io/CreateScratchX/examples/Create%20Example%20-%20Play%20Song.sbx#scratch" class="listlink" >Play a song</a></li>
<li><a href="http://scratchx.org/?url=http://irobotstem.github.io/CreateScratchX/examples/Create%20Example%20-%20Display%20and%20Blink%20LED.sbx#scratch" class="listlink" >Display Characters and Blink LEDs</a></li>
<li><a href="http://scratchx.org/?url=http://irobotstem.github.io/CreateScratchX/examples/Create%20Example%20-%20Zoom%20Clean.sbx#scratch" class="listlink" >Zoom Clean Button LED</a></li>
</ul>
<br /><br />
<h1><a name="sensors" class="title-btn title-margin-bottom">Sensors</a></h1>
<p>Below are diagrams of where the sensors and LEDs included in the Create 2 Scratch Extension are located on the robot. Blue indicates buttons and LEDs. Green indicates other sensors, such as bumper presses and wall detection.</p>
<a href="images/Create-Sensors.png"><img height="450" src="images/Create-Sensors.png" /></a>
<a href="images/Create-Wallsensor.png"><img height="450" src="images/Create-Wallsensor.png" /></a>
<br /><br />
<h1><a name="troubleshoot" class="title-btn title-margin-bottom">Troubleshooting</a></h1>
If you run into issues controlling the Create 2 robot using Scratch, here's a few items to check to make sure your setup is correct and the robot is ready:
<ul>
<li>Make sure you are using the <a href="https://www.mozilla.org/en-US/firefox/organizations/faq/" class="listlink">32 bit ESR version of Firefox</a>. This is the only supported browser for Scratch. Note that the 64 bit ESR version does not work with the scratch plugin. See <a href="https://support.mozilla.org/en-US/kb/npapi-plugins" class="listlink">https://support.mozilla.org/en-US/kb/npapi-plugins</a>
<li>Make sure the latest version of <a href="https://get.adobe.com/flashplayer/otherversions/" class="listlink">Adobe flash</a> is installed. Older versions can be incompatible with Scratch.
<li>Make sure the robot is fully charged (indicated by a the Clean button LED being green).</li>
<ul>
<li>If it is not charged, the robot may experience communication issues which can result in the blocks not performing the desired functionality.</li>
</ul>
<li>Make sure the Communication Cable is fully connected.</li>
<ul>
<li>It's possible that the cable may come loose while driving the robot around. If this happens, then the robot will no longer be able to receive commands from Scratch</li>
</ul>
<li>Make sure the robot is turned on</li>
<ul>
<li>If the robot is turned off when you open the extension in Scratch, it will not be able to connect to the robot and the indicator light in Scratch will not turn green. To prevent this from happening, turn the robot on before opening Scratch. After the robot is on (indicated by the Clean button LED being green), you can then open the extension in Scratch</li>
</ul>
<li>Make sure your browser is not blocking the Scratch Browser Plugin</li>
<li>If all else fails, reset the robot and browser and try again</li>
<ul>
<li>Sometimes the robot may get out of sync with Scratch. If none of the above steps worked, starting fresh may solve the problem. To reset the robot, hold the Spot and Dock buttons at the same time for 10 seconds or take the battery out and replace it. After the robot resets, turn it on and then open the extension in Scratch again.</li>
</ul>
</ul>
<br />
<h2>Still have questions? </h2><a class="title-btn title-margin-bottom" href="mailto:[email protected]">Email Us</a></p>