SC14DECTIPBS Quick Start Guide SC14DECTIPBSDialog Semiconductor B.V. SC14DECTIPBS Quick Start Guide April 10, 2012 v1.1 Dialog Semiconductor B.V. Confidential page 1 of 43 SC14DECTIPBS Quick Start Guide SC14DECTIPBS Purpose of this document: This guide explains the most important steps of installing and setting up the SC14DECTIPBS. It will also cover the interoperability with the SC14WSMDATA. For detailed information refer to the SC14DECTIPBS SW Manual. Terms and abbreviations: API AT Base Station CVM DECT FP FTDI Handset IDE IPBS IPEI MMI NVS PCB PP RFPI UART ULE WSM Application Programming Interface “Attention” (Command given to CVM module) See FP Cordless Voice Module Digital Enhanced Cordless Telephone Fixed Part Future Technology Devices International See PP Integrated development environment Internet Protocol Base Station International Portable Equipment Identity (please refer to ETSI EN 300 175-6) Man Machine Interface Non Volatile Storage Printed Circuit Board Portable Part Radio Fixed Part Identity (please refer to ETSI EN 300 175-6) Universal Asynchronous Receiver / Transmitter Ultra Low Energy Wireless Sensor Module Icons used: The most common icons which are used throughout this document are: = Note which gives additional information = Important step, please read carefully! = Repeat steps that were previously executed = (Successfully) reached the last step of the section = Refers to a pdf document April 10, 2012 v1.1 Dialog Semiconductor B.V. Confidential page 2 of 43 SC14DECTIPBS Quick Start Guide SC14DECTIPBS Introduction: The SC14DECTIPBS is an internet enabled DECT base station which connects TCP/IP based applications (i.e. cloud applications) to a DECT ULE network of Wireless Sensor Modules (WSMDATA). Typically an application will consist of several nodes connected to a single SC14DECTIPBS base station. The SC14WSMDATA module can be used to create sensor and actuator nodes. See Figure 1. In the remainder of this document, the SC14WSMDATA nodes will be referred to as the portable part (PP) and the SC14DECTIPBS as fixed part (FP). Figure 1: Product overview The SC14DECTIPBS is a reference design. It uses Dialog SC452 VOIP SoC as a host processor to a SC14CVMDECT. Preparation To start the installation and configuration of the target, check if all software and hardware is present: The Kit Content, consisting of The target Connection cables: 1x UTP, 1x USB-to-serial cable and 1x power cable The DVD, containing the VM, software and documentation Additional hardware and software: A functioning computer running Windows XP or better, with 10GB free hard disk space 2GB RAM and a free USB port. An active Internet connection. A router configured with a DHCP server See the documentation of the router for more details on configurating a DHCP server. A wired network April 10, 2012 v1.1 Dialog Semiconductor B.V. Confidential page 3 of 43 SC14DECTIPBS Quick Start Guide SC14DECTIPBS IPBASE HW components LED1 LED1 LED2 LED2 LED3 LED3 LED4 LED4 Generic button LED5 LED5 Memory (SDRAM) Power connector ! Max 5V SC14452 Reset button Memory (Flash) DECT ULE Serial connector PHY UTP Connector Note Note:: Programmable Programmable and and configurable configurable items items are are shown shown in in bold. bold. Figure 2: Layout of the target The most important parts on the target are: Power Connector Provides power to the target. Warning: The target maximum power is 5V. Using a higher voltage can destroy the target. Reset button Reboot the target manually. UTP connector Connects the target to a wired network. Serial Connector Connect the target directly to a computer for configuring or updating. The color codes of the serial connector are shown in Figure 2 and on the target. LED1 to LED 5 Provide information about the current status of the target. LED 1 to LED 4 are green LEDs. LED 5 is red. In the demo application they are assigned as following: Orange Orange Yellow Yellow Black Black LED ASSIGNMENT LED1: It blinks when the Dect radio receives or sends data packets. LED2: It is ON if board has successfully connected to network (has obtained IP address). LED3: It is ON if board has successfully connected to portal server. It blinks during connection (~ 60 sec). LED4: It is ON when ULE application has successfully initialized and is running. LED5: It is ON when unit is in registration mode. It blinks when user is asked to press the Generic Button to register the board to portalserver. Other parts SC14452 The IP processor. DECT ULE The DECT communication module enables communication with DECT devices. Memory (SDRAM) The volatile working memory (RAM). The content of the RAM is erased after the power is disconnected or the Reset button is activated. Memory (Flash) The non-volatile ROM where the image is stored. PHY (PHYsical layer) Enables communication between target and network April 10, 2012 v1.1 Dialog Semiconductor B.V. Confidential page 4 of 43 Software Setup Importing the Virtual Machine provided by Dialog. Developing Software 3. website Setting up the development environment Error! Reference source not Installing VirtualBox.1 Dialog Semiconductor B. April 10. Section Description Using the SC14DECTIPBS without the development environment Setting up the Setup the hardware and connecting it to the SmartPulse portal SC14DECTIPBS Accessing the Accessing the SC14DECTIPBS internal website after setting it SC14DECTIPBS internal up. 7. 8. 10. 1. ound.V. Developing Software Software development on Using the Software Development environment. 9. 2012 v1.SC14DECTIPBS Quick Start Guide SC14DECTIPBS Using this document: This document successively contains the following sections: Nr. 5. 11. application on the PC Cross compiling the Running the ULE application on the SC14DECTIPBS target. Confidential page 5 of 43 . 6. application and run from RAM Upgrading the Permanently storing the ULE application on the SC14DECTIPBS FLASH SC14DECTIPBS target image Where to change the code Pointers on where to change the code. 2. SC14DECTIPBS Compile/debug/run the Running the ULE application in the Native / PC environment. 4. Connecting Serial Port Restoring the SC14DECTIPBS Connecting the serial terminal to control the board via UART Reprogramming the FLASH via the serial terminal (in case the board seizes to respond). What to do! Additional info 1.1 Dialog Semiconductor B. 2 .V. 2012 v1. Unpack the board and write down the number on the back of the board. Setting up the SC14DECTIPBS This section describes how to set up the board and connect it to the SmartPulse Portal (accessible worldwide). Confidential page 6 of 43 . Do not exceed 5V on the power supply. 1 Then connect the Power plug (bottom red square). The board will be damaged.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 1. 2. First connect the Ethernet connector (top red square) to a free port of a switch or a router. April 10. D1 (bottom right) blinks whenever there is DECT radio activity. April 10. most likely the internet connection is not present (Ethernet cable should have internet access and a DHCP server should be present in the network).1 Dialog Semiconductor B. Note: if any of the previous steps fail.nl 4. 2012 v1.20 sec: D4 (next to push button) should light up continuously indicating the (uC)Linux application has started correctly. +-27 sec: D3 will start blinking slowly to indicate the board is trying to connect to the SmartPulse portal.V.uncinc. Go to the SmartPulse portal: http://smartpulse. +-25 sec: D2 should light up continuously to indicate the board has an IP address. Create a new account 5. Confidential page 7 of 43 . Green LEDs Yellow LEDs 3.SC14DECTIPBS Quick Start Guide SC14DECTIPBS Check if the board functions correctly: Green LEDs: D11 should light up continuously (power) D7 should blink to indicate Ethernet activity Yellow LEDs: The following sequence should be seen: +. 6. Important: if LED D3 is not on continuously but blinking this means the board has not setup a connection to the server. Once setup. After creating an account click “Register your board” Type in the code which is on the bottom of the board (see step 2. the link will remain until the board is reset or power cycled. Yellow LEDs 7.1).SC14DECTIPBS Quick Start Guide SC14DECTIPBS Before trying to register the board. Click “Register” 8. wait for LED D3 (yellow LED) to be on continuously. Registration will then fail.1 Dialog Semiconductor B.V. Confidential page 8 of 43 . 2012 v1. April 10. By turning on the device it will start communicating with the SC14DECTIPBS. follow the procedure below. page 9 of 43 .SC14DECTIPBS Quick Start Guide SC14DECTIPBS The RED LED should blink and the website indicates the LED on the board blinks. Confidential Power button Reg(istration) button 12. P U S H 10. The RED LED on the SC14WSMDATA device will turn off if registration is successful. April 10. 9. 2012 v1. Default access code is 0000 (preprogramed value). enable registration on the base station by clicking the corresponding button in webpage. Follow this sequence to enable registration on the SC14WSMDATA_DB: Power off the SC14WSMDATA_DB hold down the “Reg” button Power on the SC14WSMDATA_DB After > 2sec release the “Reg” button The RED LED will be on continuously to indicate registration mode.V. The RED LED on the SC14DECTIPBS will be on if the base is in registration. Press the Registration button on the board to complete the registration process. If the device is not registered.1 Dialog Semiconductor B. If needed. 11. After pressing the button the board has been successfully registered to your account. Refer to the SC14WSMDATA documentation for more information. The SC14WSMDATA modules in the SC14DECTIPBSREFKT are normally preregistered. The board is successfully connected to the SmartPulse portal.1 Dialog Semiconductor B.V. Once a device has communicated with the SC14DECTIPBS it will show up as a sensor on the main web page. Click the sensor to access the corresponding device menu. Confidential page 10 of 43 . The left yellow box can also be used to experiment with JSON command and send various commands to the device or base station. 2012 v1. . The sequence is as follows: Push a button to invoke a JSON command (purple square). 15. The JSON command input from the server to the board or the end device will show up in the left yellow box. The device web page allows the user to try various JSON commands.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 13. 14. April 10. The JSON response from the board will show up in the right red box. 2. 2 . Additional info Check if the board functions correctly. Green LEDs Yellow LEDs April 10. On a local network.1 Dialog Semiconductor B. The board will be damaged. Do not exceed 5V on the power supply. Confidential page 11 of 43 . the SC14DECTIPBS internal webserver can also be used to host a website. 1. In order to access the boards internal website only LED D4 and D2 need to light up continuously. 2012 v1. Accessing the SC14DECTIPBS internal website If used on local networks. What to do! First connect the Ethernet connector (top red square). Using the SmartPulse server the board only hosts the JSON Web Interface.V.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 2. it hosts the JSON Web Interface and a demo website. 1 Then connect the Power plug (bottom red square). V. Open a browser and type in the corresponding IP address. The Setup Wizard broadcasts information to find the board.1 Dialog Semiconductor B. 3. If the webpage is very slow. add the IP address to the hostfile. Note: Windows 7 has a difficult time accessing IP addresses that are not in the hostfile. The internal webpage is now opened. See http://helpdeskgeek.SC14DECTIPBS Quick Start Guide SC14DECTIPBS From the DVD folder “PcTools”. Note: Please connect the PC running the DECT ULE Setup Wizard to the same wired network as the SC14DECTIPBS is on.com/windows7/windows-7-hosts-file/ April 10. 4. 2012 v1.exe file Match the hostname to the number under the board to find the board IP address. Confidential page 12 of 43 . double click the DECT-ULE-SetupWizard. which may be blocked from wireless to wires networks. enable registration on the base station. By turning on the device it will start communicating with the SC14DECTIPBS. The RED LED on the SC14DECTIPBS will be on if the base is in registration.SC14DECTIPBS Quick Start Guide SC14DECTIPBS The SC14WSMDATA modules in the SC14DECTIPBSREFKT are normally preregistered. follow the procedure below. If needed. and by clicking on them you can see the details of each sensor. Refer to the SC14WSMDATA documentation for more information. Confidential page 13 of 43 . Default access code is 0000. 7.1 Dialog Semiconductor B. 2012 v1. The RED LED on the SC14WSMDATA device will turn off if registration is successful. 5. Follow this sequence to enable registration on the SC14WSMDATA_DB: Power off the SC14WSMDATA_DB hold down the “Reg” button Power on the SC14WSMDATA_DB After > 2sec release the “Reg” button The RED LED will be on continuously to indicate registration mode. If the device is not registered. Once devices are registered and communicating they are displayed in the home page. April 10. by selecting DECTIP base control and then enable registration. Power button Reg(istration) button 6.V. driving a ULE port or just logging and sending an email. Confidential page 14 of 43 . 2012 v1.V. The system log file can be accessed by selecting “System Debug – JSON Interface” from the home page.pdf included in the release.1 Dialog Semiconductor B. Multiple commands to the sensors can be sent through the WEB API (JSON interface). setting a LED. 8. April 10.SC14DECTIPBS Quick Start Guide SC14DECTIPBS You can tie an event with an activity by selecting “Add activity”. An event can be any packet of certain type coming from a sensor. For more details refer to Web API. 9. An activity can be any action that should be taken in response to an event like toggling an actuator. It can be a wake-up packet. a HAL packet. an alarm packet. 2012 v1.V.1 Dialog Semiconductor B. Confidential page 15 of 43 . . April 10.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 10. The boards local IP address has been found successfully and the internal web page has been accessed. What to do! VirtualBox Manager Additional info / Result 1.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 3.1 Dialog Semiconductor B.virtualbox.V. It is a freely available open source product from Oracle needed to open the Virtual Machine file provided with this release. 5. Confidential page 16 of 43 . Save and run the executable. Press Next April 10.org/ 2. 2012 v1. Note: In this example we used “VirtualBox 4.1. Go to the Downloads section and choose the latest VirtualBox for Windows hosts. 3.6 for Windows hosts”. Open your Web browser and go to page: https://www. Press Run. 4. Software Installation Goal: Install Oracle VM VirtualBox Manager. V. Click the Finish button to exit the Setup Wizard. 8. Select the way the features should be installed and press Next. Wait until the progress bar is completed. Click Next to continue. April 10. Click Install to begin the installation. A progress bar is shown.1 Dialog Semiconductor B. You can check the checkbox to start the virtual machine right after installation. 9. You can click Browse to change your installation directory. The VirtualBox installation is completed. It is not advised to deselect any of the selected components. 2012 v1. 7. 10.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 6. Click Yes to proceed. Confidential page 17 of 43 . Click the components which you would like to install. 3. Software Setup Goal: Setup the Oracle VM VirtualBox Manager What to do! VM VirtualBox Manager Setup Browse to the VirtualBox_image directory on your DVD and copy the file ULE_RefKit.1 Dialog Semiconductor B. In VirtualBox Manager click New. It is important to first copy the file on to your hard drive as it needs to be writable. Next. Select 1024MB as the allocated amount of base memory. 5. Confidential page 18 of 43 . Additional info / Result 2. copy it and extract he vdi file. 1. If it exists in zip format format.V. 4. Click Next.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 4. April 10. If Oracle VM VirtualBox Manager has not been started yet start the VirtualBox Manager (with Windows Start Menu). Click Next. Fill in a name and choose Linux as your operating system and Ubuntu as the version.vdi to a local drive. 2012 v1. Click the Settings button in the main screen. Confidential page 19 of 43 .SC14DECTIPBS Quick Start Guide SC14DECTIPBS 6. Browse to directory on your local drive containing the file ULE_RefKit_xxx. click Open and click Next. Accordingly click the browse icon: 7. Click Network. Click the Start arrow in the main screen and press OK. As the DECT-ULE-Setupwizard must be able to reach the board through a broadcast it needs to be on the same physical medium. Click OK. 9. Select Bridged Adapter for the field “Attached to” and select a network connection for field “Name:”. 10.vdi file.1 Dialog Semiconductor B.V. Click Create to confirm the creation of the New Virtual Machine. Important: Connect the computer to a wired network. Select the dvi file. Make sure that Start-up Disk is checked and that Use existing hard disk is selected. 8. 11. April 10. 2012 v1. 15. In the menu of Oracle VM VirtualBox select Devices -> CD/DVD Devices -> Choose a virtual CD/DVD disk file… 14. OK to close all the information screens.V. You are prompted to choose the application to launch. Note: In case you are not prompted. Press OK.1.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 12.1.1 Dialog Semiconductor B.6_7413 and select Open With Autorun Prompt and press Run. Select Open Autorun Prompt and press OK. Confidential page 20 of 43 . Press OK. 2012 v1. Important: If you are requested to enter a username and password use: User: uleuser Password: uleuser 13.iso and click Open. Browse to folder “VirtualBox_image” on your DVD and select the VBoxGuestAdditions_4. right-click the VBOXADDITIONS_4. A new window is opened showing the virtual machine.6. April 10. Confidential page 21 of 43 . April 10. 2012 v1.1 Dialog Semiconductor B. Wait until the VirtualBox Guest Additions installation is completed and press Enter to close the window.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 16. 18. Enter password: “uleuser” and press Authenticate. 17.V. The Virtual Machine is successfully set up. The steps are: 1. Compiling and debugging the code on the PC. Upon reset the board loses the RAM content so the program will be lost. 1. Software development on SC14DECTIPBS The Virtual Machine contains the SC14DECTIPBS source code and all the tools required to program the platform.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 5. What to do! First connect the Ethernet connector (top red square).V. stepping. In order to access the boards on your local network only LED D4 and D2 need to light up continuously. Create the linux image and update the FLASH. Compiling the code for the SC14DECTIPBS target and run it from the target RAM. 2012 v1. 2. For more details. 1 Then connect the Power plug (bottom red square).1 Dialog Semiconductor B. …). The program communicates with the SC14DECTIPBS radio module directly over Ethernet. This step is taken when step 2 has shown that the program works and stores the program to FLASH meaning the program will not be lost upon reset. Additional info Check if the board functions correctly. Do not exceed 5V on the power supply. Green LEDs Yellow LEDs April 10. As step 3 takes considerably longer than step 2 usually a program is first developed in RAM and afterwards stored to FLASH. The target provides print statement debugging capabilities. The board will be damaged. watching variables. This step is used to verify the program is working as expected on the target. The Eclipse environment provides extensive debug options to debug a program (breakpoints. Confidential page 22 of 43 . There are three basic steps in developing the SW on the SC14DECTIPBS. 3. 2. 2 . please refer to the SC14DECTIPBS SW Manual. This step creates a FLASH image for the SC14DECTIPBS (much like the hard drive contents of a PC) and stores it in the board. 2012 v1.1 Dialog Semiconductor B. start the Virtual Machine and log in.exe file Match the hostname to the number under the board to find the board IP address.V. Since the Virtual Machine environment is now also installed. double click the DECT-ULE-SetupWizard. the DECT-ULE-SetupWizard can also be accessed from Linux. Important: username and password are: User: uleuser Password: uleuser April 10. 3. If not already started.SC14DECTIPBS Quick Start Guide SC14DECTIPBS From the DVD folder “PcTools”. 4. Confidential page 23 of 43 . .V. 6.SC14DECTIPBS Quick Start Guide SC14DECTIPBS Optional step In order to run the DECT-ULE-SetupWizard from Linux first double clik “Root Terminal”. 2012 v1. Confidential page 24 of 43 .1 Dialog Semiconductor B. Optional step Execute “/home/uleuser/DECT-ULE-SetupWizard” to start the wizard. April 10. 5. Start the Eclipse SDK by double clicking the “Eclipse” icon. Write down the board IP address (see step 3). 7. Use the “uleuser” as password for the administrative tasks. Use the “uleuser” as password for the administrative tasks. 2012 v1. 8. Once opened. Confidential page 25 of 43 .1 Dialog Semiconductor B. select the ULE_ReferenceDesign project. Compile Debug Run From the drop down button next to the Run External Tools button select “Update SDK with Board IP address” 9.SC14DECTIPBS Quick Start Guide SC14DECTIPBS The Eclipse environment will open after the splash screen shows. This will enable the compile. April 10.V. debug and run buttons. 1 Dialog Semiconductor B. Once configured.V. The last board IP is stored in a configuration file so closing and (re)opening the SDK will not change the board IP configuration.SC14DECTIPBS Quick Start Guide SC14DECTIPBS The console will prompt to type in the IPBase board IP address. the programming tools in the Eclipse SDK will not work. the IP does not need to be re-configured if the board IP does not change. 19. Press enter to complete the configuration of the SDK. Click once in the (white) console area to select the console and type the SC14DECTIPBS IP address. April 10. If not done. (as found by the DECT-ULE-SetupWizard) 10. 2012 v1. Important: It is important to configure the correct IP. Confidential page 26 of 43 . The Virtual Machine and SC14DECTIPBS are successfully set up for SW development. If the console shows “finished building target …” the build was successful. except a small portion of code which stills runs on the board. Check if the build is successful.V. This option has the following advantages: The Eclipse environment provides extensive debug options (breakpoints.1 Dialog Semiconductor B.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 6. Note that the same application will be cross compiled and downloaded to the target later on. watching variables) to debug the program running on the PC (GDB graphical debug environment). There is no need to transfer any files to the board during development process. 1. Confidential page 27 of 43 . stepping. April 10. The website can debugged with any common debug tool like Dreamweaver/Firebug. What to do! Additional info First build the Software for the PC architecture by clicking the dropdown button next to the hammer and selecting Debug_PCBUILD. as the webserver and the host CPU is the virtual machine itself. 2012 v1. Compile/debug/run the application on the PC In order to speed up the development process the whole ule application can be compiled and run on the virtual machine itself. Press the drop down button next to the Run External Tools button and select “Run Dect Bridge”. Start the application by pushing the Resume button. For more information on debugging with Eclipse tools.V.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 2. 4. If the stub has downloaded correctly. 2012 v1. April 10.1 Dialog Semiconductor B. 5. please see the SC14DECTIPBS SW manual and the (extensive) information on Eclipse on the internet. press the drop down button next to the Debug button. Select “ULE_RefDebugAPP” Running the ULE_RefDebugAPP will automatically open the debug environment. Verify in the console area that the Dect Bridge stub has started correctly. Confidential page 28 of 43 . In order to connect the radio module on the SC14DECTIPBS to the Eclipse SDK a stub (small program) must be downloaded to the board. This stub connects the radio module to the SDK over the Ethernet network. 3. Running applications may disturb follow up steps. When finished debugging.0. terminate the application by pressing the Terminate button. Right Click the Debug view (top right of your screen) and select “Close”. This feature doesnt intefere with operation of normal sensors which are also active in parallel. 2012 v1. a way to test IPBASE behavior with sensors that do not exist yet or are under developmnet.SC14DECTIPBS Quick Start Guide SC14DECTIPBS Note: Since the ULE application is running on the Virtual Machine the web interface and demo page is now active in the Virtual Machine (using libmicrohttpd).1 Dialog Semiconductor B. Open a browser and go to http://localhost:8020 or http://127.1:8020. Uncomment function ULE_Sensor_Simulate in main_app.0. Go back to the C/C++ view by closing the debug view. April 10. Confidential page 29 of 43 . 6. Warning: As an added feature the PC_BUILD version uses simulated sensors. In the default user application port 8020 is used in the VM.c to disable this feature. For more tips on how to work on the demo page please see the SC14DECTIPBS SW manual.V. Important: Make sure the debug application is not running anymore before continuing. com/ 9. Confidential page 30 of 43 . add the ability to breakpoint in JavaScript code and inspect JavaScript variables as well as intrnal JSON exchange activity. Optionally. 8.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 7. The application has now been verified to function properly by testing the functionality on the PC. This tools enable the inspection of generated html code.V. Finally one very useful to use for debugging website code is the Firefox plugin Firebug. April 10. http://getfirebug. you can debug natively the ule application clicking the debug button and using the Eclipse GDB debug tool.1 Dialog Semiconductor B. 2012 v1. Confidential page 31 of 43 . What to do! Additional info First cross-compile the Software for the SC14DECTIPBS target architecture by clicking the dropdown button next to the hammer and selecting Release_CROSSCOMPILE. the application output will be printed to the console. Check if the build is successful. then downloads the latest application from the Virtual Machine built in TFTP server (to which it was copied after compilation) and executes it. When the application is run from the RAM on the SC14DECTIPBS. 2. If the console shows “Copy to TFTP server…” and no apparent errors show the build was successful. 1.1 Dialog Semiconductor B. This is done by executing an expect script. Upon reset the board loses the RAM content so the program will be lost. which logs in to the board using Telnet. 2012 v1. In order to run the application it must be downloaded to the target and executed. go to the dropdown button next to the External Tools button and select: “Run ule_app” April 10. To invoke this script.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 7. Cross compiling the application and run from RAM This step is used to verify the program is working as expected on the target.V. April 10. Eclipse will only receive the output from the application but will not be able to send any keystrokes to it. 3. 2012 v1.1 Dialog Semiconductor B.SC14DECTIPBS Quick Start Guide SC14DECTIPBS The console now shows the script logging in on the board. Confidential page 32 of 43 . Eclipse uses telnet to kick off the ule application in the board. 4. downloading the application from the Virtual Machine TFTP server and executing it. Warning: Application menu is not accessible with this method.V. The application is now cross compiled for the SC14DECTIPBS target and has been tested on the actual device. The application response will show in the console area. After the application has been successfully modified and debugged it is time to update the image in the board so that the changes are made permanent. Check if the build is successful.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 8. If the console shows “cp linux-2. Upgrading the SC14DECTIPBS FLASH image stores the program to FLASH meaning the program will not be lost upon reset. Upgrading the SC14DECTIPBS FLASH image . Build the entire image (= application + Operating System + file system + …) by clicking the dropdown button next to the Compile button and select: “BUILD BOARD IMAGE” Note: compiling an image may take a while. 2012 v1. Additional info 1. Confidential page 33 of 43 . What to do! Updating the SC14DECTIPBS image.V. April 10. This step creates a FLASH image for the SC14DECTIPBS (much like the hard drive contents of a PC) and stores it in the board.1 Dialog Semiconductor B.x/vmlinuz /ser/tftp” and no apparent errors show the build was successful. This step is taken when the application has been debugged and verified.6. 3. Confidential page 34 of 43 . OS and so on) have been stored to FLASH successfully. 2. go to the dropdown button next to the External Tools button and select: “Update flash” Important: Make sure this process is not disturbed by for instance disconnecting the ethernet. erasing the FLASH and storing the new image. This will corrupt the flash and make the image difficult to restore. The console now shows the script logging in on the board. April 10. 2012 v1. power cycling the board or resetting the board. the board will be reset in order to activate the new image.1 Dialog Semiconductor B. which logs in to the board using Telnet. To invoke this script. file system. Once the update is successful. This is done by executing an expect script. Changes to the application or website will be retained after resetting the board. The ULE application (including the website.V. The script then downloads the image from the Virtual Machine built in TFTP server and stores it to the FLASH (after erasing the FLASH). downloading the image from the Virtual Machine TFTP server. 4.SC14DECTIPBS Quick Start Guide SC14DECTIPBS In order to update the SC14DECTIPBS image in the FLASH it must be downloaded to the target and stored. April 10.V.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 9. This section provides a few pointers where to change the Software in order to change functionality of the SC14DECTIPBS.html). What to do! The boards internal website can be modified by changing the contents of the website directory (index. 1.c file can be modified to: Register new function callbacks for new sensor types Change the main output to the console when starting the application 2. Refer to SW manual for a more thorough description of available functionality. Confidential page 35 of 43 . The main_app. Where to change the code .1 Dialog Semiconductor B. Additional info Note: the FLASH space on the board is limited. so the website should not exceed 500kB or so. Please see the SC14DECTIPBS SW manual for a more detailed description of the SW architecture. 2012 v1. 3. Note that the PC application is always connected to the boards Radio Module.1 Dialog Semiconductor B. Confidential page 36 of 43 . but simulated sensors provide easy debugging capabilities.c file contains the callback functions for the sensors (callbacks are registered in main_app. 2012 v1.c contains simulation sensors when just running on the PC. Modify this file to simulate sensor devices when running in the PC environment. 4.SC14DECTIPBS Quick Start Guide SC14DECTIPBS The sensor_handlers.c). The ule_simulate.V. April 10. 6.1 Dialog Semiconductor B. 2012 v1. April 10. The userhtmlHandler.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 5.V. The webrequest_handler.c file contains the code for incoming connections on the IP side. the base should send message y to device z” to a file in the FLASH and uses that to process incoming events from the ULE network devices. Change this code to add specific links between your ULE application and clients on the IP side. Confidential page 37 of 43 . Basically it stores rules such as “when device w sends message x.c is specifically designed to store application rules on the SC14DECTIPBS. Use this to bypass ULE app default JSON interface. 2012 v1. If you are connecting the IPBASE to your computer for the first time.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 10. Minicom is preconfigured in the VM and is adviced to use this option as part of all-in-one development process. 1. The black cable of the FTDI cable should be connected to the connector pin marked as black. April 10.V. Additional info 2. What to do! Connect a IPBASE to your PC with a USB to TTL converter cable. select USB Device and then the FTDI device. On the virtual machine Device Menu. the hardware drivers need to be installed before you can proceed. Connecting Serial Port This section describes how to connect the serial port interface to development machine. 3. This interface can be used for extra debug capabilities and system recovery in case of flash corruption.1 Dialog Semiconductor B. There are two methods which can be used to access the IP base serial port. Confidential page 38 of 43 . The first is by hyperTRM from the windows machine and the other is by using minicom in the virtual machine. 1 Dialog Semiconductor B. 2012 v1. check the device manager. Click on OK to continue. Open menu File and select New Connection Give the new connection a name and click on OK. Go to the item Ports (COM & LPT). 7./serial_terminal. Alternatively you can use Windows HyperTerminal to access IPBASE COM port. a program used to send and receive characters from the UART. 6. item System. On Windows XP go to the Control Panel. to which the USB-to-Serial cable is currently connected. 5. click on the Root terminal (uleuser is the password) and the type .V.sh. Under tab Hardware click on Device Manager. 4. The Connect To window appears Select the <COM-port> that represents the USB connecter. Note: If the mapping between <COM-port> and USB port is not clear. Check which COM port is the “USB Serial Port” April 10.SC14DECTIPBS Quick Start Guide SC14DECTIPBS On the virtual machine. Confidential page 39 of 43 . This will open minico. V. Enter the following settings in the COM properties windows.1 Dialog Semiconductor B.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 8. The IPBASE is now connected with serial port. April 10. Bits per second: 115200 Data bits: 8 Parity: None Stop bits: 1 Flow control: None 9. Confidential page 40 of 43 . 2012 v1. V. Although this is not very likely to happen. Most likely the FLASH upgrade process has been disrupted or the FLASH has been corrupted otherwise. 1.SC14DECTIPBS Quick Start Guide SC14DECTIPBS 11. What to do! Follow chapter 10 to connect the board a serial cable. Restoring the SC14DECTIPBS This section describes what to do if the SC14DECTIPBS is not responding anymore. Confidential page 41 of 43 . 2012 v1. April 10.3. It has a built in TFTP server that is hosting the Linux binary.1 Dialog Semiconductor B. Find the IP address of the Virtual Machine by typing “ifconfig”. The black cable of the FTDI cable should be connected to the connector pin marked as black. 2.0.190 (which will most likely be different in other cases). Note that in this example the IP is 10. the following steps can be used to restore functionality on the SC14DECTIPBS. Additional info The Virtual Machine should be running. April 10. 5.0.0. Program the following settings: setenv serverip 10.SC14DECTIPBS Quick Start Guide SC14DECTIPBS Stop the autoboot by pressing any key in the serial terminal within three seconds.3.3. please contact your system administrator which address is available). 2012 v1.10 The SC14DECTIPBS board needs an IP address to communicate (10.190 This setting defines the IP address of the Virtual Machine (where the TFTP server recides). saveenv Store the settings with the saveenv command.V. 6. Reset the SC14DECTIPBS after the upgrade is done and the board is restored. Confidential page 42 of 43 .0. setenv ipaddr 10.3.10 in this example. After programming the correct settings the Linux image can be restored using the following command: upgrade vmlinuz a00000 20000 4.0 Set the netmask appropriately. 3.255.1 Dialog Semiconductor B. Usually two subnets are sufficient.0. setenv netmask 255. or (b) support or sustain life. neither does it convey any license under its patent rights. can be reasonably expected to result in a significant injury to the user. (a) are intended for surgical implant into the body.dialogsemiconductor.service. This data sheet contains specifications on a product that has been discontinued by Dialog Semiconductor BV.com Customer service customer.SC14DECTIPBS Quick Start Guide SC14DECTIPBS PRODUCT STATUS DEFINITIONS Datasheet Status Advance Information Product Status Formative or in Design Definition This data sheet contains the design specifications for product development.service. Supplementary data will be published at a later date.ap@diasemi. and whose failure to perform.support@diasemi. Dialog Semiconductor BV does not assume any responsibility for use of any circuit described. Life support devices or systems are devices or systems which.1 Dialog Semiconductor B. Dialog Semiconductor BV reserves the right to make changes at any time without notice in order to improve design and supply the best possible product. RoHS Compliance Dialog Semiconductor complies to DIRECTIVE 2002/95/EC OF THE EUROPEAN PARLIAMENT AND OF THE COUNCIL of 27 January 2003 concerning Restriction of Hazardous Substances (RoHS). nor the right of others.service. (a) are intended for surgical implant into the [email protected] customer. Preliminary First Production No Identification Noted Full production Obsolete Not in Production Dialog Semiconductor BV reserves the right to make changes without notice to any products herein to improve reliability. Contacting Dialog Semiconductor Dialog Semiconductor BV-HQ Het Zuiderkruis 53 5215 MV „s-Hertogenbosch The Netherlands Tel: Fax: +31 (0) 73640 8822 +31 (0) 73640 8823 Dialog Semiconductor Hong Kong Ltd Dialog Semiconductor Japan Ltd Dialog Semiconductor Singapore Dialog Semiconductor US Refer to www.V. This data sheet contains final specifications. Dialog Semiconductor BV reserves the right to make changes at any time without notice in order to improve design and supply the best possible product. and Dialog reserves the right. Quality Policy RoHS certicates from our suppliers are available on request.eu@diasemi. and whose failure to perform.com. Product Status Definitions DIALOG‟S PRODUCTS ARE NOT AUTHORIZED FOR USE AS CRITICAL COMPONENTS IN LIFE SUPPORT DEVICES OR SYSTEMS WITHOUT THE EXPRESS WRITTEN APPROVAL OF THE PRESIDENT AND GENERAL COUNSIL OF DIALOG SEMICONDUCTOR BV. This data sheet contains preliminary data.com customer. The datasheet is printed for reference information only. See Corporate. when properly used in accordance with instructions for use provided in the labeling. function or design. to change said circuitry or specifications. when properly used in accordance with instructions for use provided in the labeling. can be reasonably expected to result in a significant injury to the user. 2012 v1. Confidential page 43 of 43 . at any time without notice. or (b) support or sustain life.com for addresses and telephone numbers Customer support dctule. Specifications may change in any manner without notice. no circuit patent licenses are implied. Dialog Semiconductor‟s statement on RoHS can be found on http://www.com customer. Dialog Semiconductor BV does not assume any liability arising out of the application or use of any product or circuit described [email protected] April 10. 2. AS USED HEREIN: 1.service.dialogsemiconductors. Life support devices or systems are devices or systems which.