8. Getting Started

8.1。安装说明

1. SmartSnippets™Toolbox支持32位和64位环境。SmartSnippets™Studio安装程序包含SmartSnippets Toolbox应用程序。
2. To use a DA14580/581/583 or DA1468x chip family board, the appropriate FTDI drivers need to be installed on the system. Just use the standard WindowsNewhardwarehas被foundwizard to install them.
3. 要使用蓝牙加密狗，需要在系统上安装适当的JLink驱动程序。最新的司机可以找到http://www.segger.com/jlink-software.html. To download them, please click on theDownloadbutton under theJ-Linksoftware&documentationpack为了视窗section. While installing these drivers, it is recommended that the Bluetooth dongle is NOT connected to the USB port.
4. If an error occurs while using the SPotA tool and trying to connect to the Bluetooth dongle, please make sure that theMicrosoft视觉的C ++2010年重新发行Packagelibraries are installed atC:\\Windows\\System32folder. Otherwise, please download and install the latest Redistributable libraries for Visual Studio 2010 fromhttp://support.microsoft.com/kb/2019667/.
5. If the following error dialog appears, Java Simple Serial Connector library (JSSC), which is used by SmartSnippets™ Toolbox for serial communication, could not be loaded successfully. The reason is that none of the user home folder and user Temp folder is writable. JSSC library extracts to user home folder (or user Temp folder, if user home folder is not writable) the required DLLs for serial connection. The user can change the access rights of these folders or overwrite the default user folder location. In order to overwrite the default user home path, the user can use USER_HOME property. For example the user can set USER_HOME=C:/Users/_username_ or USER_HOME=C:\Users\_username_ at the properties file. Fileproperties.txt在安装时定义的SmartSnippets™工具箱工作区文件夹中。

Figure 7Example of error on loading a library

8.2。工作流程

This section is providing a guide to start using the SmartSnippets™ Toolbox, a proposed way of working with the tools available for the basic tasks during development. The following figure illustrates the basic flow to run a program from OTP on a DA1453x and DA14585/6 family chip.

Figure 8从OTP为DA1453X，DA14585 / 6开发和运行程序

[1] Dialog’s Development Board needs no configuration

[2] From this point on, application development and debugging is done, and OTP will be programmed

用户可能会尝试电源分布器，以尽可能多地优化代码。这可以采用几个迭代，因为用户可以插入SW Cursors（请参阅Power Profiler software cursors) to identify the code executions translated into current dissipation. As soon as it is completed, the programming of the code into the OTP might start so that the system is self-sustained. Upon OTP burning, the system can operate on a battery and realize complete power cycles e.g. active and sleep intervals. Please refer toPower Profiler关于能量分析器的详细描述。

8.3. Settings and Virtual COM port / JTAG selection

The ‘Settings and Virtual COM port / JTAG selection screen’ allows users to add, edit and delete settings files. The following images shows the list of available settings files on the left, the list of available virtual COM ports and JTAGs currently connected to FTDI devices in the middle and the list of available chip versions on the right. Each settings file is associated with a specific device / chip version. There is no provision to prohibit user from using the settings file with a different device than the one selected when the settings file was first created. However, if a different device is selected, some settings will still point to the original one. Therefore it is highly recommended to create a new settings file if user switches device.

The following options are available:

1. UART/SPI: SmartSnippets™ Toolbox scans and lists the Virtual COM port pairs currently connected to FTDI devices. The “Power Profile activated” indication, informs the user that Power Profiler is available.

Figure 9Virtual COM port selection

2. UART only: SmartSnippets™ Toolbox scans for individual COM ports without the need to be part of an FTDI pair. In this mode, all ports are treated as UART ports. This means that if the user selects to connect over one of these ports, the SPI functionality (e.g. Power Profiler) is disabled.

Figure 10UART only mode

3. JTAG.: The user has a JTAG attached to the board and wants to communicate over JTAG. The serial number that corresponds to the attached JTAG should be selected.

Figure 11JTAG模式

4. Hybrid: The user has a JTAG attached to the board and wants to communicate over JTAG. Although user can use SPI communication for certain tools e.g. Power Profiler.

Figure 12Hybrid mode

如果Smartsnippets™和电路板上的连接在UART链路上是不稳定的，请尝试更改FTDI电缆的延迟时间，并设置为10ms以下的某个值。用户可以从设备管理器配置延迟。要在Windows 10中打开设备管理器，用户可以按Windows按钮，在搜索框中按Windows按钮和类型 - œ别管理员。从设备管理器展开端口（COM＆LPT）。右键单击首选端口，单击“属性”，选择“选项卡端口设置”​​，然后选择“高级”。在Windows 8中，Com＆LPT是隐藏的。转到查看并选择显示隐藏设备。在Figure 13you can see a screeenshot of example settings.

Figure 13Advanced settings for COM port

On “Settings and Virtual COM port / JTAG selection” window the available options are:

Figure 14Settings and port selection actions

Open：用于打开当前在窗口的左侧选择的设置文件，并通过虚拟COM端口对或上面选择的单个UART端口或JTAG进行连接。选择设置文件和虚拟COM端口/ JTAG并按下“打开”后，设置文件与用户的选择关联，此信息存储在“Project.sms”文件中。下次用户选择相同的设置文件时，将预先选择最后一次使用的虚拟COM端口/ JTAG。允许用户打开设置文件而不选择虚拟COM端口/ JTAG;在这种情况下，所有需要与板通信的操作都被禁用。

New: When the application launches for the first time, there will be no settings file; the user will have to create one by pressing the ‘New’ button. The settings file name should be unique and should not contain any spaces or special characters. When saving the new settings file, a new folder with the name of the settings file is created under the Projects directory of the SmartSnippets™ Toolbox workspace. Under this folder, an xml file namedProject.SMS.is created to store the information and the user preferences regarding this settings file.

Edit：通过按“编辑”按钮，用户可以编辑设置文件描述。

删除：“删除”按钮从工作区中删除所选设置文件。

Refresh: The ‘Refresh’ button is used in order to refresh the list of available settings files and the list of available virtual COM ports/ jtag serial numbers. If the board is connected but not listed, the user is advised to use a different USB port, wait a few seconds and press again the ‘Refresh’ button. Problems in identifying the FTDI device may indicate an invalid installation of the FTDI drivers.

Detect：使用此选项SmartSnippets™工具箱与电路板通信以识别连接到PC的芯片。在成功检测下显示如下所示的消息：

Figure 15Device detection

Cannot see my board: Information popup message

Figure 16Instructions if device is not listed

Help: SmartSnippets™ Toolbox manual, release notes, license e.t.c

Support Pack: User can edit the selected SDK or select one if no SDK has been selected. When Toolbox is connected to an SDK, list of devices and resources of the selected SDK are used. Toolbox contains the resources and the configuration xml files for the device families it supports under its resources, in the form ofbundled support packs. If Toolbox is not connected to an SDK, devices and resources from all the bundled support packs will be used. In case the configuration xml of the selected SDK is not valid (e.g. resources missing), the respective bundled support pack matching the SDK family is used. When Toolbox is launched from SmartSnippets™ Studio, it is consideredconnected到同一SDK，工作室已启动。在独立模式下启动工具箱时，最初未连接到SDK，并且使用捆绑的支持包。旁边的消息Support Packbutton shows in which mode Toolbox is used: 1. with a specific SDK, 2. with the bundled support pack of a specific family or 3. with all the bundled support packs. When theSupport Packbutton is pressed, the following popup dialog shows up:

Figure 17支持包Configuration

In theSupport Packconfiguration dialog, user can select theBrowsebutton in order to select an SDK. If the validation of the configuration xml of the selected SDK fails, the respective validation messages will appear at the bottom of the window, before the好的，取消buttons. User can use the清空选项button in order to clear the SDK selected with theBrowse按钮，在这种情况下工具箱使用所有捆绑的支持包。以下图像显示所选SDK的验证失败的情况：

Figure 18SDK验证失败

8.4. Linux Support

8.4.1. Changing device permissions

When user adds a development board on a Linux system, new devices are created automatically on the OS. These devices should have read and write permission for all users. To avoid setting appropriate permissions every time SmartSnippets™ Toolbox is used, a rules file is provided which changes permissions to every “known” FTDI device. The file, named smartsnippets_studio_common_ftdi_devices.rules, contains a list of common vendor and product IDs and should be placed under /etc/udev/rules.d. If the user cannot find the VID-PID pair of the board used under this list, it is recommended that a new .rules file is created and copied to /etc/udev/rules.d folder.

8.4.2。为电源分析器设置Vid-PID对

Except from changing permissions of connected devices, as described in the previous section, the user should also add the VID-PID pairs to the SmartSnippets™ Toolbox properties file, in order to work with Power Profiler. Due to incompatibility with FTDI Linux kernel module, SmartSnippets™ Toolbox needs to know the Vendor and Product ID of the connected devices, in order to unload FTDI kernel module, before using ftd2xx library. Power Profiler works with a default VID-PID pair: VID= 0x0403 and PID=0x6010. User can add extra VID-PID pairs in properties.txt file in the following way:

Vid.1.0 = 0x0405

PID.1.0=0x6011

VID.Dialog_1468xAD=0x0406

PID.Dialog_1468xAD=0x6012

VID-PID pairs are created from properties starting with VID. (or vid.) and PID. (or pid.) and having common text after the first ‘.’.