Grove - Magnetic Switch


3.3V 5.0V Digital

This is a Grove interface compatible Magnetic switch module. It is based on encapsulated dry reed switch CT10. CT10 is single-pole, single throw (SPST) type, having normally open ruthenium contacts. The sensor is a double-ended type and may be actuated with an electromagnet, a permanent magnet or a combination of both. The magnetic switch is a wonderful tool for designers who would like to turn a circuit on and off based on proximity.


  • Grove compatible interface
  • 2.0cm x 2.0cm Grove module
  • Minimum external parts
  • 10W rating
  • Rugged encapsulation


More details about Grove modules please refer to Grove System

Application Ideas

  • Proximity Sensor
  • Security Alarm Sensor
  • Level Sensor
  • Flow Sensor
  • Pulse Counter


Items Min Norm Max Unit
Working Voltage 4.75 5.0 5.25 V
Switched Power 10 W
Switched Voltage AC,RMS value(max) < 140 V
Switched Current DC < 500 mA
Carry Current DC < 0.5 A
Contact Resistance <200
Insulation Resistance >106
Operating Temperature -40 - 125
Operate Range 10 - 40 AT

Platforms Supported


With Arduino

The SIG pin of the module output LOW normally. When a magnet approaches the switch, the magnetic switch close and the SIG pin output HIGH.

The following sketch demonstrates a simple application of using the Magnetic switch to control the led. When you put a magnet that has enough magnetic power close to the module, the switch is closed .Then the SIG pin out put a high voltage. You can use this to control the led.

As the picture on the below indicates, the Magnetic switch is connected to digital port 9 of the Grove - Base Shield and the LED is connected to digital port 13. When a Magnet approaches the switch, the SIG pin outputs a High voltage. Then the LED lights up. The hardware installation is as follows:

  • Copy and paste code below to a new Arduino sketch.

    /*macro definitions of magnetic pin and LED pin*/
    #define MAGNECTIC_SWITCH 9
    #define LED 13//the on board LED of the Arduino or Seeeduino

    void setup()

    void loop() 
        if(isNearMagnet())//if the magnetic switch is near the magnet?
    void pinsInit()

    /*If the magnetic switch is near the magnet, it will return ture, */
    /*otherwise it will return false                                */
    boolean isNearMagnet()
        int sensorValue = digitalRead(MAGNECTIC_SWITCH);
        if(sensorValue == HIGH)//if the sensor value is HIGH?
            return true;//yes,return ture
            return false;//no,return false
    void turnOnLED()
    void turnOffLED()
  • Upload the code.
  • Then the LED light when there is Magnetic approaches the switch. Have a try!

With Raspberry Pi

1.You should have a raspberry pi and a grovepi or grovepi+.

2.You should have completed configuring the development enviroment, otherwise follow here.


  • Plug the Magnet Switch to grovepi socket D3 by using a grove cable.

4.Navigate to the demos’ directory:

    cd yourpath/GrovePi/Software/Python/
  • To see the code (this demo has the same usage with tilt switch)
    nano   # "Ctrl+x" to exit #
    import time
    import grovepi

    # Connect the Grove Tilt Switch to digital port D3
    tilt_switch = 3


    while True:
            print grovepi.digitalRead(tilt_switch)

        except IOError:
            print "Error"

5.Run the demo.

    sudo python


Put a magnet upon the sensor, the SIG pin will output HIGH.


ArduinoWioBeagleBoneRaspberry PiLinkIt ONE


The platforms mentioned above as supported is/are an indication of the module's hardware or theoritical compatibility. We only provide software library or code examples for Arduino platform in most cases. It is not possible to provide software library / demo code for all possible MCU platforms. Hence, users have to write their own software library.

Help us make it better

Thank you for choosing Seeed. A couple of months ago we initiated a project to improve our documentation system. What you are looking at now is the first edition of the new documentation system. Comparing to the old one, here is the progresses that we made:

  • Replaced the old documentation system with a new one that was developed from Mkdocs, a more widely used and cooler tool to develop documentation system.
  • Integrated the documentation system with our official website, now you can go to Bazaar and other section like Forum and Community more conveniently.
  • Reviewed and rewrote documents for hundreds of products for the system’s first edition, and will continue migrate documents from old wiki to the new one.

An easy-to-use instruction is as important as the product itself. We are expecting this new system will improve your experience when using Seeed’s products. However since this is the first edition, there are still many things need to improve, if you have any suggestions or findings, you are most welcome to submit the amended version as our contributor or give us suggestions in the survey below, Please don’t forget to leave your email address so that we can reply.

Happy hacking