Swiftpack.co - Package - uraimo/SG90Servo.swift

SG90Servo.swift

A Swift library for the SG90 servo motor, that can be adapted to work with other servos (9g ES08A, SM-S4303R, S3003, ...).

Linux-only Swift 4 compatible License: MIT

SG90 Servo Motor

Summary

This simple library can control an SG90 servo motor with a PWM, that has a 20ms period and duty cycle that represent these positions:

  • 1ms = 5%: -90°, left position
  • 1.5ms = 7.5%: -90°, middle position
  • 2ms = 10%: +90°, right position

Your servo could have slightly different settings (1-2% difference), play around with the values in the Position enum (expressed in percentage) to find the right duty cycles for your servo.

Supported Boards

Every board supported by SwiftyGPIO with the PWM feature, right now only RaspberryPis. And you'll need Swift 3.x, check out the SwiftyGPIO readme for more info on where to find it.

The example below uses a RaspberryPi 2 board but you can easily modify the example to use one the the other supported boards, a full working demo projects for the RaspberryPi2 is available in the Examples directory.

Usage

The first thing we need to do is to obtain an instance of PWMOutput from SwiftyGPIO and use it to initialize the SG90Servo object:

import SwiftyGPIO
import SG90Servo

let pwms = SwiftyGPIO.hardwarePWMs(for:.RaspberryPi2)!
let pwm = (pwms[0]?[.P18])!

let s1 = SG90Servo(pwm)
s1.enable()
s1.move(to: .left)
sleep(1)
s1.move(to: .middle)
sleep(1)
s1.move(to: .right)
sleep(1)

s1.disable()

Installation

Please refer to the SwiftyGPIO readme for Swift installation instructions.

Once your board runs Swift, if your version support the Swift Package Manager, you can simply add this library as a dependency of your project and compile with swift build:

  let package = Package(
      name: "MyProject",
      dependencies: [
    .Package(url: "https://github.com/uraimo/SG90Servo.swift.git", majorVersion: 1),
    ...
      ]
      ...
  ) 

The directory Examples contains sample projects that uses SPM, compile it and run the sample with sudo ./.build/debug/TestServo.

If SPM is not supported, you'll need to manually download the library and its dependencies:

wget https://raw.githubusercontent.com/uraimo/SG90Servo.swift/master/Sources/SG90Servo.swift https://raw.githubusercontent.com/uraimo/SwiftyGPIO/master/Sources/SwiftyGPIO.swift https://raw.githubusercontent.com/uraimo/SwiftyGPIO/master/Sources/Presets.swift https://raw.githubusercontent.com/uraimo/SwiftyGPIO/master/Sources/SunXi.swift https://raw.githubusercontent.com/uraimo/SwiftyGPIO/master/Sources/PWM.swift

And once all the files have been downloaded, create an additional file that will contain the code of your application (e.g. main.swift). When your code is ready, compile it with:

swiftc *.swift

The compiler will create a main executable.

As everything interacting with GPIOs, if you are not already root or member of a specific gpio group, you will need to run that binary with sudo ./main.

Github

link
Stars: 5
Help us keep the lights on

Dependencies

Used By

Total: 1