Skip to content

Commit

Permalink
Merge pull request #579 from iRobotEducation/shamlian/fix-irobot-coding
Browse files Browse the repository at this point in the history
Update references to iRobot Education Bluetooth Protocol
  • Loading branch information
shamlian authored Apr 17, 2024
2 parents b00d113 + c4088b3 commit 94cbc28
Show file tree
Hide file tree
Showing 6 changed files with 11 additions and 9 deletions.
2 changes: 1 addition & 1 deletion .github/DISCUSSION_TEMPLATE/Questions.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ body:
- Wi-Fi (ROS 2)
- USB Ethernet (ROS 2)
- Wi-Fi and USB Ethernet (ROS 2)
- Bluetooth (iRobot Coding)
- Bluetooth (Python Playground)
- Bluetooth (Python SDK)
- Bluetooth (Other)
- I'm not sure
validations:
required: true
Expand Down
2 changes: 1 addition & 1 deletion docs/hw/adapter.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ If power is drawn through the USB-C® connector, then less power is available th

## USB/BLE Toggle
The **USB/BLE toggle** routes the robot's single USB Host connection either to the USB-C® port (useful for connecting to single-board computers with OTG or device ports) or to the on-board Bluetooth® Low Energy[^4] module.
This module can be used to interact with the [iRobot Education Python Web Playground](https://python.irobot.com/) or [iRobot Coding app](https://code.irobot.com).
This module can be used to interact with the [iRobot Education Python Web Playground](https://python.irobot.com/) or any other application supporting the iRobot Education Bluetooth® protocol.

## Indicators
### Orange Indicator
Expand Down
4 changes: 2 additions & 2 deletions docs/hw/face.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ Button 1 (to the left of center) is marked with a single dot (•).
If held for ten seconds, the robot will go into "standby" mode, keeping its charging circuitry active, and continuing to power the payload.
The robot can be placed on the dock to charge or to keep the payload alive in this mode.
To wake the robot from standby, hold the center button for one second.
Button presses can be accessed by the user in both ROS 2 and iRobot Coding / Bluetooth[^1] modes.
Button presses can be accessed by the user in both ROS 2 and iRobot Education Bluetooth[^1] modes.

### Button 2
Button 2 (to the right of center) is marked with two dots (••).
This button is a user button only.
Button presses can be accessed by the user in both ROS 2 and iRobot Coding / Bluetooth[^1] modes.
Button presses can be accessed by the user in both ROS 2 and iRobot Education Bluetooth[^1] modes.

### Center Button
The center button is marked with a power (⏻) icon.
Expand Down
2 changes: 1 addition & 1 deletion docs/hw/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The robot also ships with an iRobot® Home Base™ Charging Station.

![Create® 3 from its above-front-right, next to its dock.](data/front_iso.jpg "Robot Front")<br>
The front of the robot features a multizone bumper with seven pairs of IR proximity sensors, which can be used to detect obstacles.
The top of the robot contains three buttons which can all be overloaded by a ROS 2 application (only the • and •• buttons can be overloaded in the iRobot Coding app.)
The top of the robot contains three buttons which can all be overloaded by a ROS 2 application (only the • and •• buttons can be overloaded using the iRobot Education Bluetooth®[^1] protocol.)
The power button features a ring of six RGB LEDs for indication.

![Create® 3 from its above-rear-left, with the top cover and cargo bay removed.](data/rear_iso.jpg "Robot Rear")<br>
Expand Down
5 changes: 3 additions & 2 deletions docs/webserver/connect.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,13 @@ The connect page of the Create® 3 webserver allows the robot's name to be chang

The top of the connect page gives the robot's current IPv4 address.

The "Update Robot Names" box allows the user to change the robot's hostname (which can also be used to find the robot using mDNS) and its Bluetooth name (which can be used to find it in iRobot Coding.)
The "Update Robot Names" box allows the user to change the robot's hostname (which can also be used to find the robot using mDNS) and its Bluetooth name (which can be used to find it using the iRobot Education Bluetooth®[^1] protocol.)

The "Connect to a 2.4 GHz Wi-Fi Network" box allows the user to connect to any network the robot can perceive.
Clicking on the box to the right of "Type your Wi-Fi network name" should yield a drop-down of all available networks.

It may be necessary to change the drop-down for additional radio bands, depending on the region in which the robot is used.
If you are using the robot in Japan (JP), please select "Japan;" if you are using the robot in any of (AS, CA, FM, GU, KY, MP, PR, TW, UM, US, or VI), please select "North America."

[^1]: All trademarks mentioned are the property of their respective owners.
[^1]: The Bluetooth® word mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and any use of such marks by iRobot is under license.
[^2]: All trademarks mentioned are the property of their respective owners.
5 changes: 3 additions & 2 deletions docs/webserver/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The robot will get an IP address over DHCP as served by your network on its `wla
The webserver is available over http (port 80) in a browser by navigating to its IP address on whichever interface is active.

!!! attention
It is not recommended to run the robot's access point while also controlling the robot via ROS 2 or iRobot Coding.
It is not recommended to run the robot's access point while also controlling the robot via ROS 2 or the iRobot Education Bluetooth®[^2] protocol.

Please use the menu to navigate between sections of the webserver, or else navigate directly to the sections below:

Expand All @@ -30,4 +30,5 @@ Please use the menu to navigate between sections of the webserver, or else navig
- [About](../webserver/about.md)

[^1]: ROS 2 is governed by Open Robotics
[^2]: All other trademarks mentioned are the property of their respective owners.
[^2]: The Bluetooth® word mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and any use of such marks by iRobot is under license.
[^3]: All other trademarks mentioned are the property of their respective owners.

0 comments on commit 94cbc28

Please sign in to comment.