Raspberry Pi Pico - Limit Switch
This guide shows you how to use a limit switch with the Raspberry Pi Pico. We will cover the following details:
- How to connect the limit switch with the Raspberry Pi Pico.
- How to write code for the Raspberry Pi Pico to read the limit switch's status.
- How to program the Raspberry Pi Pico to detect the touched and untouched event from the limit switch.
Hardware Preparation
Or you can buy the following sensor kits:
1 | × | DIYables Sensor Kit (30 sensors/displays) | |
1 | × | DIYables Sensor Kit (18 sensors/displays) |
Additionally, some of these links are for products from our own brand, DIYables.
Overview of Limit Switch
It is called Limit Switch because its main function is to detect when a moving object reaches its endpoint. It is also known as a travel switch. It is also called the travel switch.
Pinout
Different types of limit switches are commonly used, such as the KW12-3 and V-156-1C25. Each model includes 3 pins.
- C pin: This is the common pin. It is used in both the open and closed settings.
- NO pin: This means the Open pin. It is used when the setting is open.
- NC pin: This means the Closed pin. It is used when the setting is closed.
How It Works
The limit switch has three pins, but usually, only two pins are used: the C pin and one of the other two pins. There are four ways to connect the limit switch. Here is a table showing the wiring of the limit switch and its readings on the Raspberry Pi Pico for all four methods:
C pin | NO pin | NC pin | Raspberry Pi Pico Input Pin's State | |
---|---|---|---|---|
1 | GND | Raspberry Pi Pico Input Pin (with pull-up) | NOT connected | HIGH when untouched, LOW when touched |
2 | GND | NOT connected | Raspberry Pi Pico Input Pin (with pull-up) | LOW when untouched, HIGH when touched |
3 | VCC | Raspberry Pi Pico Input Pin (with pull-down) | NOT connected | LOW when untouched, HIGH when touched |
4 | VCC | NOT connected | Raspberry Pi Pico Input Pin (with pull-down) | HIGH when untouched, LOW when touched |
We can change the positions of the GND pin and the input pin on the Raspberry Pi Pico for each method. This provides us with 8 different methods to connect the Raspberry Pi Pico to a limit switch.
We only need to choose one of the four methods mentioned earlier. For this tutorial, we will use the first method.
Wiring Diagram
This image is created using Fritzing. Click to enlarge image
Raspberry Pi Pico Code - Limit Switch
A limit switch, similar to a button, requires debouncing to function properly. Debouncing can make the code more complex. Fortunately, the DIYables_MicroPython_Button library provides a debouncing feature and includes an internal pull-up resistor, which simplifies the programming process.
Here are two usual situations:
- The first: If the switch is TOUCHED, do something. If it is UNTOUCHED, do the opposite.
- The second: If the switch goes from UNTOUCHED to TOUCHED or from TOUCHED to UNTOUCHED, do something.
Let's see how to write the MicroPython script in both cases.
Raspberry Pi Pico Code - Read Limit Switch's State
Detailed Instructions
Please follow these instructions step by step:
- Ensure that Thonny IDE is installed on your computer.
- Ensure that MicroPython firmware is installed on your Raspberry Pi Pico.
- If this is your first time using a Raspberry Pico, refer to the Raspberry Pi Pico - Getting Started tutorial for detailed instructions.
- Connect the Raspberry Pi Pico to the limit switch according to the provided diagram.
- Connect the Raspberry Pi Pico to your computer using a USB cable.
- Launch the Thonny IDE on your computer.
- On Thonny IDE, select MicroPython (Raspberry Pi Pico) Interpreter by navigating to Tools Options.
- In the Interpreter tab, select MicroPython (Raspberry Pi Pico) from the drop-down menu.
- Ensure the correct port is selected. Thonny IDE should automatically detect the port, but you may need to select it manually (e.g., COM3 on Windows or /dev/ttyACM0 on Linux).
- On Thonny IDE, navigate to the Tools Manage packages on the Thonny IDE.
- Search “DIYables-MicroPython-Button”, then find the Button library created by DIYables.
- Click on DIYables-MicroPython-Button, then click Install button to install Button library.
- Copy the above code and paste it to the Thonny IDE's editor.
- Save the script to your Raspberry Pi Pico by:
- Click the Save button, or use Ctrl+S keys.
- In the save dialog, you will see two sections: This computer and Raspberry Pi Pico. Select Raspberry Pi Pico
- Save the file as main.py
- Click the green Run button (or press F5) to run the script. The script will execute.
- Press, hold, then release the limit switch while checking out the message in the Shell at the bottom of Thonny.
If you name your script main.py and save it to the root directory of the Raspberry Pi Pico, it will automatically run each time the Pico is powered on or reset. This is useful for standalone applications that need to start running immediately upon power-up. If you name your script another name other than main.py, you will need to manually run it from Thonnys's Shell.
Raspberry Pi Pico Code - Check Limit Switch's touched/untouched event
- Copy the above code and paste it to the Thonny IDE's editor.
- Save the script to your Raspberry Pi Pico
- Click the green Run button (or press F5) to run the script. The script will execute.
- Press, hold, then release the limit switch while checking out the message in the Shell at the bottom of Thonny.