Note: also suitable for TFmini Plus
Connect TFmini to macOS via USB-serial adaptor. Xcode 9, Swift 4 and ORSSerialPort are used for development. 中文版请点击 README_CN.
There are several kinds of commonly used USB-serial adaptors: CH341, CP210X, PL2303, FT232. Uers can download drivers for macOS in these links. We use the driver of CP2104 as example. Connect TFmini to macOS after the installation is finished:
After USB-Serial Adaptor Driver was installed, you can download .dmg from release to use it. If you want to know how the project is build, please read it continue.
Create new Cocoa App project and named to TFmini. DO NOT check option Storyboard.
Close the project and open a macOS console. Create Podfile to the directory of TFmini Xcode project and open it with text editor:
touch Podfile
open -a TextEdit Podfile
Add following code:
target "TFmini"
pod "ORSSerialPort"
The string after target is the name of project. Save the content and close.
Use Cocoapods to import:
pod install
Close the console after finished. Open the .xcworkspace file which is under the directory of the project. Click the little yellow exclamation mark on the top and update the recommended configuration.
Manually add OC to Swift bridging header: TFmini-Bridging-Header.h, within which the TFmini is the name of project. The content is:
#import "ORSSerialPort.h"
#import "ORSSerialPortManager.h"
Select {project name} -> {project name under Targets} -> Build Setting -> Swift Compiler - General -> Objective-C Bridging Header, double click blank space at the right, fill with following code and press ENTER:
$(PROJECT_DIR)/$(PROJECT_NAME)/$(PROJECT_NAME)-Bridging-Header.h
Shown as figure:
Create a new TFmini class, inherited from NSObject.
Add an Object to XIB file, select the created TFmini class at the Class Tab of Identity Inspector, thus we associate the object to TFmini class:
Add Label, Pop Up Button, Push Button, TextView and other controls to the View of Window and add some constraint. Set Window minimum size to, for example, 480*360:
Associate the Open Button and TextView to TFmini and associate Open Button click event. Note that NSTextView needs to be click 3 times to select, carefully do not select ScrollView or ClipView:
@IBOutlet weak var openCloseButton: NSButton!
@IBOutlet var receivedDataTextView: NSTextView!
@IBAction func openOrClosePort(_ sender: Any) {
}
Add the rest of code, mainly is the realization of ORSSerialPortDelegate and NSUserNotificationCenterDelegate.
The @objc dynamic is necessary for later Binding.
The TFmini data decoding is processed by func serialPort(_ serialPort: ORSSerialPort, didReceive data: Data). The buffer will be cleared if received more than 10000 frames.
Please reference to the project source files.
Next step is Binding.
The Binding of serial port name tab:
The Binding of baud rate tab:
The Binding of Open button, make sure it is not valid when no serial port is selected:
Configuration is done. Run the program and select serial port name SLAB_USBtoUART, set baud rate to 115200. There may appear error message when open:
SerialPort SLAB_USBtoUART encountered an error: Error Domain=NSPOSIXErrorDomain Code=1 "Operation not permitted" UserInfo={NSFilePath=/dev/cu.SLAB_USBtoUART, NSLocalizedDescription=Operation not permitted}
Modify the {project name}.entitlements file, add com.apple.security.device.serial and set value to YES. If want to upload the application to AppStore, this is necessary:
Ensure Team is available:
Select {project name} -> {project name under Target} -> Capbilities, and then turn on Keychain Sharing.
Run again, and it should work:
The left is the received 9 bytes of hexadecimal numbers, and the right is the decoded real distance in centimeters.