1<!doctype html> 2<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-web-configurator/web-configurator" data-has-hydrated="false"> 3<head> 4<meta charset="UTF-8"> 5<meta name="generator" content="Docusaurus v3.9.2"> 6<title data-rh="true">GP2040-CE Web Configurator | GP2040-CE</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" property="og:image" content="https://gp2040-ce.info/img/gp2040-ce-social-card.png"><meta data-rh="true" name="twitter:image" content="https://gp2040-ce.info/img/gp2040-ce-social-card.png"><meta data-rh="true" property="og:url" content="https://gp2040-ce.info/web-configurator/"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="twitter:card" content="summary"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="GP2040-CE Web Configurator | GP2040-CE"><meta data-rh="true" name="description" content="GP2040-CE's Web-Based Configuration Application: Just hold S2 on boot or hold S2+B3+B4 while already plugged in. Then go to http://192.168.7.1 to access the Web Configurator."><meta data-rh="true" property="og:description" content="GP2040-CE's Web-Based Configuration Application: Just hold S2 on boot or hold S2+B3+B4 while already plugged in. Then go to http://192.168.7.1 to access the Web Configurator."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://gp2040-ce.info/web-configurator/"><link data-rh="true" rel="alternate" href="https://gp2040-ce.info/web-configurator/" hreflang="en"><link data-rh="true" rel="alternate" href="https://gp2040-ce.info/web-configurator/" hreflang="x-default">
6<script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"GP2040-CE Web Configurator","item":"https://gp2040-ce.info/web-configurator/"}]}</script>
6<link rel="stylesheet" href="/assets/css/styles.5f1e31eb.css">
7<script src="/assets/js/runtime~main.3cbe0a28.js" defer="defer"></script>
vendor: 1 bytes, line 7
7
8<script src="/assets/js/main.d1af1dd6.js" defer="defer"></script>
8 9</head> 10<body class="navigation-with-keyboard"> 11<svg style="display: none;"><defs> 12<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol> 13</defs></svg>
14<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const n=new URLSearchParams(window.location.search).entries();for(var[t,e]of n)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}(),document.documentElement.setAttribute("data-announcement-bar-initially-dismissed",function(){try{return"true"===localStorage.getItem("docusaurus.announcement.dismiss")}catch(t){}return!1}())</script>
14<div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><div class="theme-announcement-bar announcementBar_mb4j" style="background-color:#ec008c;color:#FFFFFF" role="banner"><div class="announcementBarPlaceholder_vyr4"></div><div class="content_knG7 announcementBarContent_xLdY">New Version Available! To get the v0.7.12 update, go to <a href="https://github.com/OpenStickCommunity/GP2040-CE/releases/tag/v0.7.12" target="_blank">GP2040-CE Releases<a></a></div><button type="button" aria-label="Close" class="clean-btn close closeButton_CVFx announcementBarClose_gvF7"><svg viewBox="0 0 15 15" width="14" height="14"><g stroke="currentColor" stroke-width="3.1"><path d="M.75.75l13.5 13.5M14.25.75L.75 14.25"></path></g></svg></button></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/gp2040-ce-logo.png" alt="GP2040-CE Logo" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/gp2040-ce-logo.png" alt="GP2040-CE Logo" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a class="navbar__item navbar__link" docid="introduction" href="/introduction">Documentation</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" docid="introduction" href="/web-configurator/">Web Config</a><a class="navbar__item navbar__link" href="/development/contribution-guide">Contribute</a><a class="navbar__item navbar__link" href="/downloads">Downloads</a><a href="https://discord.gg/k2pxhke7q8" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link navbar-discord-link" aria-label="Discord Invite"></a><a href="https://github.com/OpenStickCommunity/GP2040-CE" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link navbar-github-link" aria-label="GitHub Repository"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP systemToggleIcon_QzmC">
14<path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><div class="navbar__search searchBarContainer_NW3z" dir="ltr"><input placeholder="Search" aria-label="Search" class="navbar__search-input" value=""><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG menuWithAnnouncementBar_GW3s"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" href="/web-configurator/"><span title="GP2040-CE Web Configurator" class="linkLabel_WmDU">GP2040-CE Web Configurator</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" href="/web-configurator/menu-pages/home"><span title="Web Configurator Menu" class="categoryLinkLabel_W154">Web Configurator Menu</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/home"><span title="Home" class="linkLabel_WmDU">Home</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/settings"><span title="Settings" class="linkLabel_WmDU">Settings</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/gpio-pin-mapping"><span title="GPIO Pin Mapping" class="linkLabel_WmDU">GPIO Pin Mapping</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/peripheral-mapping"><span title="Peripheral Mapping" class="linkLabel_WmDU">Peripheral Mapping</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/led-configuration"><span title="LED Configuration" class="linkLabel_WmDU">LED Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/custom-led-theme"><span title="Custom LED Theme" class="linkLabel_WmDU">Custom LED Theme</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/display-configuration"><span title="Display Configuration" class="linkLabel_WmDU">Display Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/add-ons-configuration"><span title="Add-Ons Configuration" class="linkLabel_WmDU">Add-Ons Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/macros"><span title="Macro Settings" class="linkLabel_WmDU">Macro Settings</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/data-backup-restoration"><span title="Data Backup and Restoration" class="linkLabel_WmDU">Data Backup and Restoration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/web-configurator/menu-pages/reset-sett
14ings"><span title="Reset Settings" class="linkLabel_WmDU">Reset Settings</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="true" href="/add-ons/analog"><span title="Add-Ons" class="categoryLinkLabel_W154">Add-Ons</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/analog"><span title="Analog" class="linkLabel_WmDU">Analog</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/bootsel-button"><span title="BOOTSEL Button Configuration" class="linkLabel_WmDU">BOOTSEL Button Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/buzzer-speaker"><span title="Buzzer Speaker" class="linkLabel_WmDU">Buzzer Speaker</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/drv8833-rumble"><span title="DRV8833 Rumble Configuration" class="linkLabel_WmDU">DRV8833 Rumble Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/dual-direction-input"><span title="Dual Directional Input" class="linkLabel_WmDU">Dual Directional Input</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/focus-mode"><span title="Focus Mode Configuration" class="linkLabel_WmDU">Focus Mode Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/gamepad-usb-host"><span title="Gamepad USB Host" class="linkLabel_WmDU">Gamepad USB Host</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/hall-effect-trigger"><span title="Hall-Effect Trigger" class="linkLabel_WmDU">Hall-Effect Trigger</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/i2c-analog-ads1219"><span title="I2C Analog ADS1219" class="linkLabel_WmDU">I2C Analog ADS1219</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/i2c-analog-ads1256-spi"><span title="Analog ADS1256-SPI" class="linkLabel_WmDU">Analog ADS1256-SPI</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/input-history"><span title="Input History" class="linkLabel_WmDU">Input History</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/input-reverse"><span title="Input Reverse" class="linkLabel_WmDU">Input Reverse</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/keyboard-mouse-host"><span title="Keyboard/Mouse Host Configuration" class="linkLabel_WmDU">Keyboard/Mouse Host Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/on-board-led"><span title="On-board LED Configuration" class="linkLabel_WmDU">On-board LED Configuration</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/pcf8575-io-expander"><span title="PCF8575 IO Expander" class="linkLabel_WmDU">PCF8575 IO Expander</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/reactive-led"><span title="Reactive LEDs" class="linkLabel_WmDU">Reactive LEDs</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/rotary-encoders"><span title="Rotary Encoders" class="linkLabel_WmDU">Rotary Encoders</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/snes-input"><span title="SNES Input" class="linkLabel_WmDU">SNES Input</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/socd-selection-sli
14der"><span title="SOCD Selection Slider" class="linkLabel_WmDU">SOCD Selection Slider</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/tilt-input"><span title="Tilt Input" class="linkLabel_WmDU">Tilt Input</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/turbo"><span title="Turbo" class="linkLabel_WmDU">Turbo</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/add-ons/wii-extensions"><span title="Wii Extensions" class="linkLabel_WmDU">Wii Extensions</span></a></li></ul></li></ul></nav><button type="button" title="Collapse sidebar" aria-label="Collapse sidebar" class="button button--secondary button--outline collapseSidebarButton_PEFL"><svg width="20" height="20" aria-hidden="true" class="collapseSidebarButtonIcon_kv0_"><g fill="#7a7a7a"><path d="M9.992 10.023c0 .2-.062.399-.172.547l-4.996 7.492a.982.982 0 01-.828.454H1c-.55 0-1-.453-1-1 0-.2.059-.403.168-.551l4.629-6.942L.168 3.078A.939.939 0 010 2.528c0-.548.45-.997 1-.997h2.996c.352 0 .649.18.828.45L9.82 9.472c.11.148.172.347.172.55zm0 0"></path><path d="M19.98 10.023c0 .2-.058.399-.168.547l-4.996 7.492a.987.987 0 01-.828.454h-3c-.547 0-.996-.453-.996-1 0-.2.059-.403.168-.551l4.625-6.942-4.625-6.945a.939.939 0 01-.168-.55 1 1 0 01.996-.997h3c.348 0 .649.18.828.45l4.996 7.492c.11.148.168.347.168.55zm0 0"></path></g></svg></button></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">GP2040-CE Web Configurator</span></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>GP2040-CE Web Configurator</h1></header> 15<p>Select the button labels to be displayed in the usage guide:</p> 16<style data-emotion="css b62m3t-container">.css-b62m3t-container{position:relative;box-sizing:border-box;}</style><div class="labelSelector_RmTm css-b62m3t-container"><style data-emotion="css 7pg0cj-a11yText">.css-7pg0cj-a11yText{z-index:9999;border:0;clip:rect(1px, 1px, 1px, 1px);height:1px;width:1px;position:absolute;overflow:hidden;padding:0;white-space:nowrap;}</style><span id="react-select-11-live-region" class="css-7pg0cj-a11yText"></span><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" role="log" class="css-7pg0cj-a11yText"></span><style data-emotion="css 13cymwt-control">.css-13cymwt-control{-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;cursor:default;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-flex-wrap:wrap;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:justify;-webkit-justify-content:space-between;justify-content:space-between;min-height:38px;outline:0!important;position:relative;-webkit-transition:all 100ms;transition:all 100ms;background-color:hsl(0, 0%, 100%);border-color:hsl(0, 0%, 80%);border-radius:4px;border-style:solid;border-width:1px;box-sizing:border-box;}.css-13cymwt-control:hover{border-color:hsl(0, 0%, 70%);}</style><div class="css-13cymwt-control"><style data-emotion="css hlgwow">.css-hlgwow{-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;display:grid;-webkit-flex:1;-ms-flex:1;flex:1;-webkit-box-flex-wrap:wrap;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-overflow-scrolling:touch;position:relative;overflow:hidden;padding:2px 8px;box-sizing:border-box;}</style><div class="css-hlgwow"><style data-emotion="css 1dimb5e-singleValue">.css-1dimb5e-singleValue{grid-area:1/1/2/3;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:hsl(0, 0%, 20%);margin-left:2px;margin-right:2px;box-sizing:border-box;}</style><div class="css-1dimb5e-singleValue">GP2040</div><style data-emotion="css 19bb58m">.css-19bb58m{visibility:visible;-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto;display:inline-grid;grid-area:1/1/2/3;grid-template-columns:0 min-content;margin:2px;padding-bottom:2px;padding-top:2px;color:hsl(0, 0%, 20%);box-sizing:border-box;}.css-19bb58m:after{content:attr(data-value) " ";visibility:hidden;white-space:pre;grid-area:1/2;font:inherit;min-width:2px;border:0;margin:0;outline:0;padding:0;}</style><div class="css-19bb58m" data-value=""><input class="" style="label:input;color:inherit;background:0;opacity:1;width:100%;grid-area:1 / 2;font:inherit;min-width:2px;border:0;margin:0;outline:0;padding:0" autocapitalize="none" autocomplete="off" autocorrect="off" id="react-select-11-input" spellcheck="false" tabindex="0" type="text" aria-autocomplete="list" aria-expanded="false" aria-haspopup="true" role="combobox" aria-activedescendant="" value=""></div></div><style data-emotion="css 1wy0on6">.css-1wy0on6{-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-align-self:stretch;-ms-flex-item-align:stretch;align-self:stretch;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;box-sizing:border-box;}</style><div class="css-1wy0on6"><style data-emotion="css 1u9des2-indicatorSeparator">.css-1u9des2-indicatorSeparator{-webkit-align-self:stretch;-ms-flex-item-align:stretch;align-self:stretch;width:1px;background-color:hsl(0, 0%, 80%);margin-bottom:8px;margin-top:8px;box-sizing:border-box;}</style><span class="css-1u9des2-indicatorSeparator"></span><style data-emotion="css 1xc3v61-indicatorContainer">.css-1xc3v61-indicatorContainer{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-transition:color 150ms;transition:color 150ms;color:hsl(0, 0%, 80%);padding:8px;box-sizing:border-box;}.css-1xc3v61-indicatorContainer:hover{color:hsl(0, 0%, 60%);}</style><div class="css-1xc3v61-indicatorContainer" aria-hidden="true"><style data-emotion="css 8mmkcg">.css-8mmkcg{display:inline-block;fill:currentColor;line-height:1;stroke:currentColor;stroke-width:0;}</style><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" class="css-8mmkcg"><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div> 17<br> 18<p>GP2040-CE contains a built-in web-based configuration application which can be started by holding <a href="/usage#buttons"><code>S2</code></a> when plugging your controller into a PC or by holding <a href="/usage#buttons"><code>
18S2 + B3 + B4</code></a> for five seconds while the controller is plugged in. Then access <a href="http://192.168.7.1" target="_blank" rel="noopener noreferrer" class="">http://192.168.7.1</a> in a web browser to begin configuration.</p> 19<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="supported">Supported<a href="#supported" class="hash-link" aria-label="Direct link to Supported" title="Direct link to Supported" translate="no">â</a></h3> 20<ul> 21<li class="">Windows</li> 22<li class="">Mac</li> 23<li class="">Linux</li> 24<li class="">SteamOS</li> 25<li class="">iPadOS</li> 26</ul> 27<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="not-fully-supported">Not fully supported<a href="#not-fully-supported" class="hash-link" aria-label="Direct link to Not fully supported" title="Direct link to Not fully supported" translate="no">â</a></h3> 28<ul> 29<li class="">Android</li> 30<li class="">iOS</li> 31</ul> 32<div class="theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_BuS1"><p>Not all Android and iOS devices are supported for web-config. In our testing some Android devices will work and others will not. Most USB-C based iOS devices will work. We do not keep a list of which devices do and do not work.</p></div></div> 33<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="trouble-accessing-web-config-on-a-windows-pc">Trouble accessing web-config on a Windows PC<a href="#trouble-accessing-web-config-on-a-windows-pc" class="hash-link" aria-label="Direct link to Trouble accessing web-config on a Windows PC" title="Direct link to Trouble accessing web-config on a Windows PC" translate="no">â</a></h2> 34<p>If your Windows PC cannot access the built-in web-config of your GP2040-CE controller, try the following steps:</p> 35<p>1 - <strong>Ensure you are in web-config mode</strong></p> 36<ul> 37<li class="">Ensure your controller is in Web-Config mode.</li> 38<li class="">Verify the USB cable is securely connected and supports data transfer (some cables are power-only).</li> 39</ul> 40<p>2 - <strong>Try a Different Browser</strong></p> 41<ul> 42<li class="">Some browsers may block local device access. Try Chrome, Firefox, or Edge.</li> 43<li class="">Disable browser extensions (like ad-blockers) temporarily.</li> 44</ul> 45<p>3 - <strong>Check the URL</strong></p> 46<ul> 47<li class="">The web-config URL is <a href="http://192.168.7.1" target="_blank" rel="noopener noreferrer" class="">http://192.168.7.1</a>.</li> 48</ul> 49<p>4 - <strong>Disable Firewall/Antivirus Temporarily</strong></p> 50<ul> 51<li class="">Security software may block communication. Test with protections temporarily disabled.</li> 52</ul> 53<p>5 - <strong>Try Another USB Port/PC</strong></p> 54<ul> 55<li class="">Test on a different port or on a different computer.</li> 56</ul> 57<p>6 - <strong>Try restarting your computer</strong></p> 58<ul> 59<li class="">Try restarting your computer.</li> 60</ul> 61<div class="theme-admonition theme-admonition-warning admonition_xJq3 alert alert--warning"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>warning</div><div class="admonitionContent_BuS1"><p>In addition to the above there may be issues with drivers installed on your PC. Due to the risk of causing system issues the GP2040-CE team will not assist in driver based issues or recommend drivers be installed / uninstalled.</p></div></div> 62<div class="theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.
6269H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_BuS1"><p>Linux distributions may need some extra steps to access the web configurator; see <a href="#linux-setup" class="">Linux Setup</a>.</p></div></div> 63<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="linux-setup">Linux Setup<a href="#linux-setup" class="hash-link" aria-label="Direct link to Linux Setup" title="Direct link to Linux Setup" translate="no">â</a></h2> 64<p>When you plug in your controller while holding <a href="/usage#buttons"><code>S2</code></a>, you should see it connect in the kernel logs if you run <code>dmesg</code>:</p> 65<div class="language-sh codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-sh codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.291060] usb 1-3: new full-speed USB device number 12 using xhci_hcd</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.450166] usb 1-3: New USB device found, idVendor=cafe, idProduct=4028, bcdDevice= 1.01</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.450172] usb 1-3: New USB device strings: Mfr=1, Product=2, SerialNumber=3</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.450174] usb 1-3: Product: TinyUSB Device</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.450176] usb 1-3: Manufacturer: TinyUSB</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.450177] usb 1-3: SerialNumber: 123456</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.484285] rndis_host 1-3:1.0 usb0: register 'rndis_host' at usb-0000:06:00.1-3, RNDIS device, 02:02:84:6a:96:00</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[ 72.498630] rndis_host 1-3:1.0 enp6s0f1u3: renamed from usb0</span><br></span></code></pre></div></div> 66<p>In the above example, <strong>enp6s0f1u3</strong> is the virtual Ethernet interface for your controller. If you don't see the first <code>rndis_host</code> line, make sure <code>CONFIG_USB_NET_RNDIS_HOST</code> is compiled in your kernel or as a module.</p> 67<p>The web configurator is automatically running, you just need to be able to reach it. Some configurations automatically set up the route, so try <a href="http://192.168.7.1" target="_blank" rel="noopener noreferrer" class="">http://192.168.7.1</a> in your browser now. If it doesn't load, try configuring an IP for the interface manually via: <code>sudo ifconfig enp6s0f1u3 192.168.7.2</code>.</p> 68<p>Whether or not you had to add an IP manually, you should end up with a route something like this:</p> 69<div class="language-sh codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-sh codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">% ip route</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">default via 10.0.5.1 dev enp5s0 proto dhcp src 10.0.5.38 metric 2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">10.0.5.0/24 dev enp5s0 proto dhcp scope link src 10.0.5.38 metric 2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">192.168.7.0/24 dev enp6s0f1u3 proto kernel scope link src 192.168.7.2 <---</span><br></span></code></pre></div></div> 70<p>Then the configurator should be reachable in your browser.</p></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#supported" class="table-of-contents__link toc-highlight">Supported</a></li><li><a href="#not-fully-supported" class="table-of-contents__link toc-highlight">Not fully supported</a></li><li><a href="#trouble-accessing-web-config-on-a-windows-pc" class="table-of-contents__link toc-highlight">Trouble accessing web-config on a Windows PC</a></li><li><a href="#linux-setup" class="table-of-contents__link toc-highlight">Linux Setup</a></li></ul></div></div></div></div></main></div></div></div></div> 71</body> 72</html>
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.