circuitpython-org/connect/index.html
2022-01-13 20:27:55 +00:00

201 lines
8.6 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-7723544-8"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-7723544-8');
</script>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="icon" href="/assets/images/favicon.ico" type="image/x-icon" />
<meta name="msapplication-TileColor" content="#1a1919">
<meta name="msapplication-TileImage" content="https://cdn-shop.adafruit.com/static/mstile-144x144.png" />
<title>CircuitPython</title>
<meta name="description" content="The easiest way to program microcontrollers" />
<!-- Twitter and Open Graph cards -->
<meta name="twitter:site" content="@circuitpython" />
<meta property="og:url" content="https://circuitpython.org/connect/" />
<meta property="og:title" content="CircuitPython" />
<meta property="og:description" content="The easiest way to program microcontrollers" />
<meta name="twitter:card" content="summary" />
<meta property="og:image" content="https://circuitpython.org/assets/images/CircuitPythonLogo_Black.png" />
<meta property="og:type" content="website" />
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.5.0/css/all.css" integrity="sha384-B4dIYHKNBt8Bc12p+WXckhzcICo0wtJAoU8YZTY5qE0Id1GSseTk6S+L3BlXeVIU" crossorigin="anonymous">
<link rel="stylesheet" href="/assets/css/main.css">
<link rel="canonical" href="https://circuitpython.org/connect/">
<!-- CircuitPython RSS Feed -->
<link rel="alternate"
type="application/rss+xml"
title="CircuitPython news!"
href="https://blog.adafruit.com/category/circuitpython/feed/"/>
<link rel="alternate" type="application/rss+xml" title="Latest Boards" href="/feed.rss"/>
<script src="/assets/javascript/header_mobile.js"></script>
</head>
<body>
<header id="site-header">
<nav class="top-navigation">
<div>
<div class="navigation">
<a class="skip-link" href="#main-content">Skip to main content</a>
<a href="/contributing">Contributing</a>
<a href="https://blog.adafruit.com/category/circuitpython">News</a>
<a href="/awesome">Awesome</a>
<a href="https://www.adafruitdaily.com/category/circuitpython">Newsletter</a>
<a href="https://docs.circuitpython.org/">Documentation</a>
<a href="https://forums.adafruit.com/viewforum.php?f=60">Forums</a>
<a href="https://adafru.it/discord" aria-label="Discord"><i class="fab fa-discord"></i> Discord</a>
<a href="/feed.rss" type="application/rss+xml" aria-label="RSS Feed"><i class="fas fa-rss-square"></i> RSS</a>
</div>
</div>
</nav>
<div class="wrapper">
<div class="content">
<nav class="site-brand">
<div class="site-logo">
<a href="/">
<img src="/assets/images/logo.png"
srcset="/assets/images/logo.png 1x,
/assets/images/logo@2x.png 2x,
/assets/images/logo@3x.png 3x"
alt="CircuitPython Logo"
height="60" width="136">
</a>
</div>
<div class="site-navigation">
<a href="/downloads">Downloads</a>
<a href="/libraries">Libraries</a>
<a href="/blinka">Blinka</a>
</div>
<div class="get-started">
<a href="https://learn.adafruit.com/welcome-to-circuitpython">Get Started</a>
</div>
</nav>
</div>
</div>
<div class="bottom-bar"></div>
</header>
<header id="mobile-header">
<div class="header-contents">
<div class="site-logo">
<a href="/">
<img src="/assets/images/logo.png"
srcset="/assets/images/logo.png 1x,
/assets/images/logo@2x.png 2x,
/assets/images/logo@3x.png 3x"
alt="CircuitPython Logo"
height="60" width="136">
</a>
</div>
<div id="mobile-menu">
<div class="menu-toggle">
<a href="#" id="mobile-menu-button">
<span class="sr-only">Open Mobile Menu</span>
<i class="fa fa-bars" aria-hidden="true"></i>
</a>
</div>
</div>
<div class="clear"></div>
<nav id="mobile-menu-contents" role="navigation" class="hidden"
aria-expanded="false" aria-label="Mobile Menu">
<ul>
<li><a
href="/downloads">Downloads</a></li>
<li><a
href="/libraries">Libraries</a></li>
<li><a
href="/blinka">Blinka</a></li>
<li><a
href="/contributing">Contributing</a></li>
<li><a href="https://blog.adafruit.com/category/circuitpython">News</a></li>
<li><a
href="/awesome">Awesome</a></li>
<li><a href="https://www.adafruitdaily.com/category/circuitpython">Newsletter</a></li>
<li><a href="https://learn.adafruit.com/welcome-to-circuitpython">Get Started</a></li>
<li><a href="https://forums.adafruit.com/viewforum.php?f=60">Forums</a></li>
<li><a href="https://adafru.it/discord" aria-label="Discord"><i class="fab fa-discord"></i> Discord</a></li>
</ul>
</nav>
</div>
<div class="bottom-bar"></div>
</header>
<div id="main-content" class="wrapper">
<div id="common-page" class="common-layout">
<div class="content">
<h1 id="overview">Overview</h1>
<p>Starting with CircuitPython 7, there are a couple of ways of connecting to a CircuitPython board and editing files. We call these “workflows”. The classic workflow is over USB where the CircuitPython board appears as a <code class="language-plaintext highlighter-rouge">CIRCUITPY</code> drive with all of the code files on it. The second way to connect is wirelessly over Bluetooth Low Energy (BLE). Unlike USB, BLE works better with phones and tablets.</p>
<h2 id="usb">USB</h2>
<p>To connect to CircuitPython over USB, connect the USB cable from the CircuitPython board to your computer. The two most common mistakes are:</p>
<ol>
<li>Expecting CIRCUITPY before loading CircuitPython onto the device.</li>
<li>Using a USB cable that only connects the power wires. Double check any new cable with a working device. With your first device, try multiple cables.</li>
</ol>
<p>See the <a href="https://learn.adafruit.com/welcome-to-circuitpython">Welcome to CircuitPython guide</a> for more details and troubleshooting.</p>
<h2 id="ble">BLE</h2>
<p>Bluetooth Low Energy (BLE) doesnt have standard for transferring files. As a result, operating systems dont have built in support for the protocol CircuitPython uses. Instead, youll need to use an app or webpage designed for the file transfer protocol.</p>
<h3 id="pyleap">PyLeap</h3>
<p>PyLeap is an iOS app by Adafruit designed to quickly get you started by loading existing projects onto your device. These projects are from <a href="https://learn.adafruit.com">learn.adafruit.com</a>.</p>
<p>Get PyLeap through Apples beta testing app TestFlight <a href="https://adafru.it/pyleap">here</a>.</p>
<p>PyLeap is openly developed <a href="https://github.com/adafruit/PyLeap-iOS">on GitHub</a>.</p>
<h3 id="file-glider">File Glider</h3>
<p>File Glider is an iOS app by Adafruit designed to interoperate with iOSs files API. Files can be edited directly in File Glider or indirectly in other Files API compatible apps. The app is not CircuitPython specific so it can be used with any file transfer capable device.</p>
<p>Get File Glider through Apples beta testing app TestFlight <a href="https://adafru.it/file-glider">here</a>.</p>
<p>File Glider is openly developed <a href="https://github.com/adafruit/Glider-for-iOS">on GitHub</a>.</p>
<h3 id="codecircuitpythonorg">code.circuitpython.org</h3>
<p><a href="https://code.circuitpython.org">code.circuitpython.org</a> is a webapp designed by Adafruit to edit files over WebBluetooth in Chrome. This works on the latest Chrome on desktop and on Android.</p>
<p>Go to <a href="https://code.circuitpython.org">code.circuitpython.org</a> to get started.</p>
<p>The web editor is openly developed <a href="https://github.com/circuitpython/web-editor">on GitHub</a>.</p>
</div>
</div>
</div>
<!-- Google Analytics -->
<!-- TODO -->
<!-- End Google Analytics -->
</body>
</html>