KY-017 Tilt switch module

Depending on the inclination, a switch closes the input pins briefly. This happens due to the fact that the ball inside rolls back and forth and with the right inclination then finally closes the contacts inside the housing.

Pin assignment

Code example Arduino

Pin assignment Arduino

Arduino	Sensor
pin 10	signal
5V	+V
ground	GND

Arduino	Sensor
Pin 13	LED +
ground	LED -

This is a sample program that lights up an LED when a signal is detected at the sensor. The modules KY-011, KY-016 or KY-029 can also be used as LEDs, for example.

int Led = 13 ;// declaration of the LED output pin
int Sensor = 10 ;// Declaration of the sensor input pin
int val; // Temporary variable
   
void setup ()
{
  pinMode (Led, OUTPUT) ; // Initialize output pin
  pinMode (Sensor, INPUT) ; // Initialize sensor pin
}
   
void loop ()
{
  val = digitalRead (Sensor) ; // The current signal at the sensor is read out
   
  if (val == HIGH) // If a signal could be detected, the LED is switched on.
  {
    digitalWrite (Led, LOW);
  }
  else
  {
    digitalWrite (Led, HIGH);
  }
}

Example program download

KY017-Arduino.zip

Code example Raspberry Pi

Pin assignment Raspberry Pi

Raspberry Pi	Sensor
GPIO 24 [Pin 18]	Signal
3.3V [Pin 1]	+V
Ground [Pin 6]	GND

This is a similar example program, but in the code language Python, with the difference that here no LED is lit but something is output to the console when a signal is detected.

# Required modules are imported and set up
import RPi.GPIO as GPIO
import time
   
GPIO.setmode(GPIO.BCM)
   
# Here the input pin is declared, to which the sensor is connected. Additionally the PullUP resistor at the input will be activated
GPIO_PIN = 24
GPIO.setup(GPIO_PIN, GPIO.IN)
   
print ("Sensor test [press CTRL+C to end test]")
   
# This outputFunction will be executed on signal detection
def outputFunction(null):
        print("Signal detected")
   
# When a signal is detected (falling signal edge) the output function is executed
GPIO.add_event_detect(GPIO_PIN, GPIO.FALLING, callback=outputFunction, bouncetime=100) 
   
# main program loop
try:
    while True:
        time.sleep(1)
   
# clean up after the program is finished
except KeyboardInterrupt:
    GPIO.cleanup()

Example program download

KY017-RPi.zip

To start with the command:

sudo python3 KY017-RPi.py

Code example Micro:Bit

Pinout Micro:Bit:

Micro:Bit	Sensor
Pin 1	Signal
3V	+V
Ground	GND

This is a MakeCode example for Micro:Bit which essentially does the same as the examples of the other two variants. However, this example is closer to the Raspberry Pi example than the Arduino example.

Sample program download

microbit-KY-017.zip