KY-017 Tilt switch

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);
  }
}

Depending on the inclination, a switch closes the input pins briefly. This happens due to the fact that a ball inside short-circuits the contacts, depending on the position.

Pin assignment

Code example Raspberry Pi

Pin assignment Raspberry Pi

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

This is a sample program that prints a console output when as signal is detected at the sensor.

# 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

# Load libraries
from machine import Pin, Timer

# Initialization of GPIO as input
sensor = Pin(26, Pin.IN, Pin.PULL_DOWN)

# Create timer
timer = Timer()

# Variables initialization
counter = 0

# Function: Count steps
def step(timer):
    global counter
    counter = counter + 1
    print("Schräglage")
    print(counter)

# Function: Vibration
def shake(pin):
    # Debounce function: Set timer
    timer.init(mode=Timer.ONE_SHOT, period=100, callback=step)

# Initialization of the interrupt
sensor.irq(trigger=Pin.IRQ_FALLING, handler=shake)