Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
resources:tools-software:uc-drivers:renesas:adxl345 [16 Mar 2012 15:32] – Added the "Software Setup" section and replaced the "Software Project Setup" link. Dragos Bogdanresources:tools-software:uc-drivers:renesas:adxl345 [24 Jan 2021 17:22] (current) – Fix bad links Dragos Bogdan
Line 1: Line 1:
-====== ADXL345 - Microcontroller No-OS Driver ====== +====== ADXL345 - No-OS Driver for Renesas Microcontroller Platforms ====== 
- +{{page>:resources:tools-software:uc-drivers:adxl345}}
-===== Supported Devices ===== +
-  * [[adi>ADXL345]] +
- +
-===== Evaluation Boards ===== +
-  * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]]  +
- +
-===== Overview ===== +
- +
-The [[adi>ADXL345]] is a small, thin, low power, 3-axis accelerometer with high resolution (13-bit) measurement at up to ±16 g. Digital output data is formatted as 16-bit twos complement and is accessible through either a SPI (3- or 4-wire) or I2C digital interface. The [[adi>ADXL345]] is well suited for mobile device applications. It measures the static acceleration of gravity in tilt-sensing appli-cations, as well as dynamic acceleration resulting from motion or shock. Its high resolution (4 mg/LSB) enables measurement of inclination changes less than 1.0°. +
- +
-{{ :resources:tools-software:uc-drivers:renesas:pmod_acl.jpg? |}} +
- +
-The goal of this project (Microcontroller No-OS) is to be able to provide reference projects for lower end processors, which can't run Linux, or aren't running a specific operating system, to help those customers using microcontrollers with ADI parts. Here you can find a generic driver which can be used as a base for any microcontroller platform and also specific drivers for Renesas platforms.+
  
 **HW Platform(s):** **HW Platform(s):**
-  * [[http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_demo_kits/yrdkrl78g13/index.jsp|Renesas Demo Kit for RL78G13 (Renesas)]] +  * [[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rl78-low-power-8-16-bit-mcus/yrdkrl78g13-yrdkrl78g13-demonstration-kit-rl78g13|Renesas Demo Kit for RL78G13 (Renesas)]] 
-  * [[http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_demo_kits/yrdkrx62n/index.jsp|Renesas Demo Kit for RX62N (Renesas)]]+  * [[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/yrdkrx62n-yrdkrx62n-demonstration-kit-rx62n|Renesas Demo Kit for RX62N (Renesas)]]
  
-===== Driver Description ===== +===== Downloads =====
-The driver contains two parts: +
-  * The driver for the ADXL345 part, which may be used, without modifications, with any microcontroller. +
-  * The Communication Driver, where the specific communication functions for the desired type of processor and communication protocol have to be implemented. This driver implements the communication with the device and hides the actual details of the communication protocol to the ADI driver.+
  
-The Communication Driver has a standard interface, so the ADXL345 driver can be used exactly as it is provided. +<WRAP round download 80%>
- +
-If the SPI communication is chosen, there are three functions which are called by the ADXL345 driver: +
-  * SPI_Init() – initializes the communication peripheral. +
-  * SPI_Write() – writes data to the device. +
-  * SPI_Read() – reads data from the device. +
- +
-{{ :resources:tools-software:uc-drivers:renesas:spi_architecture.png? |}} +
-<WRAP centeralign> +
-SPI driver architecture +
-</WRAP> +
- +
-If the I2C communication is chosen, there are three functions which are called by the ADXL345 driver: +
-  * I2C_Init() – initializes the communication peripheral. +
-  * I2C_Write() – writes data to the device. +
-  * I2C_Read() – reads data from the device. +
- +
-{{ :resources:tools-software:uc-drivers:renesas:i2c_architecture.png? |}} +
-<WRAP centeralign> +
-I2C driver architecture +
-</WRAP> +
- +
-The implementation of these three functions depends on the used microcontroller. +
- +
-<note important>The communication protocol has to be chosen in the header file of the Communication Driver. +
- +
-Example: +
- +
-#define ADXL345_COMMUNICATION SPI_COMMUNICATION +
- +
-or +
- +
-#define ADXL345_COMMUNICATION I2C_COMMUNICATION</note> +
- +
-The driver for ADXL345 contains functions for reading or writing any of the registers, for placing the device into standby or measure mode, for enable or disable various types of events detection, etc. +
- +
-The following functions are implemented in this version of ADXL345 driver: +
-^ Function       ^ Description     ^ +
-| void ADXL345_SetRegisterValue(unsigned char registerAddress, unsigned char registerValue) | Writes data into a register. | +
-| unsigned char ADXL345_GetRegisterValue(unsigned char registerAddress) | Reads the value of a register. | +
-| unsigned char ADXL345_Init(void) | Initializes the communication peripheral and checks if the ADXL345 part is present. | +
-| void ADXL345_SetPowerMode(unsigned char pwrMode) | Places the device into standby/measure mode. | +
-| void ADXL345_GetXyz(unsigned short* x, unsigned short* y, unsigned short* z) | Reads the output data of each axis. | +
-| void ADXL345_SetTapDetection(unsigned char tapType, unsigned char tapAxes, unsigned char tapDur, unsigned char tapLatent, unsigned char tapWindow, unsigned char tapThresh, unsigned char tapInt) | Enables/disables the tap detection. | +
-| void ADXL345_SetActivityDetection(unsigned char actOnOff, unsigned char actAxes, unsigned char actAcDc, unsigned char actThresh, unsigned char actInt) | Enables/disables the activity detection. | +
-| void ADXL345_SetInactivityDetection(unsigned char inactOnOff, unsigned char inactAxes, unsigned char inactAcDc, unsigned char inactThresh, unsigned char inactTime, unsigned char inactInt) | Enables/disables the inactivity detection. | +
-| void ADXL345_SetFreeFallDetection(unsigned char ffOnOff, unsigned char ffThresh, unsigned char ffTime, unsigned char ffInt) | Enables/disables the free-fall detection. | +
-| void ADXL345_SetOffset(unsigned char xOffset, unsigned char yOffset, unsigned char zOffset) | Calibrates the accelerometer. | +
- +
-===== Downloads ===== +
-  * {{:resources:tools-software:uc-drivers:renesas:adxl345_generic.zip|ADXL345 Generic Driver}}+
   * {{:resources:tools-software:uc-drivers:renesas:adxl345_rl78g13.zip|ADXL345 RL78G13 Driver}}   * {{:resources:tools-software:uc-drivers:renesas:adxl345_rl78g13.zip|ADXL345 RL78G13 Driver}}
   * {{:resources:tools-software:uc-drivers:renesas:adxl345_rx62n.zip|ADXL345 RX62N Driver}}   * {{:resources:tools-software:uc-drivers:renesas:adxl345_rx62n.zip|ADXL345 RX62N Driver}}
 +  * **ADXL345 Driver:           ** https://github.com/analogdevicesinc/no-OS/tree/master/drivers/accel/adxl345
 +  * **PmodACL Demo for RL78G14: ** https://github.com/analogdevicesinc/no-OS/tree/master/Renesas/RL78G14/PmodACL
 +  * **RL78G14 Common Drivers:   ** https://github.com/analogdevicesinc/no-OS/tree/master/Renesas/RL78G14/Common
 +</WRAP>
  
 ====== Renesas RL78G13 Quick Start Guide ====== ====== Renesas RL78G13 Quick Start Guide ======
- 
 This section contains a description of the steps required to run the ADXL345 demonstration project on a Renesas RL78G13 platform.  This section contains a description of the steps required to run the ADXL345 demonstration project on a Renesas RL78G13 platform. 
  
 ==== Required Hardware ==== ==== Required Hardware ====
-  * [[http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_demo_kits/yrdkrl78g13/index.jsp|Renesas Demo Kit for RL78G13 (Renesas)]]+  * [[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rl78-low-power-8-16-bit-mcus/yrdkrl78g13-yrdkrl78g13-demonstration-kit-rl78g13|Renesas Demo Kit for RL78G13 (Renesas)]]
   * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]] (optional, because an ADXL345 part is installed on Renesas Demonstration Kit (RDK) for RL78G13)   * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]] (optional, because an ADXL345 part is installed on Renesas Demonstration Kit (RDK) for RL78G13)
  
 ==== Required Software ==== ==== Required Software ====
   * [[http://www.iar.com/en/Products/IAR-Embedded-Workbench/Renesas-RL78/|IAR Embedded Workbench for Renesas RL78 Kickstart]]   * [[http://www.iar.com/en/Products/IAR-Embedded-Workbench/Renesas-RL78/|IAR Embedded Workbench for Renesas RL78 Kickstart]]
-  * [[http://am.renesas.com/|Applilet3 for RL78G13]] 
  
 ==== Hardware Setup ==== ==== Hardware Setup ====
Line 101: Line 37:
 {{ :resources:tools-software:uc-drivers:renesas:pmod_acl_rl78g13.jpg? |}} {{ :resources:tools-software:uc-drivers:renesas:pmod_acl_rl78g13.jpg? |}}
  
-==== Software Setup ==== +==== Reference Project Overview ==== 
-With the //**Applilet3 for RL78G13**// tool the following peripherals have to be configured:+In this example, the output data of each axis is read and displayed on the Renesas Demonstration Kit for RL78G13 board’s LCD. Were also activated “Single Tap”, “Double Tap” and “Free-Fall” interrupts. When one of them occurs, on the LCD screen appears a corresponding message.
  
-=== CSI10 (Clocked Serial Interface 10) – For the ST7579 LCD and the ADXL345 part(if the SPI protocol is chosen) === +{{ :resources:tools-software:uc-drivers:renesas:adxl345_rl78g13_screen.jpg? |}}
-Choose to generate the Transmit/receive function for the CSI10 and configure the interface with the following settings: +
-  * Transfer mode setting//**Single transfer mode**// +
-  * Data length setting //**8 bits**// +
-  * Transfer direction setting//**MSB**// +
-  * Specification of data timing//**Type 1**// +
-  * Transfer rate setting – Clock mode: //**Internal clock (master)**// +
-  * Transfer rate setting – Baudrate: //**1000000**// (bps) +
-  * Interrupt setting – Transfer interrupt priority (INTCSI10): //**Low**// +
-  * Uncheck the callback functions.+
  
-=== IICA0 (Inter Integrated Circuit Bus) - For the ADXL345 part(if the I2C protocol is chosen) === +==== Software Project Setup ==== 
-Choose the //**Single master**// transfer mode and configure the interface with the following settings: +{{page>rl78g13_software_tutorial_without_applilet3}}
-  * Clock mode setting: //**fCLK/2**// +
-  * Local address setting – Address: //**16**// +
-  * Operation mode setting : //**Standard**// +
-  * Operation mode setting – Transfer clock (fSCL): //**100000**// (bps) +
-  * Interrupt setting – Communication end interrupt priority (INTIICA0): //**Low**// +
-  * Callback function setting: Check //**Master transmission end**// and //**Master reception end**// callback functions +
-  * Callback function enhanced feature setting: Check the //**Callback function enhanced feature setting**//.+
  
-=== TM00 (Timer 00) – For the DelayMs() function ===  +====== Renesas RL78G14 Quick Start Guide ====== 
-Configure TM00 as an interval timer: +This section contains a description of the steps required to run the ADXL345 demonstration project on a Renesas RL78G14 platform using the PmodACL.
-  * Interval timer setting - Interval value(16 bits): //**1**// ms +
-  * Interval timer setting - Uncheck //Generates INTM00 when counting is started// +
-  * Interrupt setting - Uncheck // End of timer channel 0 count, generate an interrupt (INTM00)//+
  
-=== Watchdog Timer === +==== Required Hardware ==== 
-Disable the watchdog timer+ 
-  * Choose for the Watchdog timer operation setting: //**Unused**// option.+  * [[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rl78-low-power-8-16-bit-mcus/yrdkrl78g14-yrdkrl78g14-demonstration-kit-rl78g14|Renesas Demo Kit for RL78G14 (Renesas)]] 
 +  * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]] (optional, because an ADXL345 part is installed on Renesas Demonstration Kit (RDK) for RL78G14) 
 +==== Required Software ==== 
 +  * [[http://www.iar.com/en/Products/IAR-Embedded-Workbench/Renesas-RL78/|IAR Embedded Workbench for Renesas RL78 Kickstart]] 
 +  The ADXL345 demonstration project for the Renesas RL78G14 platform. 
 + 
 +<WRAP round info 80%> 
 +The ADXL345 demonstration project for the Renesas RL78G14 platform consists of three parts: the **ADXL345 Driver**,  the **PmodACL Demo for RL78G14** and the **RL78G14 Common Drivers**. 
 + 
 +All three parts have to be downloaded. 
 +</WRAP> 
 +==== Hardware Setup ==== 
 +There are two options: 
 + 
 +  * The ADXL345 part installed on the Renesas Demonstration Kit (RDK) for RL78G14 can be used. In this case, the I2C protocol has to be chosen with 'ADXL345_Init()' function. 
 + 
 +{{ :resources:tools-software:uc-drivers:renesas:adxl345_rl78g14.jpg? |}} 
 + 
 +  * A PmodACL can be connected to the PMOD1 connector. In this case, the SPI protocol has to be chosen with 'ADXL345_Init()' function. 
 + 
 +{{ :resources:tools-software:uc-drivers:renesas:pmod_acl_rl78g14.jpg? |}}
  
 ==== Reference Project Overview ==== ==== Reference Project Overview ====
-In this example, the output data of each axis is read and displayed on the Renesas Demonstration Kit for RL78G13 board’s LCD. Were also activated “Single Tap”, “Double Tap” and “Free-Fall” interrupts. When one of them occurs, on the LCD screen appears a corresponding message.+The reference project: 
 +  * reads and displays the data for each axis on LCD
 +  * it displays also on LCD if the interrupts “Single Tap”, “Double Tap” or “Free-Fall” were activated
  
-{{ :resources:tools-software:uc-drivers:renesas:adxl345_rl78g13_screen.jpg? |}}+{{ :resources:tools-software:uc-drivers:renesas:adxl345_rl78g14_screen.jpg? |}} 
 + 
 + 
 +==== Software Project Tutorial ==== 
 +{{page>rl78g14_software_tutorial}}
  
-==== Software Project Setup ==== 
-{{page>rl78g13_software_tutorial}} 
  
 ====== Renesas RX62N Quick Start Guide ====== ====== Renesas RX62N Quick Start Guide ======
Line 147: Line 88:
  
 ==== Required Hardware ==== ==== Required Hardware ====
-  * [[http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_demo_kits/yrdkrx62n/index.jsp|Renesas Demo Kit for RX62N (Renesas)]]+  * [[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/yrdkrx62n-yrdkrx62n-demonstration-kit-rx62n|Renesas Demo Kit for RX62N (Renesas)]]
   * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]] (optional, because an ADXL345 part is installed on Renesas Demonstration Kit (RDK) for RX62N)   * [[http://www.digilentinc.com/Products/Detail.cfm?Prod=PMOD-ACL|PmodACL]] (optional, because an ADXL345 part is installed on Renesas Demonstration Kit (RDK) for RX62N)
  
 ==== Required Software ==== ==== Required Software ====
-  * [[http://www.renesas.com/products/tools/ide/ide_hew/index.jsp|High-performance Embedded Workshop for RX62N family]] +  * [[https://www.renesas.com/us/en/software-tool/high-performance-embedded-workshop|High-performance Embedded Workshop for RX62N family]] 
-  * [[http://am.renesas.com/products/tools/middleware_and_drivers/c_driver_gen/driver_gen_rpdl/index.jsp|Renesas Peripheral Driver Library for RX62N family]]+  * [[https://www.renesas.com/us/en/software-tool/renesas-peripheral-driver-library|Renesas Peripheral Driver Library for RX62N family]]
  
 ==== Hardware Setup ==== ==== Hardware Setup ====
Line 173: Line 114:
  
 ==== Reference Project Overview ==== ==== Reference Project Overview ====
- 
 In this example, the output data of each axis is read and displayed on the Renesas Demonstration Kit for RX62N board’s LCD. Were also activated “Single Tap”, “Double Tap” and “Free-Fall” interrupts. When one of them occurs, on the LCD screen appears a corresponding message.  In this example, the output data of each axis is read and displayed on the Renesas Demonstration Kit for RX62N board’s LCD. Were also activated “Single Tap”, “Double Tap” and “Free-Fall” interrupts. When one of them occurs, on the LCD screen appears a corresponding message. 
  
Line 180: Line 120:
 ==== Software Project Setup ==== ==== Software Project Setup ====
 {{page>rx62n_software_design}} {{page>rx62n_software_design}}
 +
 +====== More information ======
 +{{page>:resources:tools-software:uc-drivers:more-information}}
resources/tools-software/uc-drivers/renesas/adxl345.1331908333.txt.gz · Last modified: 16 Mar 2012 15:32 by Dragos Bogdan