Mparadis at 22:52, 13 February 2026

2026-02-13T22:52:30Z

← Older revision		Revision as of 22:52, 13 February 2026
Line 10:		Line 10:
	</p>		</p>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x300/50/~~Cocoa_CreateProject~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x300/50/0_newproject.png"></div>
	</div>		</div>

Line 18:		Line 18:
	<p>Next, select a macOS application:</p>		<p>Next, select a macOS application:</p>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/~~Cocoa_Application~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/2_newmacos.png"></div>
	</div>		</div>

Line 26:		Line 26:
	<p>Name the project, select Swift as the language, and continue:</p>		<p>Name the project, select Swift as the language, and continue:</p>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/~~NameProject_Swift~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/3_nameproject.png"></div>
	</div>		</div>

Line 32:		Line 32:
	<h2>Setting up a New Project</h2>		<h2>Setting up a New Project</h2>

	<p>		<p>Now that your project is created, you need to add the Phidget libraries.</p>
	Now that your project is created, you need to add the Phidget libraries ~~(using CocoaPods)~~. ~~Open a terminal at the example location and enter the following~~
	~~command:~~
	</p>

	<~~div class="phd-command-line"~~>~~<code>pod init</code~~></~~div~~>		<p>Go to File > Add Package Dependencies</p>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x280/50/~~Swift_pod_init~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x280/50/4_addpackage.png"></div>
	</div>		</div>

Line 45:		Line 42:
	<h2>Setting up a New Project</h2>		<h2>Setting up a New Project</h2>

	<p>This will ~~create a new Podfile~~. ~~Open the Podfile in your favorite text editor and add a reference to the <b>Phidget22Swift</b> pod:~~</p>		<p>This will pop up the Swift package manager.</p>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x325/50/~~Swift_folder_podfile~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x325/50/5_packageblank.png"></div>
	</div>		</div>

Line 53:		Line 50:
	<h2>Setting up a New Project</h2>		<h2>Setting up a New Project</h2>

	<p>~~Save your edit to~~ the ~~Podfile, and then enter the following command~~ in the ~~terminal which was opened at the example location~~:</p>		<p>Type this URL into the search bar in the top right:</p>

	<div class="phd-command-line"><code>~~pod install~~</code></div>		<div class="phd-command-line"><code>https://www.phidgets.com/git/phidget22-swift.git</code></div>

	<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-~~x280~~/50/~~Swift_pod_install_example~~.png"></div>		<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x270/50/6_packagewithphidgetURL.png"></div>

			<p>Then select the phidget22-swift package and click <b>Add Package</b></p>
	</div>		</div>

Line 63:		Line 62:
	<h2>Setting up a New Project</h2>		<h2>Setting up a New Project</h2>

	<p>~~After running the command, open the <b>xcworkspace</b> file and~~ access the Phidget libraries by adding the following line to the top of your files:</p>		<p>Now you can access the Phidget libraries by adding the following line to the top of your files:</p>

	<pre data-syntax-language="swift">import Phidget22Swift</pre>		<pre data-syntax-language="swift">import Phidget22Swift</pre>

Mparadis: Created page with "

Language - Swift

2021-03-08T21:54:26Z

Created page with "<div class="phd-slide-deck" data-deck="PT3_SWIFT_MAC_XCODE_2"> <div class="phd-slide-deck-header"><h3>Language - Swift</h3></div> <div class="phd-slides"> <div class="phd-slid..."

New page
<div class="phd-slide-deck" data-deck="PT3_SWIFT_MAC_XCODE_2">
<div class="phd-slide-deck-header"><h3>Language - Swift</h3></div>
<div class="phd-slides">
<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>
Whether you are building a project from scratch, or adding Phidget functionality to an existing project, you will need to configure your development environment
to properly link the Phidget libraries. To begin, create a new Xcode project:
</p>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x300/50/Cocoa_CreateProject.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>Next, select a macOS application:</p>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/Cocoa_Application.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>Name the project, select Swift as the language, and continue:</p>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x350/50/NameProject_Swift.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>
Now that your project is created, you need to add the Phidget libraries (using CocoaPods). Open a terminal at the example location and enter the following
command:
</p>

<div class="phd-command-line"><code>pod init</code></div>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x280/50/Swift_pod_init.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>This will create a new Podfile. Open the Podfile in your favorite text editor and add a reference to the <b>Phidget22Swift</b> pod:</p>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x325/50/Swift_folder_podfile.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>Save your edit to the Podfile, and then enter the following command in the terminal which was opened at the example location:</p>

<div class="phd-command-line"><code>pod install</code></div>

<div class="phd-lazy-image" data-src="https://www.phidgets.com/decks/PT3_SWIFT_MAC_XCODE_2/-x280/50/Swift_pod_install_example.png"></div>
</div>

<div class="phd-slide">
<h2>Setting up a New Project</h2>

<p>After running the command, open the <b>xcworkspace</b> file and access the Phidget libraries by adding the following line to the top of your files:</p>

<pre data-syntax-language="swift">import Phidget22Swift</pre>

<p>Success! The project now has access to Phidgets and we are ready to begin coding.</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<p>
You should now have working examples and a project that is configured. This next teaching section will help you understand how the examples were written so you
can start writing your own code.
</p>

<p>Remember: your main reference for writing Swift code will be:</p>

<p>● The <span>[https://www.phidgets.com/?view=api Phidget22 API]</span> Manual</p>

<p>● Swift <span>[https://www.phidgets.com/?view=code_samples&lang=Swift example code]</span></p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step One: Create And Address</h3>

<p>First, create a Phidget object. For example, we can create a digital input object like this:</p>

<pre data-syntax-language="swift">let ch = DigitalInput()</pre>

<p>Next, we can address which Phidget we want to connect to by setting parameters such as <b>DeviceSerialNumber</b>.</p>

<pre data-syntax-language="swift">ch.setDeviceSerialNumber(496911);</pre>

<p>
This guide won't go in-depth on <span>[https://www.phidgets.com/docs/Handling_Errors_and_Logging error handling]</span>, but here is an example of the previous
code with error handling:
</p>

<pre data-syntax-language="swift">
do{
try ch.open
}catch let error as PhidgetError{
//handle error
}</pre
>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Two: Open And Wait For Attachment</h3>

<p>After we have specified which Phidget to connect to, we can open the Phidget object like this:</p>

<pre data-syntax-language="swift">ch.open(timeout: 5000)</pre>

<p>
To use a Phidget, it must be plugged in (attached). We can handle this by calling <b>open(timeout)</b>, which will block until a connection is made, or until
the timeout expires. Simply calling <b>open()</b> does not guarantee you can use the Phidget immediately.
</p>

<p>Instead, you can verify the device is attached by using an attach handler. To use events to handle attachments, we have to modify our code slightly:</p>

<pre data-syntax-language="swift">
PhidgetDigitalInputHandle ch;
PhidgetDigitalInput_create(&ch);
ch.attach.addHandler(attach_handler)
Phidget_open(ch)</pre
>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Two: Open And Wait For Attachment</h3>

<p>
Next, we have to declare the function that will be called when an attach event is fired - in this case the function <b>onAttachHandler</b> will be called:
</p>

<pre data-syntax-language="swift">
func attach_handler(sender: Phidget){
let attachedDevice = sender as! DigitalInput
//configure device here
}</pre
>

<p>
We recommend using this attach handler to set any initialization parameters for the channel such as <b>DataInterval</b> and <b>ChangeTrigger</b> from within the
AttachHandler, so the parameters are set as soon as the device becomes available.
</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Three: Do Things With The Phidget</h3>

<p>
We recommend the use of event driven programming when working with Phidgets. In a similar way to handling an attach event as described above, we can also add an
event handler for a state change event:
</p>

<pre data-syntax-language="swift">
ch.attach.addHandler(attach_handler)
ch.stateChange.addhandler(stateChange_handler)
ch.open()</pre
>

<p>
This code will connect a function to an event. In this case, the <b>onStateChangeHandler</b> function will be called when there has been a change to the
channel's input.
</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Three: Do Things With The Phidget</h3>

<p>Next, we need to create the <b>onStateChangeHandler</b> function:</p>

<pre data-syntax-language="swift">
func stateChange_handler(sender: DigitalInput, state: Bool){
if(state){
//state is true
}
else{
//State is false
}
}</pre
>

<p>
If you are using multiple Phidgets in your program, check out our page on
<span>[https://www.phidgets.com/docs/Using_Multiple_Phidgets Using Multiple Phidgets]</span> for information on how to properly address them and use them in
events.
</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Three: Do Things With The Phidget</h3>

<p>If events do not suit your needs, you can also poll the device directly for data using code like this:</p>

<pre data-syntax-language="swift">
var state = ch.getState()
stateLabel.text = state ? "True" : "False"</pre
>

<p>
<b>Important Note</b>: There will be a period of time between the attachment of a Phidget sensor and the availability of the first data from the device. Any
attempts to get this data before it is ready will result in an error code, and a specific nonsensical result. See more information on this on our page for
<span>[https://www.phidgets.com/docs/Unknown_Values Unknown Values]</span>.
</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Three: Do Things With The Phidget</h3>

<p>
Some Phidget devices have functions that deal with specific predefined values called <b>enumerations</b>. Enumerations commonly provide readable names to a set
of numbered options.
</p>

<p>Enumerations with Phidgets in Swift will take the form of <b>Phidget22Swift.EnumerationType.enumerationName</b>.</p>

<p>For example, specifying a SensorType to use the 1142 for a voltage input would look like:</p>

<pre data-syntax-language="swift">Phidget22Swift.VoltageSensorType.PN_1142</pre>

<p>and specifying a K-Type thermocouple for a temperature sensor would be:</p>

<pre data-syntax-language="swift">Phidget22Swift.ThermocoupleType.K</pre>

<p>The Phidget error code for timing out could be specified as:</p>

<pre data-syntax-language="swift">Phidget22Swift.ErrorCode.timeout</pre>

<p>
You can find the Enumeration Type under the <b>Enumerations</b> section of the <span>[https://www.phidgets.com/?view=api Phidget22 API]</span> for your device,
and the Enumeration Name in the drop-down list within.
</p>
</div>

<div class="phd-slide">
<h2>Write Code</h2>

<h3>Step Four: Close</h3>

<p>At the end of your program, be sure to close your device:</p>

<pre data-syntax-language="swift">ch.close()</pre>
</div>

<div class="phd-slide">
<h2>What's Next?</h2>

<p>{{Slide_Deck_PT3_Outro}}</p>
</div>
</div>

<div class="phd-navigation-buttons">
<div class="phd-simple-button phd-to-slide-button" data-navigation-direction="prev">«</div>
<div class="phd-progress-container">
<div class="phd-progress-bar">
<div class="phd-progress-slide-info"></div>
</div>
</div>

<div class="phd-simple-button phd-to-slide-button" data-navigation-direction="next">»</div>
</div>
<div hidden class="phd-hidden-breadcrumb-label" data-label="New Project"></div>
</div>

Template:PT3 SWIFT MAC XCODE 2 - Revision history

Mparadis at 22:52, 13 February 2026

Language - Swift