A Swift Package to communicate with a VanMoof S3 & X3 Bike 🚲
import VanMoofKit
let vanMoof = VanMoof()
try await vanMoof.login(
username: "knight.rider@vanmoof.com",
password: "********"
)
let bikes = try await vanMoof.bikes()
for bike in bikes {
try await bike.connect()
try await bike.playSound()
}Important
VanMoofKit is not an official library of VanMoof B.V. This Swift Package makes certain features of the bike accessible which may be illegal to use in certain jurisdictions. As this library hasn't reached an official stable version some features are not yet available or may not working as expected.
- Access the VanMoof Web API through native Swift Code 👨💻👩💻
- Establish a bluetooth connection to a VanMoof Bike using async/await 🚲.
- Easily change the configuration of the bike such as bell sound, power level, light mode and many more ⚙️
- Combine support to react to changes of certain functions ⛓️
Check out the example application to see VanMoofKit in action. Simply open the Example/Example.xcodeproj and run the "Example" scheme.
The VanMoofKit Swift Package includes a CLI that allows you to easily export your VanMoof account data including the encryption keys of your bikes.
$ swift run vanmoof export --username "knight.rider@vanmoof.com" --password "********" --outputDirectory "~/Downloads"Note
The login credentials aren't persisted or logged they are only used to authenticate against the VanMoof API.
The --outputDirectory parameter is optional. If not specified, the export will automatically be saved at ~/Desktop
To integrate using Apple's Swift Package Manager, add the following as a dependency to your Package.swift:
dependencies: [
.package(url: "https://github.com/SvenTiigi/VanMoofKit.git", from: "0.0.6")
]Or navigate to your Xcode project then select Swift Packages, click the “+” icon and search for VanMoofKit.
As the VanMoofKit is using the CoreBluetooth framework to establish a BLE connection to a bike the NSBluetoothAlwaysUsageDescription key needs to be added to the Info.plist of your application.
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Establishing a bluetooth connection to your VanMoof Bike.</string>To retrieve bikes of a VanMoof account you first need to initialize an instance of VanMoof.
let vanMoof = VanMoof()To authenticate simply call the login function on instance of a VanMoof object.
try await vanMoof.login(
username: "kight.rider@vanmoof.com",
password: "********"
)Note
The login credentials aren't persisted or logged they are only used to authenticate against the VanMoof API.
Make use of the vanMoof.isAuthenticated property to check if the user is already logged in.
if vanMoof.isAuthenticated {
// ...
}The login produces a VanMoof.Token which is automatically stored in an instance of a VanMoofTokenStore. You can configure the persistence of the token when creating an instance of VanMoof.
let vanMoof = VanMoof(
// Specify an instance which conforms to the `VanMoofTokenStore` protocol.
// Predefined implementations:
// - KeychainVanMoofTokenStore
// - LARightVanMoofTokenStore
// - NSUbiquitousVanMoofTokenStore
// - UserDefaultsVanMoofTokenStore
// - InMemoryVanMoofTokenStore
tokenStore: .keychain()
)Note
In default the UserDefaultsVanMoofTokenStore will be used to store the VanMoof.Token.
After the login has succeeded you can retrieve the user profile and the associated bikes.
// Retrieve the user
let user: VanMoof.User = try await vanMoof.user()
print("Available Bikes", user.bikes)
// If you want to directly retrieve the bikes call:
let bikes: [VanMoof.Bike] = try vanMoof.bikes()To logout the current user call:
vanMoof.logout()Note
Logging out an user has no effect on any available VanMoof.Bike instance. It is the developer responsibility to terminate any open connection to a VanMoof.Bike.
Some information such as the name of the bike, frame number and more are available without an active connection to the bike. You can access those information via the bike.details property.
let details: VanMoof.Bike.Details = bike.details
print(details.name)
print(details.macAddress)
print(details.frameNumber)
// Or access the details properties directly
// (powered by the @dynamicMemberLookup attribute)
print(bike.name, bike.macAddress, bike.frameNumber)As a VanMoof.Bike is conform to the Codable protocol you can create an instance from a local JSON file.
// Retrieve the JSON file url from the main bundle
let bikeJSONFileURL = Bundle.main.url(forResource: "Bike", withExtension: "json")!
// Try to load the contents of the JSON file
let bikeJSONData = try Data(contentsOf: bikeJSONFileURL)
// Try to decode VanMoof Bike from JSON data
let bike: VanMoof.Bike = try JSONDecoder().decode(VanMoof.Bike.self, from: bikeJSONData)To establish a connection to a VanMoof.Bike call:
// Try to connect to the bike
try await bike.connect()You can retrieve the current state of the connection in the following way.
// Switch on connectionState
switch bike.connectionState {
case .disconnected:
print("Disconnected")
case .discovering:
print("Discovering")
case .connecting:
print("Connecting")
case .connected:
print("Connected")
case .disconnecting:
print("Disconnecting")
}
// Or make use of convience properties such as:
let isConnected: Bool = bike.isConnected
let isDisconnected: Bool = bike.isDisconnected
// Alternatively you can use a Publisher
bike.connectionStatePublisher
.sink { connectionState in
// ...
}
// Or a specialized publisher which only emits connection errors
bike.connectionErrorPublisher
.sink { connectionError in
// ...
}Additionally, you can monitor the signal strength of the connection via:
// Retrieve the current signal strength
let signalStrength: VanMoof.Bike.SignalStrength = try await bike.signalStrength
// A Publisher that emits the current signal strength in a given update interval
bike.signalStrengthPublisher(
updateInterval: 5
).sink { signalStrength in
// ...
}If you wish to terminate the connection simply call:
// Disconnect from the bike
try await bike.disconnect()switch try await bike.moduleState {
case .on:
break
case .off:
break
default:
break
}
bike.moduleStatePublisher.sink { moduleState in
// ...
}
try await bike.set(moduleState: .on)
// Alias for setting the module state to on
try await bike.wakeUp()switch try await bike.lockState {
case .unlocked:
break
case .locked:
break
case .awaitingUnlock:
break
}
bike.lockStatePublisher.sink { lockState in
// ...
}
// Unlock Bike
try await bike.unlock()let batteryLevel = try await bike.batteryLevel
bike.batteryLevelPublisher.sink { batteryLevel in
// ...
}switch try await bike.batteryState {
case .notCharging;
break
case .charging:
break
}
bike.batteryStatePublisher.sink { batteryState in
// ...
}switch try await bike.speedLimit {
case .europe:
print("Europe 25 km/h")
case .unitedStates:
print("United States 32 km/h")
case .japan:
print("Japan 24 km/h")
}
bike.speedLimitPublisher.sink { speedLimit in
// ...
}Warning
Changing the speed limit may be illegal in certain jurisdictions.
try await bike.set(speedLimit: .unitedStates)switch try await bike.powerLevel {
case .off:
break
case .one:
break
case .two:
break
case .three:
break
case .four:
break
}
bike.powerLevelPublisher.sink { powerLevel in
// ...
}
try await bike.set(powerLevel: .four)switch try await bike.lightMode {
case .auto:
break
case .alwaysOn:
break
case .off:
break
}
bike.lightModePublisher.sink { lightMode in
// ...
}
try await bike.set(lightMode: .alwaysOn)switch try await bike.bellSound {
case .sonar:
break
case .bell:
break
case .party:
break
case .foghorn:
break
}
bike.bellSoundPublisher.sink { bellSound in
// ...
}
try await bike.set(bellSound: .party)try await bike.play(sound: .scrollingTone)
try await bike.play(sound: .beepPositive)
try await bike.play(sound: .alarmStageOne)// An integer in the range from 0 to 100
let soundVolume: Int = try await bike.soundVolumelet totalDistance: VanMoof.Bike.Distance = try await bike.totalDistance
bike.totalDistancePublisher.sink { totalDistance in
// ...
}switch try await bike.unitSystem {
case .metric:
break
case .imperial:
break
}
bike.unitSystemPublisher.sink { unitSystem in
// ...
}
try await bike.set(unitSystem: .metric)let bikeFirmwareVersion: String = try await bike.firmwareVersion
let bleChipFirmwareVersion: String = try await bike.bleChipFirmwareVersion
let eShifterFirmwareVersion: String = try await bike.eShifterFirmwareVersion