Würth eiSos Series User Manual
  1. Manuals
  2. Brands
  3. Würth Manuals
  4. Microcontrollers
  5. eiSos Series
  6. User manual
Würth eiSos Series User Manual

Würth eiSos Series User Manual

Sensors software development kit
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
S
S
ENSORS
OFTWARE DEVELOPMENT KIT
U
SER MANUAL
V
1.1
ERSION
O
31, 2019
CTOBER

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the eiSos Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Würth eiSos Series

  • Page 1 ENSORS OFTWARE DEVELOPMENT KIT SER MANUAL ERSION 31, 2019 CTOBER...
  • Page 2 Revision history Manual Notes Date version version • Initial version of this document August 2019 • Updated sensors supported and software history November 2019 • Changed the wiringPi install method as recommended by it’s author. For SDK version history see chapter Software history Sensors SDK, User manual Version 1.1 ©...
  • Page 3 Abbreviations and abstract Abbreviation Name Description Analog to Digital converter Application specific ASIC integrated circuit General Purpose Input GPIO Output Integrated development A set of tools for software development environment Serial communication interface and Inter-integrated circuit protocol Microcontroller Software development tool to integrate Software development kit various Würth Elektronik eiSos products Serial communication interface and...

  • Page 4: Table Of Contents

    Contents 1 Introduction Motivation ........2 Sensors SDK overview Platform-independent sensor drivers .

  • Page 5: Introduction

    1 Introduction The Würth Elektronik eiSos range of sensors provide advanced sensing capabilities to any embedded application. The built-in digital interface enables easy integration with any of the most commonly used host MCUs through industry standard serial communication interfaces like I C. This also allows complete configuration and control of the sensor via software run- ning on the host MCU.

  • Page 6: Sensors Sdk Driver As Part Of The End Product

    Figure 1: Sensors SDK driver as part of the end product Sensors SDK, User manual Version 1.1 © October 2019 www.we-online.com/sensors...

  • Page 7: Sensors Sdk Overview

    2 Sensors SDK overview In this chapter, constituents of the Sensors SDK are described in details. 2.1 Platform-independent sensor drivers This part of the Sensors SDK consists of a set of C header and source file per sensor. Every source file contains implementations for configuration and control of the sensors that is exposed to the application via functions and type declarations in the corresponding header file.

  • Page 8: Contents Of The Sensors Sdk

    2.3 Contents of the Sensors SDK The Sensors SDK is delivered as a compressed zip-file. All code related to a sensor sup- ported by the Sensors SDK are placed under a sub directory named after the corresponding sensor. Each sensor directory contains two sub-directories, drivers and examples. The sub-directory drivers contains the platform-independent code that can be used to port to the custom MCU.

  • Page 9: Host Integration

    3 Host integration As described in chapter 2 the Sensors SDK has a platform independent driver component and Raspberry-pi specific examples which demonstrate the use of these drivers. In the fol- lowing, the steps involved in porting the drivers to a custom platform is described. The contents of the drivers directory has to be directly integrated into the custom project.
  • Page 10 The register read and write functions shall be implemented to read/write one byte at a time. Burst read/write operations can be implemented based on the host MCU peripheral and the sensor used. The existing platform.c file, can be removed from the project as it contains the correspond- ing implementation for the Raspberry Pi.

  • Page 11: Running Sensors Sdk Sample Application On The Raspberry Pi

    4 Running Sensors SDK sample application on the Raspberry Pi This chapter explains the steps involved in running the sample applications of the Sensors SDK on the Raspberry Pi platform. 4.1 Hardware connections For creating custom applications on the basis of the Raspberry Pi, connect the pins of the sensor evaluation board to corresponding pins on the Raspberry Pi (power supply, ground, I C).

  • Page 12: Connecting An I C Sensor To Raspberry Pi 3B

    +VDD Pull up resistors (serial clock) Raspberry Pi (Master) (serial data) Sensor (Slave) Figure 3: Connecting an I C sensor to Raspberry Pi 3B Alternatively, Würth Elektronik eiSos Amber-Pi, an add-on module for the Raspberry Pi can be used to connect the sensor evaluation board directly to the Raspberry Pi. Figure 4: Senesor evaluation board with Amber-Pi Sensors SDK, User manual Version 1.1...

  • Page 13: Install The Raspbian Os On The Raspberry Pi

    4.2 Install the Raspbian OS on the Raspberry Pi 1. First of all the Raspberry Pi has to be installed and configured. a) Download the latest version of Raspbian with GUI from https://www.raspberrypi.org/downloads/raspbian/ b) Install the Raspbian OS by writing its image on your SD-card. On a Windows machine the Win32DiskImager tool can be used, as described here www.raspberrypi.org/documentation/installation/installing-images/windows.md 2.

  • Page 14: Configuring The Peripherals

    4.2.1 Configuring the peripherals 1. Next, the peripherals have to be enabled. To do so open the menu by clicking on the Raspberry Pi symbol on the left upper corner of the screen and open the Prefer- Raspberry Pi Configuration window (see figure 7 ). Enable the SPI, I2C ences and SERIAL interface.

  • Page 15: Install The Sensors Sdk

    4.4 Install the Sensors SDK The Sensors SDK was developed in the Code::Blocks development environment. 1. Thus first download and install the software Code::Blocks. Therefore open a terminal and type: sudo apt get install codeblocks 2. Now download the Sensors SDK driver as zip file from (www.we-online.de/wcs-software) to the location ~/Downloads 3.

  • Page 16: Code::blocks Linker Settings

    Figure 8: Code::Blocks linker settings Rebuild to build the project (see figure 9 ). 8. Then press Build Figure 9: Rebuild the application 9. If it builds without errors the Raspberry Pi, WiringPi and Sensors SDK setup succeed- 10. In case of further question, please contact our technical support at https://we-online.com/wireless- connectivity/support Sensors SDK, User manual Version 1.1...

  • Page 17: Software History

    5 Software history Version 1.0.0 "Release" • First released version of the SDK. • PADS driver and example. Version 1.1.0 "Release" • Added driver support for ITDS and PDUS sensors. • Added example for ITDS. Sensors SDK, User manual Version 1.1 ©...

  • Page 18: Important Notes

    6 Important notes The following conditions apply to all goods within the sensors product range of Würth Elek- tronik eiSos GmbH & Co. KG: 6.1 General customer responsibility Some goods within the product range of Würth Elektronik eiSos GmbH & Co. KG contain statements regarding general suitability for certain application areas.

  • Page 19: Product Improvements

    6.5 Product improvements Due to constant product improvement, product specifications may change from time to time. As a standard reporting procedure of the Product Change Notification (PCN) according to the JEDEC-Standard, we inform about major changes. In case of further queries regarding the PCN, the field sales engineer, the internal sales person or the technical support team in charge should be contacted.

  • Page 20: Legal Notice

    7 Legal notice 7.1 Exclusion of liability Würth Elektronik eiSos GmbH & Co. KG considers the information in this document to be correct at the time of publication. However, Würth Elektronik eiSos GmbH & Co. KG re- serves the right to modify the information such as technical specifications or functions of its products or discontinue the production of these products or the support of one of these products without any written announcement or notification to customers.
  • Page 21 informed about the intent of such usage before the design-in stage. In addition, sufficient reliability evaluation checks for safety must be performed on every electronic component, which is used in electrical circuits that require high safety and reliability function or perfor- mance.

  • Page 22: License Terms For Würth Elektronik Eisos Gmbh & Co. Kg Sensor Product

    8 License terms for Würth Elektronik eiSos GmbH & Co. KG sensor product software and source code This License terms will take effect upon the purchase and usage of the Würth Elektronik eiSos GmbH & Co. KG sensor products. You hereby agree that this license terms are appli- cable to the product and the incorporated software, firmware and source codes (collectively, "Software") made available by Würth Elektronik eiSos in any form, including but not limited to binary, executable or source code form.

  • Page 23: Ownership

    use in areas such as military, aerospace, aviation, nuclear control, submarine, transportation (automotive control, train control, ship control), transportation signal, disaster prevention, medical, public information network etc. You shall inform Würth Elektronik eiSos about the intent of such usage before design-in stage. In certain customer applications requiring a very high level of safety and in which the malfunction or failure of an electronic component could endanger human life or health, you must ensure to have all necessary expertise in the safety and regulatory ramifications of your applications.

  • Page 24: Severability Clause

    resolved and finally settled by the court competent for the location of Würth Elektronik eiSos registered office. 8.7 Severability clause If a provision of this license terms are or becomes invalid, unenforceable or null and void, this shall not affect the remaining provisions of the terms. The parties shall replace any such provisions with new valid provisions that most closely approximate the purpose of the terms.
  • Page 25 List of Figures Sensors SDK driver as part of the end product ....Pinout of 40-pin GPIO header of Raspberry Pi 3B ....Connecting an I C sensor to Raspberry Pi 3B .
  • Page 26 more than you expect Monitoring Automated Meter Internet & Control Reading of Things Contact: Würth Elektronik eiSos GmbH & Co. KG Division Wireless Connectivity & Sensors Max-Eyth-Straße 1 74638 Waldenburg Germany Tel.: +49 651 99355-0 Fax.: +49 651 99355-69 www.we-online.com/wireless-connectivity...

Table of Contents