https://makerspace.cc/wiki/api.php?action=feedcontributions&feedformat=atom&user=Johnsonm3 2026-05-06T22:28:40Z User contributions MediaWiki 1.42.7 https://makerspace.cc/wiki/index.php?title=Macropad&diff=9872 2026-04-03T15:51:44Z

<p>Johnsonm3: provided steps for platformio based firmware build and reprogramming step</p> <hr /> <div>== Assembly instructions: ==<br /> Assembly instructions can also be found in a printable form [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> *<br /> *<br /> *<br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches. [[File:Switch_placement.png|400x400px]]<br /> ** Next, we’ll solder these into place<br /> ** [[File:Soldering_switches.png]]<br /> *** To solder, put a little bit of solder into the hot iron, then rest the tip against both of the components you want to connect. After giving them a moment to heat up, slowly feed solder into the the components, until a cone shaped ring of solder surrounds the component.<br /> **** It's best to stop adding solder once the joint's sides have a concave shape; adding too much solder can lead to a brittle joint.<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/<br /> *#* [[File:Bend pins.png|412x412px]] <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holes. Be careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board).<br /> *#* [[File:Seating the encoder.png|321x321px]] <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down.<br /> ** [[File:Putting in headers.png|362x362px]] <br /> **# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:    <br /> **#* [[File:Controller in place.png|285x285px]]                                           <br /> **# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> **#* [[File:Soldered from top.png|417x417px]]<br /> **# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so:<br /> **#* [[File:Soldering back of controller.png|390x390px]] <br /> **#* Once you have all the connections soldered, the legs of the headers (on the back) should be trimmed. However, it's likely best to get firmware up and running beforehand, in case repairs need to be done.<br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> ** If you’d like to tweak or optimize the code, feel free! The source code can be found [https://github.com/Marshall-J2698/Makerpad here].<br /> <br /> === Adding LEDs ===<br /> # To install LEDs, you'll need 3x 1.8mm LEDs and 3x 1000kΩ resistors. <br /> #* ''Note:'' If you're planning on using green LEDs, it's probably better to use 470Ω resistors; otherwise they might be a little dim <br /> # Start by bending the resistors to a U-shape; they should look like this<br /> #* [[File:Bend the resistors.png]]<br /> # Then install them into the holes next to each switch and solder them into place. <br /> #* Note that direction does not matter for resistor installation<br /> #** [[File:Resistor installation.png|433x433px]]<br /> #Now, we'll add the LEDs; take care during this step, as the direction the LED is installed matters. The longer leg of the LED is positive and the shorter negative.<br /> ##take an LED, and put it through the small hole in the front of your switch, so that it pokes out the two metal holes on the back of the pcb.<br /> ##The longer leg should be facing the left side of the macropad. Look to the resistor image above to see the orientation the LEDs need to be installed.<br /> ##*[[File:LED orientation.png|253x253px]]<br /> ##*after installation, it should look like this:<br /> ##*[[File:Installed LED.png]]<br /> ##As before, these can be soldered into place from the back<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://code.visualstudio.com/ Visual Studio Code]<br /> # Once installed, click on the extension menu (looks like 3-4 cubes stacked on top of eachother)<br /> # Search for platformio, then install! Select trust this author. This may take awhile, so be patient<br /> # In the mean time, go to the [https://github.com/Marshall-J2698/Makerpad github page], and download the repo<br /> #Back in VScode, click the new tab on the left that looks like an ant. you should be greeted with a home screen that has an option for opening an existing project. You want to find this, or a similar option, and use it to open the firmware folder from the repo you just cloned!<br /> #Once you do this, platformio will automatically start installing dependencies! Wait for these to be done, then plug in your board.<br /> #Hold down the zero button on the esp32 itself (it's the button next to the usb port labeled 0), then press the reset button. <br /> #Now, In the bottom row of VScode, press the right arrow button and wait for it to flash<br /> ##it may say &quot;failed to upload&quot;; this is usually not a big deal, so long as you saw the flashing progress bar a few seconds prior.<br /> #You should be good to go!<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press the zero button on the esp32. This should stop keys from typing out null when pressed.<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> ## unless changed, the default password for this network is just &quot;password&quot;<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE<br /> <br /> <br /> '''&lt;u&gt;Legacy steps for reprogramming&lt;/u&gt;''' - As of april 2026, we have moved our firmware to Platformio build system, as it makes for a much more repeatable development and usage experience. If you would like to use the old arduino code and procedure, feel free to look through old commits in the github, and follow the tutorial below.<br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once.<br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> [[Category:Projects]]<br /> [[Category:Soldering]]<br /> [[Category:Programming]]<br /> [[Category:SimpleProjects]]</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=9776 2025-12-04T16:47:50Z

<p>Johnsonm3: added as simple project</p> <hr /> <div>== Assembly instructions: ==<br /> Assembly instructions can also be found in a printable form [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> *<br /> *<br /> *<br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches. [[File:Switch_placement.png|400x400px]]<br /> ** Next, we’ll solder these into place<br /> ** [[File:Soldering_switches.png]]<br /> *** To solder, put a little bit of solder into the hot iron, then rest the tip against both of the components you want to connect. After giving them a moment to heat up, slowly feed solder into the the components, until a cone shaped ring of solder surrounds the component.<br /> **** It's best to stop adding solder once the joint's sides have a concave shape; adding too much solder can lead to a brittle joint.<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/<br /> *#* [[File:Bend pins.png|412x412px]] <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holes. Be careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board).<br /> *#* [[File:Seating the encoder.png|321x321px]] <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down.<br /> ** [[File:Putting in headers.png|362x362px]] <br /> **# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:    <br /> **#* [[File:Controller in place.png|285x285px]]                                           <br /> **# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> **#* [[File:Soldered from top.png|417x417px]]<br /> **# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so:<br /> **#* [[File:Soldering back of controller.png|390x390px]] <br /> **#* Once you have all the connections soldered, the legs of the headers (on the back) should be trimmed. However, it's likely best to get firmware up and running beforehand, in case repairs need to be done.<br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> ** If you’d like to tweak or optimize the code, feel free! The source code can be found [https://github.com/Marshall-J2698/Makerpad here].<br /> <br /> === Adding LEDs ===<br /> # To install LEDs, you'll need 3x 1.8mm LEDs and 3x 1000kΩ resistors. <br /> #* ''Note:'' If you're planning on using green LEDs, it's probably better to use 470Ω resistors; otherwise they might be a little dim <br /> # Start by bending the resistors to a U-shape; they should look like this<br /> #* [[File:Bend the resistors.png]]<br /> # Then install them into the holes next to each switch and solder them into place. <br /> #* Note that direction does not matter for resistor installation<br /> #** [[File:Resistor installation.png|433x433px]]<br /> #Now, we'll add the LEDs; take care during this step, as the direction the LED is installed matters. The longer leg of the LED is positive and the shorter negative.<br /> ##take an LED, and put it through the small hole in the front of your switch, so that it pokes out the two metal holes on the back of the pcb.<br /> ##The longer leg should be facing the left side of the macropad. Look to the resistor image above to see the orientation the LEDs need to be installed.<br /> ##*[[File:LED orientation.png|253x253px]]<br /> ##*after installation, it should look like this:<br /> ##*[[File:Installed LED.png]]<br /> ##As before, these can be soldered into place from the back<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE<br /> [[Category:Projects]]<br /> [[Category:Soldering]]<br /> [[Category:Programming]]<br /> [[Category:SimpleProjects]]</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Clothing_Repair&diff=9732 2025-11-06T19:52:11Z

<p>Johnsonm3: added materials to sewing kits</p> <hr /> <div>[[Category:Sewing]]<br /> <br /> [[File:SewingKit.jpg|thumb]]<br /> The clothing repair kits contain items useful for hand-mending clothes and are available for checkout at the Makerspace. <br /> <br /> === Kits Include: ===<br /> <br /> # A pin cushion<br /> # Pins<br /> # A sewing needle<br /> # A needle threader <br /> # Black and white thread<br /> # A tape measure <br /> # A seam ripper (after removing the cap of the seam ripper, it can be attached to the back end to make the handle longer while using it)<br /> # Thread scissors<br /> # Safety Pins<br /> <br /> === Repair Methodology: ===<br /> Just clothes may become damaged in a multitude of different ways, there are of course multiple ways to repair clothes as well. This is a brief guide to some of those methods:<br /> <br /> * Split seams: the easiest way to mend a split seam is to use a slip stitch, and re-bind the loose edges together. This is an easy method, as it doesn't require any patches.<br /> * Rips: if a piece of cloth has been torn, but edges are still intact, there are a few methods you may use:<br /> ** Iron-on patches: easy, as they require no stitching, and they can be invisible from the outside.<br /> ** Sew on patches: these also leave the material flat on the outside, but stitches may still be visible.<br /> ** Slip stitching: alternating stitches on either side of the tear to close the hole; this method works in a pinch, but will leave a pinch or pucker in the material.<br /> ** Darning: Using a needle and thread to mend over the tear, and weave the hole closed. Time intensive, but efficient.<br /> * Hole mending: if an item of clothing (like a pair of jeans) develops a hole where material is missing, you can use the following methods:<br /> ** Quick mend: This involves cutting a patch to fit the hole, using a running stitch to secure it in place around the outside edges, trimming loose and frayed edges from around the hole, and whip stitching the edges of the hole to the patch. It will be visible, so it is recommended to use an embroidery thread and use sashiko stitches to emphasize, rather than hide, the patch.<br /> ** Darned patch: With this method, one would temporarily affix a patch over the hole with a running stitch or pins and secure the edges of the patch using a blind hem stitch. With the patch secured in place, leave any intact threads of the garment in the hole, and use a matching color thread to first place long stitches over the hole. Then, using the same thread in a perpendicular orientation, weave through the existing garment threads and the long threads that you just placed, as well as through the backing patch.<br /> ** Darning: Using any remaining threads in the hole from the garment, stitch over the hole with a multitude of long stitches, and then weave the thread through perpendicularly, alternating over and under the long stitches.<br /> *Replacing Buttons:<br /> **Cross stitching: Starting with the needle behind the fabric, sew through diagonal holes of the button to secure it in place. <br /> **Bar stitching: Sew only through adjacent button holes to secure, binding off the thread on the reverse side. <br /> <br /> === Helpful Tutorial Videos: ===<br /> <br /> <br /> [https://www.youtube.com/watch?v=-ynBWa5ej1Q Sewing 101: Mending A Tear - YouTube]<br /> <br /> {{#Widget:yt|id=-ynBWa5ej1Q}}<br /> <br /> [https://www.youtube.com/watch?v=6NDbboiY8B0 Top 5 Hand Stitches for Garment Sewing - Most Popular - YouTube]<br /> <br /> {{#Widget:yt|id=6NDbboiY8B0}}<br /> <br /> [https://www.youtube.com/watch?v=EI064zTWR8g Learn by yourself to fix a hole on your T-shirt beautifully and elegantly - YouTube]<br /> <br /> {{#Widget:yt|id=EI064zTWR8g}}<br /> <br /> [https://www.youtube.com/watch?v=HXZEV3toMhg HOW TO DARN A HOLE IN CLOTHES... Using a 1954 vintage sewing tutorial! - YouTube]<br /> <br /> {{#Widget:yt|id=HXZEV3toMhg}}<br /> [[Category:Tools]]<br /> [[Category:Makerspace Tools]]</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7440 2024-05-22T18:34:07Z

<p>Johnsonm3: updated LED images</p> <hr /> <div>[[Category:Tutorials]]<br /> <br /> == Assembly instructions: ==<br /> Assembly instructions can also be found in a printable form [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> *<br /> *<br /> *<br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches. [[File:Switch_placement.png|400x400px]]<br /> ** Next, we’ll solder these into place<br /> ** [[File:Soldering_switches.png]]<br /> *** To solder, put a little bit of solder into the hot iron, then rest the tip against both of the components you want to connect. After giving them a moment to heat up, slowly feed solder into the the components, until a cone shaped ring of solder surrounds the component.<br /> **** It's best to stop adding solder once the joint's sides have a concave shape; adding too much solder can lead to a brittle joint.<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/<br /> *#* [[File:Bend pins.png|412x412px]] <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holes. Be careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board).<br /> *#* [[File:Seating the encoder.png|321x321px]] <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down.<br /> ** [[File:Putting in headers.png|362x362px]] <br /> **# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:    <br /> **#* [[File:Controller in place.png|285x285px]]                                           <br /> **# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> **#* [[File:Soldered from top.png|417x417px]]<br /> **# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so:<br /> **#* [[File:Soldering back of controller.png|390x390px]] <br /> **#* Once you have all the connections soldered, the legs of the headers (on the back) should be trimmed. However, it's likely best to get firmware up and running beforehand, in case repairs need to be done.<br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> ** If you’d like to tweak or optimize the code, feel free! The source code can be found [https://github.com/Marshall-J2698/Makerpad here].<br /> <br /> === Adding LEDs ===<br /> # To install LEDs, you'll need 3x 1.8mm LEDs and 3x 1000kΩ resistors. <br /> #* ''Note:'' If you're planning on using green LEDs, it's probably better to use 470Ω resistors; otherwise they might be a little dim <br /> # Start by bending the resistors to a U-shape; they should look like this<br /> #* [[File:Bend the resistors.png]]<br /> # Then install them into the holes next to each switch and solder them into place. <br /> #* Note that direction does not matter for resistor installation<br /> #** [[File:Resistor installation.png|433x433px]]<br /> #Now, we'll add the LEDs; take care during this step, as the direction the LED is installed matters. The longer leg of the LED is positive and the shorter negative.<br /> ##take an LED, and put it through the small hole in the front of your switch, so that it pokes out the two metal holes on the back of the pcb.<br /> ##The longer leg should be facing the left side of the macropad. Look to the resistor image above to see the orientation the LEDs need to be installed.<br /> ##*[[File:LED orientation.png|253x253px]]<br /> ##*after installation, it should look like this:<br /> ##*[[File:Installed LED.png]]<br /> ##As before, these can be soldered into place from the back<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Installed_LED.png&diff=7439 2024-05-22T18:31:59Z

<p>Johnsonm3: </p> <hr /> <div>Properly seated LED</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:LED_orientation.png&diff=7438 2024-05-22T18:29:34Z

<p>Johnsonm3: </p> <hr /> <div>how the LEDs that should be placed into the board</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7437 2024-05-21T02:16:18Z

<p>Johnsonm3: formatting change</p> <hr /> <div>[[Category:Tutorials]]<br /> <br /> == Assembly instructions: ==<br /> Assembly instructions can also be found in a printable form [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> *<br /> *<br /> *<br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches. [[File:Switch_placement.png|400x400px]]<br /> ** Next, we’ll solder these into place<br /> ** [[File:Soldering_switches.png]]<br /> *** To solder, put a little bit of solder into the hot iron, then rest the tip against both of the components you want to connect. After giving them a moment to heat up, slowly feed solder into the the components, until a cone shaped ring of solder surrounds the component.<br /> **** It's best to stop adding solder once the joint's sides have a concave shape; adding too much solder can lead to a brittle joint.<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/<br /> *#* [[File:Bend pins.png|412x412px]] <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holes. Be careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board).<br /> *#* [[File:Seating the encoder.png|321x321px]] <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down.<br /> ** [[File:Putting in headers.png|362x362px]] <br /> **# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:    <br /> **#* [[File:Controller in place.png|285x285px]]                                           <br /> **# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> **#* [[File:Soldered from top.png|417x417px]]<br /> **# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so:<br /> **#* [[File:Soldering back of controller.png|390x390px]] <br /> **#* Once you have all the connections soldered, the legs of the headers (on the back) should be trimmed. However, it's likely best to get firmware up and running beforehand, in case repairs need to be done.<br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> ** If you’d like to tweak or optimize the code, feel free! The source code can be found [https://github.com/Marshall-J2698/Makerpad here].<br /> <br /> === Adding LEDs ===<br /> (more photos coming soon)<br /> <br /> # To install LEDs, you'll need 3x 1.8mm LEDs and 3x 1000kΩ resistors. <br /> #* ''Note:'' If you're planning on using green LEDs, it's probably better to use 470Ω resistors; otherwise they might be a little dim <br /> # Start by bending the resistors to a U-shape; they should look like this<br /> #* [[File:Bend the resistors.png]]<br /> # Then install them into the holes next to each switch and solder them into place. <br /> #* Note that direction does not matter for resistor installation<br /> #** [[File:Resistor installation.png|433x433px]]<br /> #Now, we'll add the LEDs; take care during this step, as the direction the LED is installed matters. The longer leg of the LED is positive and the shorter negative.<br /> ##take an LED, and put it through the small hole in the front of your switch, so that it pokes out the two metal holes on the back of the pcb.<br /> ##The longer leg should be facing the left side of the macropad. Look to the resistor image above to see the orientation the LEDs need to be installed.<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7436 2024-05-21T01:31:35Z

<p>Johnsonm3: updated formatting</p> <hr /> <div>[[Category:Tutorials]]<br /> <br /> == Assembly instructions: ==<br /> Assembly instructions can also be found in a printable form [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches.[[File:Switch placement.png|center|thumb|400x400px|This is how switches should be installed into the board! make sure pins aren't bent beforehand]]<br /> ** Next, we’ll solder these into place [[File:Soldering_switches.png]]<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/<br /> *#* [[File:Bend pins.png|412x412px]] <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holes. Be careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board).<br /> *#* [[File:Seating the encoder.png|321x321px]] <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down.<br /> ** [[File:Putting in headers.png|362x362px]] <br /> **# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:    <br /> **#* [[File:Controller in place.png|285x285px]]                                           <br /> **# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> **#* [[File:Soldered from top.png|417x417px]]<br /> **# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so:<br /> **#* [[File:Soldering back of controller.png|390x390px]] <br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> ** If you’d like to tweak or optimize the code, feel free! The source code can be found [https://github.com/Marshall-J2698/Makerpad here].<br /> <br /> === Adding LEDs ===<br /> (more photos coming soon)<br /> <br /> # To install LEDs, you'll need 3x 1.8mm LEDs and 3x 1000kΩ resistors. <br /> #* ''Note:'' If you're planning on using green LEDs, it's probably better to use 470Ω resistors; otherwise they might be a little dim <br /> # Start by bending the resistors to a U-shape; they should look like this<br /> #* [[File:Bend the resistors.png]]<br /> # Then install them into the holes next to each switch and solder them into place. <br /> #* Note that direction does not matter for resistor installation<br /> #** [[File:Resistor installation.png|433x433px]]<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Resistor_installation.png&diff=7435 2024-05-20T20:14:57Z

<p>Johnsonm3: </p> <hr /> <div>adding a resistor in place</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Bend_the_resistors.png&diff=7434 2024-05-20T19:24:58Z

<p>Johnsonm3: </p> <hr /> <div>Bend the resistors so they can be installed into the board</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Soldering_back_of_controller.png&diff=7433 2024-05-20T18:34:41Z

<p>Johnsonm3: </p> <hr /> <div>soldering back of controller</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Soldered_from_top.png&diff=7432 2024-05-20T18:33:27Z

<p>Johnsonm3: </p> <hr /> <div>soldered esp32 from one side</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Controller_in_place.png&diff=7431 2024-05-20T18:30:14Z

<p>Johnsonm3: </p> <hr /> <div>seating the controller properly</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Putting_in_headers.png&diff=7430 2024-05-20T18:28:21Z

<p>Johnsonm3: </p> <hr /> <div>shows orientation for installing headers</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Seating_the_encoder.png&diff=7429 2024-05-20T18:25:00Z

<p>Johnsonm3: </p> <hr /> <div>shows how the pins of the encoder should be put into the circuit board</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Bend_pins.png&diff=7428 2024-05-20T18:22:46Z

<p>Johnsonm3: </p> <hr /> <div>shows how the rotary encoder pins should be bent prior to install</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7427 2024-05-17T20:59:02Z

<p>Johnsonm3: /* Assembly instructions: */</p> <hr /> <div>[[Category:Tutorials]]<br /> <br /> == Assembly instructions: ==<br /> Assembly instructions can be found [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> Welcome! This guide will show the steps for making a macropad (specifically the macropad rev3) from one of our kits!<br /> <br /> Your kit should contain the following:<br /> <br /> # The ESP32S2-This is the microcontroller, which actually talks to your computer<br /> # The circuit board-This is what connects all the components together, enabling the whole thing to work<br /> # 3x keyswitches-These are what you actually press to make key inputs<br /> # Rotary encoder and knob-allows for volume control<br /> # 3x 1K ohm resistors-Used to get proper current to LEDs. Only required if you want to install LEDs[[File:Makerpad parts list.png|left|thumb|501x501px|Parts list!]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> === Assembly ===<br /> <br /> * We’ll start by installing the switches! Take a switch and align the 4 pins with the holes on the pcb, and press into place. Repeat for all three switches.[[File:Switch placement.png|center|thumb|400x400px|This is how switches should be installed into the board! make sure pins aren't bent beforehand]]<br /> ** Next, we’ll solder these into place                         [[File:Soldering switches.png|left|thumb|Soldering the switches into the circuit board]]<br /> *** For a full soldering tutorial, please watch this [https://www.youtube.com/watch?v=Qps9woUGkvI quick guide]<br /> * Next, let’s install the rotary encoder; this is part 4 on the image <br /> *# First, make sure to bend all the pins until they’re sticking straight out. They sometimes get bent in shipping :/ <br /> *# Now, place the encoder into the top left of the pcb. One side has 3 pins and the other has 2, so be sure you’re putting the encoder into the side of the pcb with the correct number of holesBe careful to ensure that the encoder is sticking straight up (perpendicular to the circuit board). <br /> *# Now, we can solder all 7 pins on the back of the encoder in place, just as we did for the switches!<br /> * At this point, we’re ready to solder in the controller. Start by putting 2 headers into the top right of the circuit board with the “long side” down. <br /> *# Now, you can place the controller itself (the purple board) onto these headers. '''Make sure that the usb port faces away from the encoder!''' It should look like this:                                               <br /> *# Now, solder all 16 points on this side. It should look something like this: '''''(though your board will have switches)'''''<br /> *# To fully connect the controller to the board, you’ll also need to solder the 16 headers on the other side, like so: <br /> * Congratulations; that’s all the required soldering to get the board working! LEDs can also be added, but they are optional.<br /> * Now, you can follow the programming guide on the makerspace.cc wiki to get the code up and running!<br /> *# If you’d like to tweak or optimize the code, feel free! The source code can be found here.<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Soldering_switches.png&diff=7426 2024-05-17T20:18:46Z

<p>Johnsonm3: </p> <hr /> <div>Soldering the switches into the circuit board</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Switch_placement.png&diff=7425 2024-05-17T20:14:42Z

<p>Johnsonm3: </p> <hr /> <div>Demonstration of how switches should be installed into the pcb.</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=File:Makerpad_parts_list.png&diff=7424 2024-05-17T20:06:22Z

<p>Johnsonm3: </p> <hr /> <div>image of all the parts that come with the makerspace macropad kits!</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7423 2024-05-17T19:57:51Z

<p>Johnsonm3: /* Instructions for Programming the makerspace macropad */</p> <hr /> <div>[[Category:Tutorials]]<br /> <br /> == Assembly instructions: ==<br /> Assembly instructions can be found [https://docs.google.com/document/d/1evz1lOS-nTeEMei8WJlVfmJ6C-Dw2esytz5mxuN_9Ek/edit?usp=sharing here]<br /> <br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the [https://www.arduino.cc/en/software arduino IDE]<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7412 2024-02-19T16:23:32Z

<p>Johnsonm3: </p> <hr /> <div>[[Category:Tutorials]]<br /> == Instructions for Programming the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the arduino IDE<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7411 2024-02-19T15:54:40Z

<p>Johnsonm3: </p> <hr /> <div>[[Category:Tutorials]]<br /> == Instructions for Assembling the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the arduino IDE<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7410 2024-02-18T00:12:10Z

<p>Johnsonm3: </p> <hr /> <div>== Instructions for Assembling the makerspace macropad ==<br /> &lt;u&gt;'''If you just made your macropad, you'll need to flash it with the firmware.'''&lt;/u&gt;<br /> <br /> # download the arduino IDE<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> '''&lt;u&gt;if you've already made, and flashed the firmware, there are only a few steps to reprogram:&lt;/u&gt;'''<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7409 2024-02-17T23:58:05Z

<p>Johnsonm3: fleshed out flashing guide</p> <hr /> <div>== Instructions for Assembling the makerspace macropad ==<br /> If you just made your macropad, you'll need to flash it with the firmware.<br /> <br /> # download the arduino IDE<br /> # In the arduino IDE, go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library made by arduino<br /> # Then go to tools-&gt;manage libraries then install the following:<br /> ## ArduinoJson<br /> ## StringSplitter<br /> # press select board, esp32, and select esp32S2 Dev Module<br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files. Now, open the ino file in the arduino program (you may need to do some renaming-the IDE should do this for you).<br /> #Now plug in your board, and press the two reset buttons that are on the ESP32 (the purple board) itself; they're located near the usb port. If you're using the makerspace case, there's a hole on the top of the case and next to the usb port. Specifically, you want to hold the top button for ~2s and then press the other key once. <br /> #Go to tools-&gt;port-&gt;then select the one with esp32<br /> #now press the upload button! (it's the right-facing arrow, in the top left)<br /> <br /> if you've already made, and flashed the firmware, there are only a few steps to reprogram:<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7408 2024-02-17T23:14:23Z

<p>Johnsonm3: added flashing instructions</p> <hr /> <div>== Instructions for Assembling the makerspace macropad ==<br /> If you just made your macropad, you'll need to flash it with the firmware.<br /> <br /> # download the arduino IDE<br /> # go to tools-&gt;boards-&gt;board manager. Then search esp32 and install the library <br /> # go to the [https://github.com/Marshall-J2698/Makerpad github page], and download all the files<br /> #<br /> <br /> if you've already made, and flashed the firmware, there are only a few steps to reprogram:<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7407 2024-02-17T01:55:40Z

<p>Johnsonm3: added list of special keys</p> <hr /> <div>== Instructions for Assembling the makerspace macropad ==<br /> if you've already made, and flashed the firmware, there are only a few steps to reprogram:<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work<br /> *Here's a comprehensive list of every availible special key:<br /> **KEY_LEFT_CTRL KEY_LEFT_SHIFT KEY_LEFT_ALT KEY_LEFT_GUI KEY_RIGHT_CTRL KEY_RIGHT_SHIFT KEY_RIGHT_ALT KEY_RIGHT_GUI KEY_UP_ARROW KEY_DOWN_ARROW KEY_LEFT_ARROW KEY_RIGHT_ARROW KEY_MENU KEY_SPACE KEY_BACKSPACE KEY_TAB KEY_RETURN KEY_ESC KEY_INSERT KEY_DELETE KEY_PAGE_UP KEY_PAGE_DOWN KEY_HOME KEY_END KEY_NUM_LOCK KEY_CAPS_LOCK KEY_F1 KEY_F2 KEY_F3 KEY_F4 KEY_F5 KEY_F6 KEY_F7 KEY_F8 KEY_F9 KEY_F10 KEY_F11 KEY_F12 KEY_F13 KEY_F14 KEY_F15 KEY_F16 KEY_F17 KEY_F18 KEY_F19 KEY_F20 KEY_F21 KEY_F22 KEY_F23 KEY_F24 KEY_PRINT_SCREEN KEY_SCROLL_LOCK KEY_PAUSE</div>

Johnsonm3 https://makerspace.cc/wiki/index.php?title=Macropad&diff=7406 2024-02-17T01:52:47Z

<p>Johnsonm3: added page</p> <hr /> <div>== Instructions for Assembling the makerspace macropad ==<br /> if you've already made, and flashed the firmware, there are only a few steps to reprogram:<br /> <br /> # press down key 1 (the left key) and the encoder knob at the same time, until key 1 stops sending keypresses<br /> # after ~5seconds, pressing key 1 should cause an address to be typed in; specifically 192.168.1.1<br /> # Now, go to your wifi settings, and connect to the new network that's appeared (likely named macropad or macropad-config, unless you manually renamed it)<br /> # open any web browser (while connected to this network) and type in the address 192.168.1.1 (or just press key 1)<br /> # this should take you to the programming page! now, enter in what you want each key to do, and press submit!<br /> <br /> A few notes on configuring the keys:<br /> <br /> * With the default firmware, the 3 main keys are set up to do basic keyboard functions and the volume knob does media controls. You can't mix and match functionality between these two groups without manually editing the firmware<br /> * to input modifiers (ie. shift, control, alt), you have to use a strange format<br /> ** Shift = KEY_LEFT_SHIFT, Alt = KEY_LEFT_ALT, Control = KEY_LEFT_CTRL<br /> ** put whatever modifiers you want at the start of your macro, and seperate them with &quot;+++&quot; from the rest of your input<br /> *** for example to send &quot;ctrl+shift+t&quot; I would input: KEY_LEFT_CTRL+++KEY_LEFT_SHIFT+++t<br /> *** modifiers must be at the start of the sequence: KEY_LEFT_CTRL+++t+++KEY_LEFT_SHIFT will not work</div>

Johnsonm3