Jabra 410 Software For Mac
Revision History
- Jabra 410 Software
- Jabra 410 Speakerphone
- Jabra Speak 410 Software
- Jabra 410 Driver
- Jabra Speak 410 Firmware
- Jabra Speak 410 Software
Jabra Suite for Mac is free Mac software that enables Jabra USB audio devices to have Remote Call Control over the latest generation of Mac softphones. Suite for Mac also. Jabra SPEAK 410 & 510 & 810, Jabra PRO 9400 series, Jabra PRO 930 & 935, Jabra GO 6400 series, Jabra LINK 260 & 265 & 280. Jabra speak 410 is a meeting speakerphone designed for consumers with a need for audio conferencing. Its compact design and travel case make it easy to carry around, and an integrated USB cable ensures quick set up without the risk of losing cables.
Get support for your Jabra Speak 510. Find all product guides, resources and FAQs. Office Headsets. Wired and wireless calls, music and concentration. Companion software, apps, and services. Jabra Glossary. Explanations of common Jabra terminology. Hearing protection. Jabra hearing protection standards. Jabra Support. Oct 30, 2012 Watch the 'Hands-on with Jabra Support' tutorial video. In this video we will show you how to setup and use your Jabra SPEAK 410 speakerphone, including controlling functionalities such.
Revision | Date | Description |
---|---|---|
5.0 | 2019-11-08 | Update API list. |
4.9 | 2019-10-07 | Updated supported device list. |
4.8 | 2019-09-27 | Added new APIs. Updated supported device list. |
4.7 | 2019-08-16 | Modified for Mac OS X |
4.6 | 2019-07-12 | Deprecated GetSerialNumber and GetWarrantyEndDate API's |
4.5 | 2019-05-24 | Updated library interfaces for firmware update API's |
4.4 | 2018-11-15 | Updated library interfaces |
4.3 | 2018-09-27 | Removed load and save settings interfaces |
4.2 | 2018-09-25 | Updated library interfaces - Removed lock references |
4.1 | 2018-04-12 | Updated library interfaces |
4.0 | 2017-12-12 | Updated library interfaces |
3.0 | 2017-11-10 | Updated features of dongle & child separation and Firmware Updater download from cloud. |
2.0 | 2017-08-24 | Updated features for Save & Load Setting, Logging and Firmware Updater. |
1.0 | 2017-05-09 | Initial Draft |
Introduction
Jabra SDK V2 is a dynamic library (dylib), provides interfaces to perform below functionalities in Jabra devices:
- Device Settings: Allows the user to view and change settings of the attached Jabra devices
- Remote Call control (RCC): Allows user to perform remote call control functionalities
- Get and set HID reports to and from the attached Jabra device
- Answer and End
- Mute and Unmute Call
- Ring indication
- Hold and Resume Call
- Manual Audio
- Get device serial number, battery status if supported by the device
- Button configuration (button takeover and remote MMI)
- Child device support with Link360, Link370
- Busy light indication
- Concurrency support for multiple applications of SDK
- Co-existence with Jabra Direct Online
- Device events logging
- Device firmware update
The SDK is built as a C++ dynamic library with C interfaces.
Abbreviations and Acronyms
Acronym | Description |
---|---|
API | Application Programming Interface |
DYLIB | Dynamic Linked Library |
HID | Human Interface Device |
SDK | Software Development Kit |
IDE | Integrated Development Environment |
USB | Universal Serial Bus |
HTTP | Hypertext Transfer Protocol |
JSON | JavaScript Object Notation |
WPF | Windows Presentation Foundation |
RCC | Remote Call Control |
MMI | Man Machine Interface |
FWU | Firmware Updater |
RMMI | Remote Man Machine Interface |
SDK Installation
SDK Mac release package would consist of the following directories:
- Demo - Demo application and it's source code
- Library - static and dynamic libraries required for development and header files
- Doc - user guide and release notes
- Wrapper - Objective-C Wrapper framework and documentation
- readme text file
The directories contain following assets:
Assets | Description |
---|---|
readme.txt | Provides information on Jabra SDK V2 |
Doc/SDK User Guide.html | User Guide and API documentation |
Doc/ReleaseNotes.txt | Release information and supported devices list |
Library/libjabra.dylib | Jabra SDK dynamic library for platform (x86 and x64) |
Library/libjabra.a | Static library for platform (x86 and x64) |
Library/Headers/JabraNativeHid.h | Header file defining the RCC APIs |
Library/Headers/JabraDeviceConfig.h | Header file defining the dynamic setting APIs |
Library/Headers/Common.h | Header file defining the common interfaces used across Jabra SDK V2 |
Library/Headers/returncodes.inc | Include file defining the Return codes |
Library/Headers/errorcodes.inc | Include file defining the Error codes |
Demo/Jabra SDK Demo | Demo application |
Demo/Source | Demo application source code |
Wrapper/JabraSDK.framework | Objective-C Wrapper framework for Mac |
Wrapper/Documentation/Docs/index.html | Jazzy generated Wrapper API documentation |
Supported Jabra Devices
The following Jabra devices are supported by the SDK:
- AudioCodes HRS 457
- DELL PRO STEREO HEADSET UC150
- DELL PRO STEREO HEADSET UC350
- Jabra BIZ 1100 Mono
- Jabra BIZ 1100 Stereo
- Jabra BIZ 1500 USB Duo
- Jabra BIZ 1500 USB Mono
- Jabra BIZ 2300 USB Duo
- Jabra BIZ 2300 USB Mono
- Jabra BIZ 2400 II CC USB Mono
- Jabra BIZ 2400 II CC USB Stereo
- Jabra BIZ 2400 II Duo
- Jabra BIZ 2400 II Mono
- Jabra BIZ 2400 II USB Duo BT
- Jabra BIZ 2400 II USB Mono BT
- Jabra BIZ 2400 II USB Mono CC
- Jabra BIZ 2400 USB
- Jabra BIZ 2400 USB Duo
- Jabra BIZ 2400 USB Mono
- Jabra DIAL 550
- Jabra Engage 50 Mono
- Jabra Engage 50 Stereo
- Jabra Engage 65 Convertible
- Jabra Engage 65 Mono
- Jabra Engage 65 Stereo
- Jabra Engage 75 Convertible
- Jabra Engage 75 Mono
- Jabra Engage 75 Stereo
- Jabra Evolve 20 Mono
- Jabra Evolve 20 Stereo
- Jabra Evolve 20SE Mono
- Jabra Evolve 20SE Stereo
- Jabra Evolve 30 II Mono
- Jabra Evolve 30 II Stereo
- Jabra Evolve 30 Mono
- Jabra Evolve 30 Stereo
- Jabra Evolve 40/80
- Jabra Evolve 65 Mono
- Jabra Evolve 65 Stereo
- Jabra Evolve 65e
- Jabra Evolve 65t
- Jabra Evolve 65t Cradle
- Jabra Evolve 75
- Jabra Evolve 75e
- Jabra Handset 450
- Jabra LINK 230
- Jabra LINK 260
- Jabra LINK 265
- Jabra LINK 280
- Jabra LINK 30
- Jabra LINK 32
- Jabra LINK 33
- Jabra LINK 360
- Jabra LINK 370
- Jabra LINK 43
- Jabra LINK 44
- Jabra LINK 850
- Jabra LINK 860
- Jabra LINK 950
- Jabra Motion Office
- Jabra MOTION UC
- Jabra Pro 920
- Jabra Pro 925 Dual Connectivity
- Jabra Pro 925 Single Connectivity
- Jabra Pro 930
- Jabra Pro 935
- Jabra Pro 935 Single Connectivity
- Jabra Pro 9450
- Jabra Pro 9460
- Jabra Pro 9465/9470
- Jabra SPEAK 410
- Jabra SPEAK 450 Cisco
- Jabra SPEAK 510
- Jabra SPEAK 710 MS
- Jabra SPEAK 710 Teams
- Jabra SPEAK 710 UC
- Jabra SPEAK 810
- Jabra STEALTH UC
- Jabra SUPREME
- Jabra SUPREME UC
- Jabra UC VOICE 150a Duo
- Jabra UC VOICE 150a Duo MS
- Jabra UC VOICE 150a Mono
- Jabra UC VOICE 150a Mono MS
- Jabra UC VOICE 250a
- Jabra UC VOICE 250a MS
- Jabra UC VOICE 550a Duo
- Jabra UC VOICE 550a Duo MS
- Jabra UC VOICE 550a Mono
- Jabra UC VOICE 550a Mono MS
- Jabra UC VOICE 750a Duo
- Jabra UC VOICE 750a Duo MS
- Jabra UC VOICE 750a Mono
- Jabra UC VOICE 750a Mono MS
- Lenovo Pro Wired Stereo VoIP Headset
- Mitel S720
- NXT Technologies HUB
- NXT Technologies UC-2000 Stereo Headset
- NXT Technologies UC-5100
- NXT Technologies UC-7500 Mono
- NXT Technologies UC-7500 Stereo
- USB2 Jabra Engage 75
Note: The headset may be wireless but the connection to the system must be via USB (e.g. using a Jabra LINK 360 Bluetooth USB Adapter). In present scope, the library does not support Jabra Bluetooth headsets that are directly connected to the Mac via Bluetooth.
Prerequisites
The prerequisites for the SDK are:
- Curl libraries
Developing application Using Jabra SDK V2
System requirements
- Mac OS X : 10.14.x (Applications can be deployed from 10.12.x to 10.14.x)
- Xcode : 10.3/11
- Network (Internet) connection
Library Interfaces
Common.h: Common interfaces for device
API Name | Description |
---|---|
Jabra_GetVersion | Gets the version of the SDK library |
Jabra_SetAppID | Application should set the application name using this interface. The Client ID/App ID must be obtained by registering to Jabra portal by App developers. This is a mandatory step, which needs to be done before initialization, failing which, callbacks will not be registered with SDK |
Jabra_InitializeV2 | Initializes the Jabra library. Argument details to the function are described here: Library Initialization. |
Jabra_Uninitialize | Performs library memory cleanup |
Jabra_SetHidEventsFromNonJabraDevices | Enable Hid events from non Jabra devices. |
Jabra_IsHidEventsFromNonJabraDevicesEnabled | Is Hid events from non Jabra devices enabled. |
Jabra_SetStdHidEventsFromJabraDevices | Enable Hid events from Jabra devices. |
Jabra_IsStdHidEventsFromJabraDevicesEnabled | Is Hid events from Jabra devices enabled. |
Jabra_IsFirstScanForDevicesDone | Checks if device scan during initialization is done. It is recommended to register for the corresponding callback during initialization |
Jabra_IsDeviceAttached | Checks if a device is attached. It is recommended to register for the corresponding callback during initialization |
Jabra_GetAttachedJabraDevices | Gets the list of attached Jabra devices |
Jabra_GetSku | Get device SKU (stock keeping unit). |
Jabra_GetFirmwareVersion | Returns the firmware version of the specified Jabra device |
Jabra_GetDeviceImagePath | Gets the attached device image path. The image is provided by Jabra Cloud service (and stored in the device’s local directory) and hence requires network access for the first time |
Jabra_GetDeviceImageThumbnailPath | Gets the device thumbnail image. The image is provided by Jabra cloud service (and stored in the device’s local directory) and hence requires network access for the first time |
Jabra_FreeDeviceInfo | Frees the device information structure members. This is called right after handling device attach event by the application |
Jabra_GetBatteryStatusV2 | Get battery status, if supported by device. |
Jabra_CopyJabraBatteryStatus | Copy the content of a Jabra_BatteryStatus struct. |
Jabra_FreeBatteryStatus | Frees the Jabra_BatteryStatus structure. This structure is return by Jabra_GetBatteryStatusV2 |
Jabra_RegisterBatteryStatusUpdateCallbackV2 | Register for battery status update callback. |
Jabra_ConnectToJabraApplication | Integrates softphone app to Jabra applications like Jabra Direct (JD) |
Jabra_DisconnectFromJabraApplication | Disconnects the Jabra SDK application from Jabra Direct |
Jabra_SetSoftphoneReady | Sets the softphone to ready |
Jabra_IsSoftphoneInFocus | Indicates whether the softphone is in focus |
Jabra_SetBTPairing | Sets the Bluetooth device into pairing mode |
Jabra_SearchNewDevices | Query for available Bluetooth devices which are switched on, within range and ready to connect |
Jabra_GetSearchDeviceList | Gets the list of new devices which are available to pair & connect. |
Jabra_StopBTPairing | Stops the search for available Bluetooth devices |
Jabra_SetAutoPairing | Enables/disables auto pairing. When Bluetooth adapter is plugged into the PC it will attempt to connect with the last connected Bluetooth device. If it cannot connect, it will automatically search for new Bluetooth devices to connect to if auto pairing is set |
Jabra_GetAutoPairing | Queries whether auto pairing mode is enabled or disabled |
Jabra_ClearPairingList | Clears the list of paired Bluetooth devices to the Bluetooth adapter |
Jabra_ConnectBTDevice | Connect/Reconnect Bluetooth device to the Jabra Bluetooth adapter. Ensure the Bluetooth device is switched on and within range |
Jabra_ConnectNewDevice | Connects to Bluetooth device with specified device details |
Jabra_DisconnectBTDevice | Disconnects Bluetooth device from Bluetooth adapter |
Jabra_GetConnectedBTDeviceName | Queries the name of connected Bluetooth device with Bluetooth Adapter |
Jabra_GetErrorString | Returns the error string from the error status |
Jabra_IsBusylightSupported | Checks if busylight is supported by the device |
Jabra_GetBusylightStatus | Checks the status of busylight |
Jabra_SetBusylightStatus | Enables/Disables the busylight status |
Jabra_RegisterBusylightEvent | Registration of callback to receive busylight events |
Jabra_RegisterPairingListCallback | Register callback to receive list of paired devices with BT adapter |
Jabra_IsPairingListSupported | Checks if pairing list is supported by the device |
Jabra_GetPairingList | Gets the list of devices which are paired previously to Bluetooth adapter |
Jabra_FreePairingList | Frees the memory allocated for the list of paired devices |
Jabra_ConnectPairedDevice | Connect a device which was already paired |
Jabra_DisConnectPairedDevice | Disconnect a paired device |
Jabra_ClearPairedDevice | Clears the specified device from paired device list |
Jabra_GetButtonFocus | Configures the remote MMI events for a device |
Jabra_ReleaseButtonFocus | Releases the remote MMI events configured in the device |
Jabra_GetSupportedButtonEvents | Gets the supported remote MMI for a device |
Jabra_FreeButtonEvents | Free the memory allocated for the button events |
Jabra_RegisterForGNPButtonEvent | Register callback function to get notified on GNP Button events |
Jabra_GetCustomerSupportUrl | Get the URL for contacting Jabra customer support. |
Jabra_GetNpsUrlForApplication | Get the NPS URL for the application only. |
Jabra_ConfigureLogging | API to configure the logging of events. |
Jabra_RegisterLoggingCallback | Register callback function for logging. |
Jabra_CheckForFirmwareUpdate | Checks if any latest firmware is available on the server. |
Jabra_GetLatestFirmwareInformation | Gives the latest available firmware on the server based on user request. |
Jabra_FreeFirmwareInfo | Frees the memory allocated for the firmware information. |
Jabra_DownloadFirmware | Downloads the selected firmware version. |
Jabra_GetFirmwareFilePath | Gets the file path where the firmware file for the respective version has been downloaded. |
Jabra_UpdateFirmware | Updates the firmware of the device to the firmware version specified. |
Jabra_CancelFirmwareDownload | Cancels the firmware download. |
Jabra_RegisterFirmwareProgressCallBack | Registers firmware progress callback to get notified about firmware download progress. |
Jabra_GetESN | Gets ESN (electronic serial number) of the device |
Jabra_GetCurrentLanguageCode | Gets the language code for the current language of the device |
Jabra_IsLeftEarbudStatusSupported | Checks if left earbud status supported by the device |
Jabra_GetLeftEarbudStatus | Gets left earbud connection status of the device |
Jabra_RegisterLeftEarbudStatus | Registers left earbud connection status event. Can only be called when a device is attached |
Jabra_RegisterHearThroughSettingChangeHandler | Registers HearThrough setting change event. Can only be called when a device is attached |
Jabra_IsEqualizerSupported | Checks if equalizer is supported by the device |
Jabra_IsEqualizerEnabled | Checks if equalizer is enabled in the device |
Jabra_EnableEqualizer | Enables/disables equalizer in the device |
Jabra_GetEqualizerParameters | Gets equalizer parameters for a device |
Jabra_SetEqualizerParameters | Set equalizer parameters for a device |
Jabra_GetNpsUrl | Get the NPS URL based on device, app name and app version |
Jabra_ProductRegistration | Registers a product with the provided information |
Jabra_ExecuteAVRCPCommand | Tells the device to execute a AVRCP command |
Jabra_Reconnect | Recreates the session, Input and Output streams for all devices which are connected to the phone and not to the app |
Jabra_IsFeatureSupported | Checks if a feature is supported by a device |
Jabra_GetSupportedFeatures | Gets array of features supported by a device |
Jabra_FreeSupportedFeatures | Frees a list of features obtained by calling Jabra_GetSupportedFeatures |
Jabra_GetMultiESN | Get ESN for all device components |
Jabra_FreeMap | Release memory allocated by functions returning a Map_Int_String* |
Jabra_GetSearchDeviceList | Gets the list of new devices which are available to pair & connect |
Jabra_RequestNoHangupToneNextTime | Request that the headset does not play its 'end of call' tone when the SCO closes next time. |
Jabra_IsCertifiedForSkypeForBusiness | Indicates whether the device is certified for Skype for Business |
Jabra_FreeCharArray | Free a char array |
Jabra_IsUploadRingtoneSupported | Checks if ringtone upload is supported by the device |
Jabra_UploadRingtone | Upload ringtone to device |
Jabra_RegisterUploadProgress | Registration for upload progress event |
Jabra_IsUploadImageSupported | Checks if image upload is supported by the device |
Jabra_UploadImage | Upload image to device |
Jabra_IsSetDateTimeSupported | Checks if date and time synchronization is supported by the device |
Jabra_SetDateTime | Set date and time to device |
Jabra_GetSupportedDeviceEvents | Supported events by device |
Jabra_SetSubscribedDeviceEvents | Set device events to subscribe to |
Jabra_GetAudioFileParametersForUpload | Get details of audio file for uploading to device |
Jabra_UploadWavRingtone | Upload ringtone to device in .wav format |
Jabra_SetWizardMode | Sets the wizard mode (whether a full setup wizard, a limited setup wizard or none will run on next power-on). Use Jabra_IsFeatureSupported to query feature support DeviceFeature.FullWizardMode or DeviceFeature.LimitedWizardMode. |
Jabra_GetReturnCodeString | Returns the descriptive string from the return code. |
Jabra_IsFirmwareLockEnabled | Checks if firmware lock is enabled in the device. |
Jabra_IsSettingProtectionEnabled | Checks if setting protection is enabled in the device. |
Jabra_EnableDevLog | Enables/disables logging for a device. |
Jabra_IsDevLogEnabled | Checks if logging is enabled in device. |
Jabra_RegisterDevLogCallback | Register callback function to get notified on device events. |
Jabra_DownloadFirmwareUpdater | Downloads the latest FW updater relevant for this device. |
Jabra_GetRemoteMmiTypes | Gets a list of supported remote MMIs. |
Jabra_FreeRemoteMmiTypes | Frees/deallocates the memory area allocated by Jabra_GetRemoteMmiTypes(). |
Jabra_IsRemoteMmiInFocus | Gets the status of the remote MMI focus. |
Jabra_GetRemoteMmiFocus | Gets the focus of the remote MMI specified. |
Jabra_ReleaseRemoteMmiFocus | Releases the focus of the remote MMI specified. |
Jabra_SetRemoteMmiAction | Sets an output action on the remote MMI. |
Jabra_RegisterRemoteMmiCallback | Registers for remote MMI event callback. |
Jabra_GetPanics | Get the panic list. |
Jabra_FreePanicListType | Frees the Jabra_PanicListType structure. |
Jabra_SetTimestamp | Sets a static timestamp in the device. |
Jabra_GetTimestamp | Gets the static timestamp in the device. |
Jabra_PreloadDeviceInfo | Preloads the configuration cache with the content of the specified archive. |
Jabra_PlayRingtone | Play Ringtone in Device. |
Jabra_GetAllFirmwareInformation | Gets information of all the firmwares present in cloud for the specific device. |
Jabra_FreeFirmwareInfoList | Frees the list of firmware information structure. |
Jabra_SetJackConnectorStatusListener | Subscribe/unsubscribe to JackStatus events. Not available on all devices. If not available, the client will get no events. |
Jabra_SetHeadDetectionStatusListener | Subscribe/unsubscribe to HeadDetectionStatus events. Not available on all devices. If not available, the client will get no events. |
JabraDeviceConfig.h: Device setting interfaces
API Name | Description |
---|---|
Jabra_GetSettings | Gets the attached Jabra device setting. Returns pointer to the device settings structure containing all settings for a particular device |
Jabra_FreeDeviceSettings | Once the device setting is requested by the application, memory needs to be freed by calling this API by the application |
Jabra_SetSettings | Updates/Sets the setting details of the attached Jabra device. Returns a return code to indicate if settings were applied successfully or not |
Jabra_FreeString | Once the device image path is requested, application needs to release the memory by calling this API to prevent memory leak |
Jabra_GetFailedSettingNames | Queries the list of failed setting names |
Jabra_FreeFailedSettings | Memory of failed setting names can be released by the application using this interface to prevent memory leak |
Jabra_SetSettingsChangeListener | Add a listener for changes to the device settings. The listener will be called when a setting is changed in the device, regardless of who changed it (this instance, another instance, or the user through MMI). |
Jabra_IsFactoryResetSupported | Returns whether the device supports factory reset |
Jabra_FactoryReset | Restores to factory settings of the device |
Jabra_FreeDeviceSettings | Memory allocated to device settings can be released by the application using this interface to prevent memory leak |
Jabra_GetSetting | Gets the unique setting identified by a GUID of a device |
Jabra_GetNamedAsset | Requests a named asset for the specified device |
Jabra_FreeAsset | Releases an asset previously obtained with Jabra_GetNamedAsset() |
JabraNativeHID.h: RCC interfaces
API Name | Description |
---|---|
Jabra_IsOffhookSupported | Returns true if off hook is supported for a specific Jabra device |
Jabra_SetOffhook | Set the specified device off hook/on hook |
Jabra_IsRingerSupported | Returns true if ringer is supported for a specific Jabra device |
Jabra_SetRinger | Set ringer on/off for the specified device |
Jabra_IsMuteSupported | Returns true if ringer is supported for a specific Jabra device |
Jabra_SetMute | Set mute on/off for the specified device |
Jabra_IsHoldSupported | Returns true if hold is supported for a specific Jabra device |
Jabra_SetHold | Set hold on/off for the specified device |
Jabra_IsOnlineSupported | Returns true if online mode is supported for a specific Jabra device |
Jabra_SetOnline | Turn online mode on/off for a wireless headset. Online mode opens an audio link (radio link) between a base/dongle and a headset |
Jabra_WriteHIDCommand | Interface for sending HID output reports with device ID, Usage Page and Usage. This function is for advanced users. It is recommended to use the dedicated functions: Jabra_SetOffHook, Jabra_SetRinger, Jabra_SetMute, Jabra_SetHold, and Jabra_SetOnline |
Jabra_IsGnHidStdHidSupported | Returns true if the device supports Gn HID and Std HID and able to switch between them |
Jabra_GetHidWorkingState | Gets the HID working state |
Jabra_SetHidWorkingState | Sets the HID working state to either standard HID (usb.org HID specification) or GN HID. HID Events will (default) NOT be triggered for standard HID to avoid conflicts |
Steps to initialize the library
The below steps are mandatory for initializing the Jabra SDK
- Valid App ID/Client ID must be set to SDK using Jabra_SetAppID API. If app id is not set, SDK initialization will fail. Kindly note, App ID/Client ID must be obtained by the application developers by registering with Jabra portal - https://developer.jabra.com/
- The library is initialized using the Jabra_Initialize API. The arguments consist of pointers to five callback functions and an instance number
Parameter | Description |
---|---|
FirstScanForDeviceDoneFunc | This callback function is called when the library has finished the initial scanning for Jabra devices |
DeviceAttachedFunc | This callback function is called when a new Jabra device is attached or the library has been initialized and found a Jabra device |
DeviceRemovedFunc | This callback function is called when a Jabra device is removed |
ButtonInDataRawHidFunc | This callback function is called when new input data has been received. Data is raw HID data |
ButtonInDataTranslatedFunc | This callback function is called when new input data has been received. Data is represented at a higher level of abstraction than the raw HID data |
Instance | Optional instance number. Can be 0 if not used |
Important: As callbacks are executed in SDK context, application must perform only small/light-weight activity. For bulky functionality, it should continue using application thread
Library initialization must be done only once. Before process shutdown Jabra_Uninitialize() must be called in order to perform memory cleanup.
Note: For RCC to be reflected in device, HID button inputs from a device to the PC must be acknowledged by the OS. Otherwise the next button input transition will not be detected by the system. A button input is acknowledged by setting the corresponding button output to the same value as the input value. For example, when you receive an OffHook = true, you must call Jabra_SetOffHook (deviceId, true). After acknowledging the input you can set the new desired state. For example, to reject the off-hook request you could call Jabra_SetOffHook (deviceId, false).
Mac OS X (C++/Objective-C/Swift) Application
User has an option to develop an application using C++ by directly consuming C interfaces. But if the application is developed in Objective-C/Swift, a wrapper has to be created to use the APIs from these libraries.
Refer Library Interfaces
More information on Objeive-C Wrapper can be found in Wrapper/Documentation folder.
Logging
SDK provides logging to troubleshoot issues. By default, log level is set to Warning.
Log level can be defined by setting the environment variable (LIBJABRA_TRACE_LEVEL) using export or launchctl setenv command from Terminal. Supported log levels are - fatal, error, warning and info.
The logs will be placed at ~/Application Support/JabraSDK by default.
Application log file size is restricted to 10 MB, log exceeding this size new files are created. 10 latest log files can be stored, after that on new log file creation the oldest log is deleted.
Note: Application restart is required, in case the log environment variable is changed.
Points to Remember
- Concurrency is maintained between all the applications which uses Jabra SDK library and Jabra Direct Online
- Dependent settings are some special settings which depend on other settings. For example, based on the value of one setting, other setting(s) may get enabled or disabled
- Application needs to handle dependency settings, based on the flag isDepedentsetting in exposed settingInfo structure
- ListKeyValue (structure) in each setting (mainly for drop down control settings) will contain list of possible values. Along with this, ListKeyValue will also have dependent settings details
- For each values in the ListKeyValue structure,
- dependentcount will have the information of how many settings are dependent for this value. It will be zero, if no settings are dependent.
- If dependentcount is non-zero, then DependencySetting (structure) will have the details of the settings, which are dependent
- DependencySetting will have setting GUID and a flag to say whether to enable or disable
- For some settings when disabled because of dependency, the value needs to be changed to default value. dependentDefaultValue in settingInfo structure will have default value
- PC settings are settings, which application needs to handle as it is not device settings. And the exposed settingInfo structure has the flag, isPCsetting, to identify whether it is PC setting or not
- Any string input given should be terminated with a NULL pointer
- Validations like regular expression, min length, max length etc. for string input needs to be handled by application
- The button configurations done for remote MMI should be cleared/reset on device unplug or exit of the application. The application should perform button configuration again on next start up
- Since device does not provide any information on currently configured remote MMI's, the client logic to maintain the remote MMI configurations for a device. Different instances of demo app will not know the remote MMI configured as device does not support reading of current remote MMI configurations
- Remote MMI is restricted when supported device is paired with Dongle
- If any of the settings fails while retrieving from the device, device settings structure will be null pointer
- 3rd party developers have to register for the authorization token for firmware updater
- The Firmware updater application (Jabra Firmware Updater.app) is required to be installed to support firmware update feature. The installer will be downloaded from cloud as part of firmware file download for Jabra device from Jabra_DownloadFirmware API. The udpater application will be installed when firmware update is initiated.
- Jabra_DownloadFirmware API to be called before calling Jabra_UpdateFirmware API to get the firmware file path
Bluetooth/Dongle devices
- The USB dongle and the paired Bluetooth headset are enumerated as seperate device in the available device list
- When Dongle is paired with the Speak 710, if the user change shared use setting to off in Speak 710, then the device will disconnect the Bluetooth connection with the Dongle.
Sample application Code
Both source code and binary files for the demo application are packed along with this SDK. The demo application is a Swift application using Obj-C SDK Wrapper framework. The test program demonstrates library initialization, usage of remote call controls and device settings features using Jabra SDK V2.
Device Connected
Device Disconnected
Device Information View
Device Settings View
Call Control View
Enable HID Events - Jabra Standard HID Events, Non-Jabra HID Events
Disable HID Events - Jabra Standard HID Events, Non-Jabra HID Events
Device information while Bluetooth dongle is connected
Device connected to PC over Bluetooth via dongle
BT Pairing when no headset is connected
BT Pairing while dongle scanning for headset to connect
BT Pairing while headset is connected to PC via dongle
Mapping of Button Events with user actions.
Mapping of Remote MMI V2 Events.
Firmware Updater view
Firmware Updater View -- Download specific firmware.
Firmware Updater View -- Download Completed
Jabra 410 Software
Firmware Updater --Update on clicking update
Firmware Updater --Updater initiated for upate
Firmware Updater --Firmware updater progress
Firmware Updater --Firmware updater progress
Firmware Updater --Firmware updater progress
Firmware Updater -- Update finished.
Upload ringtone
Upload ringtone file selection
Upload ringtone -- file upload progress view
Upload image
Upload image - file selection
Set date and time view
Logging view
Jabra 410 Speakerphone
Development Setup
- Create a new Sample application using Xcode 10.3 -- Cocoa Swift Application
Create new project view in Xcode 10.3
- Configure the application with the name and other details
Xcode application configuration
- Copy the SDK Framework (JabraSDK.framework) from the JabraSDK zip file and place it in application project folder as shown below.
Copy Framework in the Project
- Link the SDK Framework (JabraSDK.framework) to the project.
Locate framework to link into project
Select the framework to be linked
SDK Framework linked to project
Sequence Diagrams
This section shows sequence diagrams for the most common use cases. Using the same patterns like the one described here, enables more advanced use cases.
Get device setting Sequence
The following sequence diagrams illustrate how to get settings from device using this library.
Get device settings
Set device setting Sequence
The following sequence diagrams illustrate how to set settings from application to device using this library.
Set device settings
Off-Hook Sequence
The following sequence diagrams illustrate how to implement off-hook/on-hook scenarios in your softphone using this library.
Softphone Initiated
Softphone OffHook initiation
User Initiated
User OffHook initiation
Mute Sequence
The following sequence diagrams illustrate how to implement mute/unmute scenarios in your softphone using this library.
Softphone Initiated
Softphone mute toggle
User Initiated
User mute toggle
Hold Sequence
The following sequence diagrams illustrate how to implement hold/resume call scenarios in your softphone using this library.
Softphone Initiated
Softphone Hold/resume sequence
User Initiated
User Hold/resume sequence
Remote MMI -- Button take over
Button takeover sequence
Child device support
Child device handling sequence
Logging
Logging sequence
Firmware Update
Firmware update sequence
Third party license Notice
License notice for libjsoncpp
Copyright (c) 2007-2010 Baptiste Lepilleur
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Updated license information can be found here.
License notice for pugixml
Copyright (c) 2006-2018 Arseny Kapoulkine
Apple may provide or recommend responses as a possible solution based on the information provided; every potential issue may involve several factors not detailed in the conversations captured in an electronic forum and Apple can therefore provide no guarantee as to the efficacy of any proposed solutions on the community forums. Mac iso to thumb app.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Updated license information can be found here.
License notice for libcurl
Copyright (c) 2006-2018 Arseny Kapoulkine
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Updated license information can be found here.
Greetings chordhead,Thanks for using the Apple Support Communities! I understand you're curious if you're able to use your Jabra Elite 65t wireless earbuds with your Mac.
The following guide from Jabra provides helpful compatibility information: True Wireless Earbuds for Calls & Music Jabra Elite 65t
Jabra Speak 410 Software
Specifically, let's have you review the FAQ section which mentions the compatibility:Is it compatible with my phone?
Jabra 410 Driver
Jabra Elite 65t is optimized to be used with smartphones/mobile phones. It’s not specifically optimized to be used directly with a computer. You can check out the compatibility guide here.
Based on the information from Jabra, it doesn't appear your wireless earbuds will work with your Mac.