ºÝºÝߣ

ºÝºÝߣShare a Scribd company logo

[Hack3City] Estimote Beacons development - get started

?
?
Mateusz Klimczak
Mateusz Klimczak

This document provides information about using Estimote beacons on iOS and Android platforms. It discusses the requirements, installation process using CocoaPods for iOS, and potential issues when detecting beacons. It also notes there is a security problem, as unprotected read and write capabilities mean anyone can access and change a beacon's broadcast information.

1 of 19
Downloaded 21 times
ESTIMOTE BEACONS DEVELOPMENT Get started by Mateusz Klimczak @ Movade
IOS - REQUIREMENTS Bluetooth Low Energy (4.0, AKA SMART), ? supported devices: iPhone 4s+ iPad 3+ iPad mini 1+ iPod touch 5+
IOS - INSTALLATION Manual CocoaPods - recommended
COCOAPODS CocoaPods is the Objective-C dependency manager You specify the dependencies for your project in one easy text file CocoaPods resolves dependencies between libraries, fetches source code for the dependencies, and creates and maintains an Xcode workspace to build your project
COCOAPODS - USAGE Installation (only first time):? sudo gem install cocoapods Create Podfile (in project directory):? touch Podfile Edit & save Podfile:? platform :ios, 7.0? target :YourAppName do? pod 'EstimoteSDK', '~> 1.3'? end Run CocoaPods (it can take a few minutes for the first time):? pod install From now you open .xcworkspace file instead of .xcodeproj file
COCOAPODS - PROJECT
COCOAPODS GitHub:? https://github.com/CocoaPods/CocoaPods Official webpage (with pods search engine):? http://cocoapods.org/
IOS - PREREQUISITES Add required frameworks to your project: CoreBluetooth.framework CoreLocation.framework SystemConfiguration.framework
IOS - PREREQUISITES
IOS - PREREQUISITES In your project settings add to Capabilities -> Background modes: Use Bluetooth LE accessories Acts as a Bluetooth LE accessory Background fetch Remote notifications
IOS - PREREQUISITES
IOS - MORE INFO https://github.com/Estimote/iOS-SDK?
IOS - POTENTIAL PROBLEMS From iOS 7.1 detecting beacons problem can appear, possible solutions:? 1. Shut down and restart - some people have reported that this is all that was needed to fix their device after the iOS 7.1 upgrade.? ? 2. Toggle Bluetooth OFF and back ON - Swipe up to access Control Center and tap the Bluetooth icon, wait at least 30 seconds, then toggle it back on. This can often repair a device which is experiencing connection issues. ? ? 3. Kill (force quit) the offending app - Start by double clicking Home to launch the multitasking cards interface. Touch and hold the card for the app, then toss it up and away. This will force the app to quit and it will be fully reloaded the next time the app is opened.? ? 4. Clear and reset your Bluetooth device pairing - Go to Settings>Bluetooth and tap on the (i) icon for the offending device. Tap on Forget this Device. Now you should be able to re-add and re-pair the Bluetooth hardware to your device." ? ? Source: ? https://community.estimote.com/hc/en-us/articles/201872076-Issues-with-detecting-beacons-in-iOS-7-1-?
ANDROID - REQUIREMENTS Android 4.3 or above Bluetooth Low Energy (4.0, AKA SMART)
ANDROID - INSTALLATION Copy estimote-sdk-preview.jar to your libs directory? Download direct link: ? https://github.com/Estimote/Android-SDK/raw/ master/EstimoteSDK/estimote-sdk-preview.jar
ANDROID - INSTALLATION Add following permissions and service declaration to your AndroidManifest.xml:? ? <service android:name="com.estimote.sdk.service.BeaconService" android:exported="false"/> <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
ANDROID - MORE INFO https://github.com/Estimote/Android-SDK
SECURITY PROBLEM - BOTH PLATFORMS Unprotected read&write! Anyone can read what our beacon broadcast Anyone can write to our beacon - change its UUID, range, frequency¡­.
CONTACT INFO hack@movade.com Facebook group: Hack3city Estimote

More Related Content

[Hack3City] Estimote Beacons development - get started

  • 2. IOS - REQUIREMENTS Bluetooth Low Energy (4.0, AKA SMART), ? supported devices: iPhone 4s+ iPad 3+ iPad mini 1+ iPod touch 5+
  • 4. COCOAPODS CocoaPods is the Objective-C dependency manager You specify the dependencies for your project in one easy text file CocoaPods resolves dependencies between libraries, fetches source code for the dependencies, and creates and maintains an Xcode workspace to build your project
  • 5. COCOAPODS - USAGE Installation (only first time):? sudo gem install cocoapods Create Podfile (in project directory):? touch Podfile Edit & save Podfile:? platform :ios, 7.0? target :YourAppName do? pod 'EstimoteSDK', '~> 1.3'? end Run CocoaPods (it can take a few minutes for the first time):? pod install From now you open .xcworkspace file instead of .xcodeproj file
  • 8. IOS - PREREQUISITES Add required frameworks to your project: CoreBluetooth.framework CoreLocation.framework SystemConfiguration.framework
  • 10. IOS - PREREQUISITES In your project settings add to Capabilities -> Background modes: Use Bluetooth LE accessories Acts as a Bluetooth LE accessory Background fetch Remote notifications
  • 12. IOS - MORE INFO https://github.com/Estimote/iOS-SDK?
  • 13. IOS - POTENTIAL PROBLEMS From iOS 7.1 detecting beacons problem can appear, possible solutions:? 1. Shut down and restart - some people have reported that this is all that was needed to fix their device after the iOS 7.1 upgrade.? ? 2. Toggle Bluetooth OFF and back ON - Swipe up to access Control Center and tap the Bluetooth icon, wait at least 30 seconds, then toggle it back on. This can often repair a device which is experiencing connection issues. ? ? 3. Kill (force quit) the offending app - Start by double clicking Home to launch the multitasking cards interface. Touch and hold the card for the app, then toss it up and away. This will force the app to quit and it will be fully reloaded the next time the app is opened.? ? 4. Clear and reset your Bluetooth device pairing - Go to Settings>Bluetooth and tap on the (i) icon for the offending device. Tap on Forget this Device. Now you should be able to re-add and re-pair the Bluetooth hardware to your device." ? ? Source: ? https://community.estimote.com/hc/en-us/articles/201872076-Issues-with-detecting-beacons-in-iOS-7-1-?
  • 14. ANDROID - REQUIREMENTS Android 4.3 or above Bluetooth Low Energy (4.0, AKA SMART)
  • 15. ANDROID - INSTALLATION Copy estimote-sdk-preview.jar to your libs directory? Download direct link: ? https://github.com/Estimote/Android-SDK/raw/ master/EstimoteSDK/estimote-sdk-preview.jar
  • 16. ANDROID - INSTALLATION Add following permissions and service declaration to your AndroidManifest.xml:? ? <service android:name="com.estimote.sdk.service.BeaconService" android:exported="false"/> <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
  • 17. ANDROID - MORE INFO https://github.com/Estimote/Android-SDK
  • 18. SECURITY PROBLEM - BOTH PLATFORMS Unprotected read&write! Anyone can read what our beacon broadcast Anyone can write to our beacon - change its UUID, range, frequency¡­.