This article is intended to help answer frequently asked questions about using Maker Toolkit!
What is the Maker Toolkit?
Maker Toolkit is an add-on on top of AppLab, our block-to-text app development environment. Maker Toolkit provides of a special set of commands that allow student apps to communicate with external hardware. Maker Toolkit is currently optimized to work with the AdafruitCircuitPlayground. CS Discoveries Physical Computing unit and the Creating Apps with Devices unit both involve the use of this Circuit Playground board.
What is the Adafruit Circuit Playground?
The Circuit Playground is a small microcontroller board with LEDs, buttons, and sensors built in. Based on the popular Arduino platform, the Circuit Playground enables students to get up and running quickly with physical computing without many of the traditional barriers to entry. You can read more about it on our Circuit Playground page here.
What are the software requirements for Maker Toolkit?
The Maker Toolkit is currently supported on Windows, Chrome OS, and Mac OS. There are slightly different software requirements depending on which OS you are using.
Windows:
- Google Chrome or Microsoft Edge web browser, which use the built-in WebSerial interface to connect.
- Adafruit Windows 7 driver (Windows 7 users only)
Chrome OS v89 and below:
Chrome OS v90 and above:
- No additional software needed - these Chromebooks use the built-in WebSerial interface to connect instead.
Mac OS:
- Google Chrome web browser, which uses the built-in WebSerial interface to connect.
How do I set up Maker Toolkit on my computer?
You can find the streamlined instructions to set up Maker Toolkit for your browser on the Maker Toolkit setup page. We have also provided the instructions below.
Windows / Mac OS Using Chrome or Edge Browsers:
The Circuit Playground can connect directly to computers using Google Chrome and Microsoft Edge browsers released after 2021.
- Connect your circuit playground to your computer
- Press the “Connect to Board” button below
- A window should pop up with a row that says “Circuit Playground”. Select that row, then click Connect
- The circuit playground should beep and you should see several green checkmarks below
If you have any issues, please refer to our WebSerial Support Article.
Chrome OS v90 and above on Chromebooks:
The Circuit Playground can connect directly to these Chromebooks without any additional software.
- Connect your circuit playground to your computer
- Press the “Connect to Board” button below
- A window should pop up with a row that says “Circuit Playground”. Select that row, then click Connect
- The circuit playground should beep and you should see several green checkmarks below
If you have any issues, please refer to our WebSerial Support Article.
Windows / Mac OS Using the Maker App:
Note: This method of connecting will be deprecated in the summer of 2023! Click here to learn more.
- Install the standalone Code.org Maker app. Get the latest download link for the app from here.
- Open up the Code.org Maker app and sign in to Code.org as you normally would on your browser.
- If you use Google to sign in, there are a few additional steps. Click here to learn how to sign in with Google on the Maker App
- Plug in your Circuit Playground board. You should now be ready to use Maker Toolkit with App Lab within the Code.org Maker App.
- Not working? Check out our section on "Debugging common issues" below.
Chrome OS v89 and below on Chromebooks:
Note: This method of connecting will be deprecated in the summer of 2023! Click here to learn more.
- Install the Code.org Serial Connector Chrome App extension.
- Plug in your Circuit Playground board. You should now be ready to use Maker Toolkit with App Lab within Google Chrome.
- If a dialog asking for permission for Code Studio to connect to the Chrome App pops up, click Accept.
- Not working? Check out our section on "Debugging common issues."
How do I enable Maker Toolkit in App Lab?
Maker Toolkit should already be enabled on relevant Code.org lessons. To enable it within a standalone App Lab project, follow these steps:
- Go to the App Lab project you want to use or create a new one.
- Click on the settings gear icon on the purple Toolbox header:
- Click "Enable Maker Toolkit."
- Click "Enable" in the warning dialog that pops up:
- You will know that Maker Toolkit is enabled if you two new categories in your toolbox called "Maker" and "Circuit."
If you decide that you want to disable Maker Toolkit, follow steps 2-3 above (except that the menu will say "Disable Maker Toolkit" instead).
Debugging common issues
If something seems to not be working on the App Lab webpage, try the following steps to work around issues that come up:
- Try refreshing the App Lab webpage.
- Try un-plugging and re-plugging the board, and refreshing the webpage.
- Double check that you followed all of the computer setup steps.
- Visit the Maker Toolkit setup page and make sure all the steps are lighting up as green (e.g. your board is showing up as connectable). Here’s how to get to the page:
- Windows / Mac OS: Click on the setup icon in the menu from the Maker Toolkit app:
- Chrome OS: Navigate to this page.
- Try updating the Circuit Playground firmware - instructions are at https://learn.adafruit.com/adafruit-circuit-playground-express/code-org-csd
- Check the list of common mistakes below.
Here are a list of common mistakes that lead to issues with connecting to Maker Toolkit:
- Having trouble connecting or having your board detected in the Maker App? Revisit the maker Setup page, and the 4-step connection test process (with up to 4 possible green checkmarks vs. red X's)
- If the first checkmark is green, but “Board plugged in” is red: they have a connection issue between the board and their computer. Try a different USB port, different USB cable, or different Circuit Playground board, or all of the above if possible.
- If the first two checkmarks are green, but “Board connectable” is red: we’re able to identify the board, but the board isn’t responding like a Circuit Playground with the Firmata firmware. You will need update the board’s firmware, after determining whether you are using an Express or Classic model board.
- If the back of the board says “express” anywhere on the back, or if the CPU is clocked at 48MHz it’s an Express board. The instructions for installing firmware on an Express are here: https://learn.adafruit.com/adafruit-circuit-playground-express/code-org-csd
- If the board does not say “express”, or otherwise mentions "Classic" or "Developer", the instructions for installing firmware on a Classic board are here: https://learn.adafruit.com/introducing-circuit-playground/set-up-test-arduino
- Note: The Maker App will be deprecated in the summer of 2023! Click here to learn more.
- Not getting a code to enter when trying to Log in with Google?
- If you are clicking on the "Log in with Google" button in the top panel within the Maker App, make sure you first sign out completely from Code.org in whichever browser(s) you have open on your computer. Then, click on that Log in with Google button again within the Maker App. You should then see this screen:
- Click on "Confirm", then you'll be asked to select and log in with a Google account of yours. You will then see a screen like this, with a code you can copy/paste to enter back on the Maker App:
Note: The Maker App will be deprecated in the summer of 2023! Click here to learn more.
If Prompted to Connect to a Serial Port
If a popup appears when you click "Run" that says "studio.code.org wants to connect to a serial port", this is due to a new feature that allows certain browsers to connect to Circuit Playground boards without requiring any additional installations. If you see this popup, it's prompting you to select a board to connect to. If you select a board from the list and click “Connect”, that browser tab will be connected to the board.
If you see the prompt above but still have issues connecting, try updating the Circuit Playground firmware - instructions are at https://learn.adafruit.com/adafruit-circuit-playground-express/code-org-csd
If you are still running into problems, email us at support@code.org!