Phidgets SBC2 User manual

Product Manual
1072 - PhidgetSBC2

Phidgets 1072 - Product Manual
For Board Revision 0
© Phidgets Inc. 2011

Contents
6 Introduction
6 Overview
6 Product Features
6 Computer
6 Connections
7 Integrated InterfaceKit 8/8/8
7 Programming Environment
8 Getting Started Guide
8 Checking the Contents
8 Connecting all the pieces
9 Testing Using Windows 2000/XP/Vista
9 Downloading the Phidgets drivers
9 Running Phidgets Sample Program
10 Setting the Password
10 Updating the SBC
11 Testing the Phidget InterfaceKit 8/8/8 Over the Webservice
12 Viewing the Webcam
12 Rebooting/Resetting the PhidgetSBC
13 Ports
14 User’s Guide
14 Basic Use
14 Phidget Webservice
14 Reliability
15 Finding Phidgets on the Network
16 Configuration (Web Interface)
16 TheCongurationPages
17 Status: System
17 Status: Network
17 Status: Processes
17 Status: USB
18 Status: Phidgets
18 Network: Status
18 Network: Settings
18 Network: Wireless
19 Phidgets: Status

19 Phidgets: Webservice
20 Projects: Projects
21 Webcam: Webcam
21 System: General
21 System: Logs
22 System: Password Change
22 System: File Editor
22 System: Backup & Restore
23 System: Packages
23 System: Reboot
23 Main: About
24 Networking Guide
24 Initial Setup
24 ZeroCongurationNetworking
24 Setting up an Ethernet Connection
24 Setting up a Wireless connection
25 No DHCP Server?
26 Advanced User’s Guide
26 Custom Applications
26 Java
27 C/C++
27 Other Languages
27 Debian/Packages
27 Phidget Dictionary
27 SSH/SFTP
28 Custom Kernel and Filesystem
29 Recovery / Upgrade System
29 Entering the Recovery System
29 Upgrades
29 Factory Reset
29 Recovery
30 Technical
30 Power Over Ethernet
30 Hardware Layout
30 Software Layout
30 Date and Time
30 Wireless Networking System

30 Configuration System
31 Nand Layout
31 Boot Process
31 Drivers for USB to Serial adapters
32 U-Boot
32 SBC2 Device Specifications
33 PhidgetInterfaceKit 8/8/8
33 General
33 Product Features
33 Programming Environment
33 Programming a Phidget
33 Architecture
33 Libraries
34 Programming Hints
34 Networking Phidgets
34 Documentation
34 Code Samples
35 API for the InterfaceKit 8/8/8
37 Technical
37 Analog Inputs
40 Digital Inputs
43 Digital Outputs
45 Using the 6-Port USB Hub
46 InterfaceKit8/8/8DeviceSpecications
47 Product History
47 Support
47 Legal Information

6
1072_0_Product_Manual - February 24, 2011 2:52 PM
Introduction
Overview
The PhidgetSBC2 is a Single Board Computer with an integrated
PhidgetInterfaceKit 8/8/8. At its most basic, it can be thought
of as a Phidget that you connect using a network cable instead
of USB. The PhidgetSBC2 also provides six full-speed ports
that allow you to use normal USB Phidgets over its network
connection. This can extend the effective range of a Phidget
from USB’s maximum of 15 feet, to anywhere that your network
reaches.
The PhidgetSBC2 exposes an easy to use interface for setting
up and running custom applications on-board. This allows the
PhidgetSBC2 to operate autonomously, without the need for a
graphical interface or a remote connection at all times.
For more advanced users, the PhidgetSBC is an embedded
computer that runs Debian GNU/Linux. We provide full shell
access via a built-in SSH server, access to the full Debian package
repository, and all of the standard command line tools expected
on a modern Linux system.
An integrated PhidgetInterfaceKit 8/8/8 allows you to connect devices to any of 8 analog inputs, 8 digital inputs and
8 digital outputs. It provides a generic, convenient way to interface your PC and PhidgetSBC with a wide variety of
devices and it operates exactly the same way as an external PhidgetInterfaceKit.
Product Features
Computer
Single board computer running Debian with access to the full Debian package repository.•
Webbasedcongurationandmonitoringinterface.•
Abundant on-board storage.•
Run custom programs on-board for autonomous operation.•
Realtime clock with battery backup.•
Connections
6 full-speed USB ports with built in support for webcams, Phidget USB devices, and other USB devices.•
Ethernet port. Remotely use attached Phidgets from another computer anywhere over the network.•

7
1072_0_Product_Manual - February 24, 2011 2:52 PM
Programming Environment
Operating System: Custom Linux Distro, built using Buildroot
Programming Languages (APIs): C/C++, Java
Examples: Many example applications for all the operating systems and development environments above are
available for download at www.phidgets.com.
Note: AninternetbrowserisrequiredtousethecongurationGUI.
When controlling the PhidgetSBC remotely, you can use any Phidgets supported operating systems and languages:
Operating Systems: Windows 2000/XP/Vista, Windows CE, Linux, and Mac OS X
Programming Languages (APIs): VB6, VB.NET, C#.NET, C++, Flash 9, Flex, Java, LabVIEW, Python, Max/MSP,
and Cocoa.
Integrated InterfaceKit 8/8/8
The PhidgetInterfaceKit 8/8/8 allows you to connect devices to any of 8 analog inputs, 8 digital inputs and 8 digital
outputs.
Analog inputs
They are used to measure continuous quantities, such as temperature, humidity, position, pressure, etc. Phidgets
offers a wide variety of sensors that can be plugged directly into the board using the cable included with the sensor.
Here is a partial list of sensors currently available:
IRDistanceSensor IRReectiveSensor VibrationSensor LightSensor
Force Sensor Humidity Sensor Temperature Sensor Magnetic Sensor
Rotation Sensor Voltage Divider Touch Sensor Motion Sensor
Mini Joy-Stick Pressure Sensor Voltage Sensor Current Sensor
Slide Sensor
Digital Inputs
Digital Inputs can be used to convey the state of push buttons, limit switches, relays, logic levels, etc...
Digital Outputs
Digital Outputs can be used to drive LEDs, solid state relays (have a look at our SSR board), transistors; in fact,
anything that will accept a CMOS signal.
Digital outputs can be used to control devices that accept a +5V control signal.
With transistors and some electronics experience, other devices can be controlled, such as buzzers, lights, larger
LEDs, relays.

8
1072_0_Product_Manual - February 24, 2011 2:52 PM
Connect the analog sensor to the analog1.
input port 4 using a Phidgets sensor
cable. The analog input ports are
numbered from 0 to 7 starting from the
left.
Connect one end of a wire to digital2.
input port 0 and the other end to
ground (labelled ‘G’ on the underside of
the board).
Connect the LED by inserting the long3.
LED wire into the digital output 7 and
the shorter wire into Ground.
Connect the power supply to the4.
PhidgetSBC2 using the barrel connector.
Connect the PhidgetSBC2 to your5.
network with an Ethernet cable.
Plug the wall adapter into an appropriate outlet. The red status indicator light located near the USB ports should
be lit if the unit is receiving power. The green LED located above the red LED indicates boot status. The green
LED will turn on and off once during boot and then turn back on when everything is running.
Other Phidgets can also be connected to the 1072 using a USB cable.6.
Getting Started Guide
Checking the Contents
You should have received:
A Power Supply1.
A Cat-5e network cable2.
A Mounting kit (4 nuts & bolts, 4 plastic spacers)3.
A PhidgetSBC2 Board4.
To test your new PhidgetSBC, you will also
need:
A short length of wire to test the digital inputs•
An LED to test the digital outputs•
An Analog Sensor to test the analog inputs•
A UVC compatible Webcam•
2
1
43
Connecting all the pieces
2
1
4
5
3
6

9
1072_0_Product_Manual - February 24, 2011 2:52 PM
Make sure that the PhidgetSBC2 is powered and
properly connected to your network.
Click the PhidgetSBC2 tab in the Phidget Control
Panel.
Double click on the PhidgetSBC2 device to bring up
thePhidgetSBC2congurationpanelinyourdefault
web browser
You can differentiate multiple PhidgetSBC2s by their
MAC address, which is printed on the sticker on the
back of your board.
Testing Using Windows 2000/XP/Vista
Downloading the Phidgets drivers
Make sure that you have the current version of the Phidget library installed on your PC. If you don’t, do the
following:
Go to www.phidgets.com >> Drivers
Download and run Phidget21 Installer (32-bit, or 64-bit, depending on your PC)
You should see the icon on the right hand corner of the Task Bar.
Running Phidgets Sample Program
Double clicking on the icon loads the Phidget Control Panel; we will use this program to make sure that your
new Phidget works properly.

10
1072_0_Product_Manual - February 24, 2011 2:52 PM
Updating the SBC
Click on System >> Packages.
Click “Refresh Available Packages”
Any available updates will be
shown. If there are updates
available, click “Upgrade All
Packages” to download and install
them.
Setting the Password
Onyourrstvisittothe
PhidgetSBCwebconguration,you
will need to set a password.
Type in your password and click on
Set.
Subsequent visits will use the
username ‘admin’ and the
password you chose.
The PhidgetSBC Info is displayed.

11
1072_0_Product_Manual - February 24, 2011 2:52 PM
Testing the Phidget InterfaceKit
8/8/8 Over the Webservice
Open the Phidget control panel.1.
Click on the WebService->Bonjour tab.2.
Double click the Phidget InterfaceKit 8/8/8 with the3.
‘phidgetsbc’ Server ID to bring up InterfaceKit-full.
In the drop down menu, select the1.
Sensor you have attached to the
analog input port 4 of the1018.
In our case we select the 1124 -
Precision Temperature Sensor.
The ambient temperature sensed by2.
the 1124.
Formula used to convert the analog3.
input sensorval into temperature.
Note: Value and formula information will
vary from sensor to sensor.
Check that the box labelled1.
Attached contains the word True.
Test the digital output by clicking2.
on the white box to turn on the
LED. Clicking again will turn the
LED off. The bottom row shows
the status of the request, while
the top row displays the status of
the digital output as reported by
the device.
Test the digital input by3.
disconnecting the wire end
connected to the digital input.
connector. The tick mark in the
box will go away.
Click on the Ratiometric Box if4.
your sensor is ratiometric. Check the sensor product manual if you are not sure.
Test the analog input sensor by observing the sensor value as you activate the Phidget sensor.5.
You can adjust the input sensitivity by moving the slider pointer.6.
Click on Sensors to launch the Advanced Sensor Form.7.
1
2
6
5
3
4
7
1
2

12
1072_0_Product_Manual - February 24, 2011 2:52 PM
Viewing the Webcam
Connect a UVC compatible1.
webcam to your PhidgetSBC.
Launchtheconguration2.
interface.
Click the Webcam tab.3.
Under the settings, select4.
‘Enabled’ for the webcam,
choose your resolution and
frame rate, and then click
‘Save Changes’.
The webcam stream should5.
now be visible.
Rebooting/Resetting the PhidgetSBC
To reboot the device, quickly press the black reset button found between the USB connectors and the power
terminals. Both Ethernet Port LEDs (yellow-connectivity, green-activity), and the green status LED will turn off. The
reboot is done when all LEDs come back on in about 25 seconds.
Toresetthermware,pressandholdthebuttonfor10secondsuntilthegreenstatusLEDbeginstoblink,then
release. Both Ethernet Port LEDs will turn off (yellow-connectivity, green-activity) for 80 seconds; the green status
LED will then turn off; then all LEDs will come back on in 20 seconds. All data will be lost and the operating system
will be reset to a factory state.
To boot into the Recovery / Upgrade system, hold the button for 20 seconds until the green status LED switches
from blinking slowly to blinking quickly, then release. The recovery system allows for factory reset, full system
upgrades and recovery of the main system.

13
1072_0_Product_Manual - February 24, 2011 2:52 PM
Ports
Numbered in the circles on the
diagram:
10/100baseT Ethernet1.
Six USB Full-Speed Ports2.
Indicator LEDs3.
Reboot / Reset Button4.
Power input terminal5.
Power input jack6.
Eight Interface Kit Digital Inputs7.
(Indexed 0 to 7)
Eight Interface Kit Digital8.
Outputs (Indexed 0 to 7)
Eight Interface Kit Analog Inputs9.
(Indexed 0 to 7)
2
1
45
36
8
9
7
G
0
1
2
3
4
5
6
7
5v
G
0
1
2
3
4
5
6
7
5v
G +
1234567 0
This Ethernet port is used for network connectivity to the PhidgetSBC. This enables access to the PhidgetSBC as1.
well as any connected Phidgets through the webservice. Alternatively, the USB Wireless adapter can be used for
network connectivity.
TheseUSBportscanbeusedforconnectingPhidgets,Wi-Fiadapters,ashdrives,webcams,USBhubs,etc.2.
These LEDs indicate the status of the PhidgetSBC. The Red LED indicates that the power supply is on and3.
running properly. The green LED indicates boot status. The green LED will turn on and off once during boot and
then turn back on when everything is running.
This will reboot the board if pressed once. Note that this is a forced reboot. Any user programs that were4.
running may leave their data in a inconsistent state, but this is safe for the base system. A soft reboot can be
performedremotelyfromthecongurationinterface.
If held for more then 10 seconds, the red LED will start to blink and enter emergency Reset mode. Once the
button is released, the onboard memory will revert to a factory-fresh state. This includes overwriting the kernel
androotlesystem,anderasingallconguration,userdata,andapplications.
If held for more then 20 seconds, the Recovery/Upgrade system will be booted, from which a Factory Reset/Full
lesystemupgradecanbeperformed.
5,6. The PhidgetSBC can be powered from either the terminals or the barrel connector. The polarity of the terminals
is also labeled on the underside of the board.
7,8,9. The Interface Kit I/O is explained in the Interface Kit section of the manual.
21
4
53
6
+ G

14
1072_0_Product_Manual - February 24, 2011 2:52 PM
User’s Guide
ThisguideisintendedtoprovidealookintothebasicfunctionalityandcongurationsthatthePhidgetSBCprovides.
Before continuing, make sure the Phidget21 Libraries are installed as outlined in the Quick Start Guide. Refer to the
networkingguideinthenextsectionfordetailsonconguringthePhidgetSBCtorunonanetwork.Advancedtopics
such as working directly with the onboard operating system can be found in the Advanced User’s Guide.
The PhidgetSBC consists of an embedded computer combined with an Interface Kit 8/8/8. These elements are
essentially separate entities as the Interface kit is connected to the embedded computer using an on-board USB link.
The Interface Kit’s use will be described in its own section, while the embedded computer will be detailed here.
Basic Use
Basic use of the PhidgetSBC allows the opening of connected Phidgets over the network. Using another Phidget with
the PhidgetSBC in this way is almost exactly like using Phidgets over USB, in respect to the API calls and behavior.
However, some extra considerations need to be made when working with the PhidgetWebservice.
Phidget Webservice
Support for opening Phidgets over the network is made possible via the Phidget Webservice. This allows a user
to write an application in a system and language of their choosing and then operate Phidgets connected to the
PhidgetSBC. It is a socket based server that runs on the PhidgetSBC at all times (unless disabled), and allows any
attached Phidgets to be seen and opened directly over the network.
Opening and controlling a Phidget over the network is nearly the same as opening one locally. The main differences
are:
Different open calls that include server information. New calls OpenRemote and openRemoteIP (naming depends•
on language).
Access to Webservice based properties: Server hostname, port and ID.•
Access to server connect and disconnect events, and network error events.•
Phidgets can be opened by more then one separate application at the same time.•
Reliability is more of a issue because network connections are easily broken.•
Opening a Phidget over the network is asynchronous and pervasive, just like opening locally. This means that if a
connectiontotheremoteservercannotbeestablishedrightaway,itwillkeeptryingindenitely,andevensurvive
the server being stopped and started, etc.
Instances of the Phidget Webservice can be referred to either using hostname (IP Address) and port number, or by
Server ID. The advantage of using a Server ID is that it stays consistent compared to IP addresses, and you don’t
need to know the Port number. A Webservice Server ID is assigned when the Webservice is run - which on the
PhidgetSBC defaults to ‘phidgetsbc’. In order to use a Server ID, the Bonjour utility also needs to be installed.
Refer to the Programming Manual and the API manual for your language for more information about using the
Phidget Webservice.
Reliability
Determining reliability needs can become important while opening Phidgets over the network, because the network
connection can potentially be interrupted at any time. This can leave the network attached Phidget in an undesirable
state. For example - if a motor controller is driving a motor and the connection is lost, there is no way to stop the
motor until the connection is re-established. These issues are less important if you are just receiving sensor data
from an Interface Kit.

15
1072_0_Product_Manual - February 24, 2011 2:52 PM
It’s generally a good idea to catch server connect and disconnect and Phidget attach and detach events in order to
know the state of the connections. It’s also a good idea to catch error events - this is where network errors will be
reported.
If reliability is important, you should consider writing a program to run locally on the PhidgetSBC, and communicate
with it through the Dictionary interface. This way, if the connection is broken, the local application will notice and be
able to take any appropriate actions. See the advanced chapter for more information.
Finding Phidgets on the Network
AnyPhidgetsattachedtothePhidgetSBCcanbeidentiedusingtheStatus>>Phidgetspageintheconguration
interface, and should be seen on the network through the Webservice.
The Phidget Control Panel has a Bonjour tab (under WebService >> Bonjour) that lists all detected network attached
Phidgets. The Phidgets connected to the PhidgetSBC should be seen here and can be opened by double clicking its
name in the menu.
Network attached Phidgets can also be located programmatically with the Phidget Manager. The Phidget Manager
isusedwitheitherhostnameandport,orserverID,justlikewith‘Open’.Themanagercanalsobeusedtondall
PhidgetsonanyWebservicethroughBonjour,byspecifyingaNULLServerID.Seeyourspeciclanguage’sguidefor
more information about coding with the Phidget Manager.

16
1072_0_Product_Manual - February 24, 2011 2:52 PM
Configuration (Web Interface)
ThePhidgetSBCisconguredthroughabuilt-incongurationinterface,throughaninternetbrowsermuchlike
your wireless access point or router. You can double click on the device under the PhidgetSBC tab in the Phidget
ControlPaneltobringupitscongurationinterface.Alternatively,ifyouhaveBonjourinstalled,youcanaccessthe
PhidgetSBC by name. For example, by default you can use ‘http://phidgetsbc.local.’. Once you know the IP address
of your PhidgetSBC, you can also just type it into your web browser of choice.
Thersttimeyouaccessthecongurationpage,thesystemwillpromptyoutosetapasswordbeforeyoucan
continue. This is to maintain security, and cannot be left blank. After setting a password, you can log onto the
congurationpagewithusername‘admin’andthepasswordyouchose.
Fromhereyouhavetheoptiontoviewthesysteminformationandstatus,congurenetworksettings,startthessh
server,setupcustomapplicationsandmanageles,orviewconnectedwebcams.Abreakdownofeachfunctionis
provided in this manual.
Atthispointyoumayalsowanttoupgradethesystemandthencongurethenetworksettingsifthedefault
settings are not appropriate.
The Conguration Pages
On loading the interface, you will see a tool bar along the top of the page. It holds some information across all the
congurationpages.Theinformationisasfollows:
Host Name - The host name given to the PhidgetSBC on the network.
Uptime - Total time elapsed since the last reboot.
Load - The average CPU utilization in the last minute, 5 minute, and 10 minute durations.
Version - The current board and web interface version.

17
1072_0_Product_Manual - February 24, 2011 2:52 PM
Status: System
ThisistherstpageyoushouldseeafterloadingthecongurationInterface.Itcontainsgeneralinformationabout
the SBC.
System Information
Board Name - Name of the device. It should always read “PhidgetSBC2”.
Board Revision - Board revision number. This tracks the hardware design.
Webif Version - The version of the web interface currently being used. This will change with updates to the web
interface/congurationsystem.
Kernel Version - The type and version of the loaded Linux kernel.
Distribution - The running Linux distribution name/version. This should read “Debian GNU/Linux 6.0”
Phidget Library-TheversionoftheinstalledPhidget21library.Theselibrariesareincludedwiththermware,and
may need to be updated to use newly released Phidgets.
Current Date/Time - Current date and time.
MAC Address-APhidgetSBCisuniquelyidentiedbyitsMACaddressshownhere.Thisaddressisalsoprintedon
the label of the underside of the PhidgetSBC. Other Phidgets, including the integrated InterfaceKit, use a serial
number to identify themselves.
Filesystem
Allmountedlesystemsarelisted,alongwiththeirsizeandusage.
Memory
Memory usage is shown. Wired/active memory is shown in red and cached/inactive memory is shown in blue.
Status: Network
See: Network: Status.
Status: Processes
This lists all running processes, along with their Process ID (PID), User, State, CPU usage and memory usage.
Advanced users can use this to tell if any application is using too much memory, or has crashed.
Status: USB
This lists all USB devices. The “S3C24XX OHCI” Host Controller, the “General Purpose USB Hub” and the built in
Interface Kit 8/8/8 should always be listed, along with any connected devices. Also listed are any mounted USB
drives.
All connected devices
A list of all the USB devices present in the system. This includes the main USB, the built in 6 port hub, and all
Phidget and non-Phidget devices.
Mounted USB / SCSI devices
This area lists of all the USB based drives connected to the PhidgetSBC, and their mount points. USB drives are
automatically mounted at /media/usb(0-9) when attached.
Unmount - Use this button before removing the device to safely disconnect it.

18
1072_0_Product_Manual - February 24, 2011 2:52 PM
Status: Phidgets
see: Phidgets: Status.
Network: Status
General network status can be viewed on this page. Modifying these values are done on other pages.
Adapter - Abbreviated name and number of the network interface.
Type - Wired or wireless connection.
Mode - Network protocol used.
IP Address - The IP address of the network interface.
Subnet Mask - The subnet mask of the network interface.
Gateway - The IP address of your gateway.
MAC Address - The MAC address of the interface.
Wireless State - Connection status information for the Wireless link. This could be ‘CONNECTED’, ‘INACTIVE’,
‘FAILED’, etc.
Wireless SSID - The plaintext name of the wireless connection access point.
Wireless Security - Security protocol used for a wireless link.
DNS Server(s) - List of nameservers being used.
Network: Settings
ThisiswhereTCP/IPsettingsforthewiredethernetandcongured.ThisisalsowhereSSHisenabled.
Network Settings
TCP/IP settings - DHCP will set the system IP Address, Subnet Mask, and Gateway automatically. In the absence of
aDHCPserver,Staticshouldbeusedandlledinmanually.NotethatthesameTCP/IPsettingswillbeusedatall
access points.
DNS settings - DNS can be set up automatically if DHCP is enabled. Under manual settings, up to two DNS servers
canbespecied.NotethatDNSsettingsaresystem-wideandwillapplytoallinterfaces.
SSH Server-ThisiswheretheSSHservercanbeenabledordisabled.EnablingSSHforthersttimecantake
several minutes as the keys are generated.
Network: Wireless
WirelessnetworkingissupportedviaaUSBwiadapter.Whenanadapterispluggedin,thiswirelessconguration
page will be available.
Wireless networks are joined based on a list of saved networks. You can join, manually enable and disable, as
well as delete these saved networks. To add a wireless network to this list, either choose from the list of detected
networks, or enter the details manually. Supported security includes WEP, WPA(2) Personal and WPA(2) Enterprise.
Savednetworkswillbejoinedrstbasedonsecurityandsecondlybasedonbestsignalstrength.
Add a Wireless Network
SSID - The SSID of the access point that you wish to add. This is the plaintext name of the access point.
Security - The security system used by this access point.
Remember this network - If enabled, this network will be added to the list of saved networks permanently, and will
be available to be automatically joined in the future. Otherwise, this network will remain in the list of saved networks
until the board is reset, or another network is added.

19
1072_0_Product_Manual - February 24, 2011 2:52 PM
Manage saved networks
Join This Network-Joiningaspecicnetworkwilltemporarilydisableallothersavednetworks,sothatthespecic
network will be joined, if available. The other networks will remain disabled until the board is reset, or another
network is added.
Delete This Network-Deleteasavednetwork.Thereisnoconrmationandthiscannotbeundone.
Enable / Disable - Selected networks that are enabled will be joined automatically. Disabled networks will never be
joined.
Wireless Network Settings
TCP/IP settings - DHCP will set the system IP Address, Subnet Mask, and Gateway automatically. In the absence of
aDHCPserver,Staticshouldbeusedandlledinmanually.NotethatthesameTCP/IPsettingswillbeusedatall
access points.
DNS settings - Switch the DNS settings between Automatic and Manual. DNS can be set up automatically if DHCP is
enabled.Otherwise,uptotwoDNSserverscanbespecied.NotethatDNSsettingsaresystem-wideandwillapply
to all interfaces.
Phidgets: Status
Library Version
TheversionoftheinstalledPhidget21library.Theselibrariesareincludedandareupdatedalongwiththermware.
List of attached Phidgets
A list of all detected Phidgets connected to the PhidgetSBC. This includes the integrated PhidgetInterfaceKit and
displays both the serial number and version.
Phidgets: Webservice
The Phidget webservice is a simple server that allows Phidgets connected to the PhidgetSBC board to be opened
over the network. This is enabled by default and starts with the SBC. The webservice also exposes a key-value
dictionary which can optionally be used for communication between applications written for the PhidgetSBC, and
applications running on your local computer. This page lets you view and modify the Phidget webserice settings, as
well as stop and start the server. Please see the Advanced User’s Guide for more information on programming with
the dictionary.
Phidget Webservice
Enabled/Disabled - Enables or disables the Phidget Webservice.
Server ID - Server ID is used when opening a connection to the PhidgetSBC using the mDNS based openRemote
calls. This is by default the same as the PhidgetSBC hostname (phidgetsbc), but can be set to anything (up to 63
characters).
Port - Port is the port that the webservice runs on - default is 5001.
Password - The password is used for securing the webservice. By default, this option is disabled with a blank
password. Note that while the authentication protocol and password is encrypted during authentication, all following
data is sent in the clear.
Start/Stop - Use this button to start/stop the webservice.

20
1072_0_Product_Manual - February 24, 2011 2:52 PM
Projects: Projects
This is where user projects are set up. Custom applications can be written in either C or Java, and then set up to
run on the PhidgetSBC at system startup. On the main page, there is a list of installed applications as well as the
controls for creating a new application space. Application names should not contain spaces.
Onaspecicapplicationspacepage,therearecontrolstostartandstoptheprogram,aswellasviewthestdout
and stderr from the most recent (or current) run.
Thereisalesystembrowser,whichallowsviewing,editingandremovalofapplicationles,aswellastheabilityto
uploadnewles.Fileuploadsizeislimitedto5MiBperle.
Theapplicationsettingssectioncongurestheapplication.Whenanapplicationisenabled,itwillstartattheend
of the system boot process (after things like bringing up the network, starting the Phidget Webservice, etc.). The
startupordereldspeciesastartorderamongthecustomapplications,withlowernumbersbeingstartedrst.
The Run as Daemon check box ensures that the application is run as a daemon. This should only be unchecked if
the application daemonizes itself, or quits right away - otherwise it will stall the boot process. Executable name is
thenameoftheletoexecute.Ifthislenameendsin‘.class’or‘.jar’,theprogramwillberunasaJavaprogram,
otherwise it is run as an ARM Binary.
See the chapter on Advanced use for more information about setting up custom applications in Java and C.
User Applications
Currently installed applications - This is a list of all created applications and their current status. Enabled applications
will try to run on system boot, and the stopped/running status indicates if the program is currently executing. Delete
applications using the red ‘X’ near their name. You can click on the application name to launch the application page.
Create new app-Thisbuttoncreatesanewapplicationspaceusingtheinputeldforitsname.
Free space remaining on userspace partition - The amount of free space remaining on the user partition in bytes.
Application page
Start/Stop-Thisbuttonisforstartingorstoppingtheexecutionoftheprogramspeciedunderapplicationsettings.
Starting a program will generate stdout and stderr logs.
View stdout - You can view the standard console output of your program through this link.
View stderr - In the event of an error that halts program execution, its corresponding error message is printed here.
Filesystem Browser
Uploadale-UseBrowsetoselectthelefromyourPC,ortypethelepathoftheitemtobeuploaded.The
UploadbuttonwillthencopytheselectedletothecurrentopenfolderintheFilesystemBrowser.
Create a directory-Typethedirectorynameyouwishtocreateintheeld.ClickCreatetomakethedirectoryinthe
current open folder.
Free space remaining on userspace partition - The amount of free space remaining on the user partition in bytes.
Application Settings
Enabled/Disabled - Enabled applications will start automatically when the PhidgetSBC is booted. Disabled
applications can be started manually by the user.
Startup order-Usetosetthestartuporderwhenmultipleapplicationsaredened.Lowernumbersgetstartedrst.
Run as daemon - Runs the application as a daemon. This should only be disabled if the application daemonizes itself
- otherwise the PhidgetSBC startup proccess will hang.
Executable/Class name-Nameoftheprogramletoexecute.Thislemustexist(havebeenuploaded)before
itgetsdenedhere.Filesendingin.classand.jarwillberunthroughtheJavaVM,otherwisetheyareexecuted
directly.
Arguments - Command line argument list to pass to the program on execution.