Documentation of python.irobot.com and irobot_edu_sdk?

[framlin]

Hello, first of all, create3 is a great learning and experimentation tool.
Saying that, I am wondering, if there is a detailed documentation of the python.irobot.com page and the irobot_edu_sdk?

Something, that explains, what is exactly going on, if I run one of the examples? Where does the python scripts run? What happens? What is the functionality/API of the SDK? Can I "destroy" the firmware of the create3 and so on and so forth?

[shamlian]

Hi there,
Thanks! We're doing our best. :)

When you run code in the iRobot® Python Web Playground or using the irobot_edu_sdk iRobot® Education Python® SDK (offline version now available here), you are interacting with the robot using Web Bluetooth using the Root Robot Bluetooth Low Energy Protocol. You are effectively teleoperating the robot over BLE. The robot translates between the BLE protocol and ROS 2 messages onboard. There is no danger of destroying anything on the Create 3 robot.

The SDK follows a similar syntax as Learning Level 3 of the iRobot® Coding App. You can use the coding app as a cheat sheet, or else clicking the "Docs" button on the right hand side in the iRobot® Python Web Playground will get you some detail on most of the commands.

Hope this helps!

[azbitak-invn]

Hello,

What is the difference between web bluetooth and the common one? It seems the bluetooth of the robot is only visbile from chrome web playground, but couldn't see if from usual bluetooth sniffers. Is it a manipulation to do to see robot bluetooth from any where ?

Thanks

[shamlian]

iRobot Education's robots communicate using a common Bluetooth Low Energy serial protocol, the details of which can be found here. The web browser uses a web-bluetooth backend while the native OS uses a Python cross-platform backend called bleak. Otherwise, they are nearly the same implementations of iRobot Coding Level 3.

[framlin]

Ahhh, ic.
Thank you very much.