Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
| resources:tools-software:uc-drivers:microchip:adp5589 [28 Sep 2012 12:42] – created Andrei Cozma | resources:tools-software:uc-drivers:microchip:adp5589 [22 Jul 2019 14:18] (current) – Update no-OS driver link Andrei Drimbarean | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== ADP5589 - Microcontroller | + | ====== ADP5589 - No-OS Driver |
| - | + | {{page>: | |
| - | ===== Supported Devices ===== | + | |
| - | * [[adi> | + | |
| - | + | ||
| - | ===== Evaluation Boards ===== | + | |
| - | * [[http:// | + | |
| - | + | ||
| - | ===== Overview ===== | + | |
| - | + | ||
| - | The [[adi> | + | |
| - | + | ||
| - | I/O expanders can be used to increase the number of I/Os available to a processor or to reduce the number of I/Os required through interface connectors for front panel designs. | + | |
| - | + | ||
| - | {{ : | + | |
| - | + | ||
| - | 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:// | + | |
| - | * [[http:// | + | |
| - | | + | |
| * [[http:// | * [[http:// | ||
| - | |||
| - | ===== Driver Description ===== | ||
| - | The driver contains two parts: | ||
| - | * The driver for the ADP5589 part, which may be used, without modifications, | ||
| - | * 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 ADP5589 driver can be used exactly as it is provided. | ||
| - | |||
| - | There are three functions which are called by the ADP5589 driver: | ||
| - | * I2C_Init() – initializes the communication peripheral. | ||
| - | * I2C_Write() – writes data to the device. | ||
| - | * I2C_Read() – reads data from the device. | ||
| - | |||
| - | {{ : | ||
| - | <WRAP centeralign> | ||
| - | I2C driver architecture | ||
| - | </ | ||
| - | |||
| - | The implementation of these three functions depends on the used microcontroller. | ||
| - | |||
| - | The following functions are implemented in this version of ADP5589 driver: | ||
| - | ^ Function | ||
| - | | void ADP5589_SetRegisterValue(unsigned char registerAddress, | ||
| - | | unsigned char ADP5589_GetRegisterValue(unsigned char registerAddress) | Reads the value of a register. | | ||
| - | | unsigned char ADP5589_Init(void) | Initializes the communication peripheral and checks if the ADP5589 part is present. | | ||
| - | | void ADP5589_InitPwm(void) | Initializes the PWM generator in continuous mode. | | ||
| - | | void ADP5589_SetPwm(unsigned short pwmOffTime, unsigned short pwmOnTime) | Sets the PWM On and Off times. | | ||
| - | | void ADP5589_GpioDirection(unsigned char reg, unsigned char val) | Sets the direction of the pins. | | ||
| - | | unsigned char ADP5589_GetPinState(unsigned char reg) | Reads the state of the pins. | | ||
| - | | void ADP5589_SetPinState(unsigned char reg, unsigned char state) | Sets the state of the pins. | | ||
| - | | void ADP5589_InitKey(unsigned char pmodPort) | Initializes keyboard decoder. | | ||
| - | | unsigned char ADP5589_KeyDecode(unsigned char reg, unsigned char pmodPort) | Decodes the key pressed on the Pmod-KYPD. | | ||
| - | | void ADP5589_KeyLock(unsigned char pmodPort) | Locks the ADP5589 and requests Password for unlock. | | ||
| ===== Downloads ===== | ===== Downloads ===== | ||
| - | * {{: | + | <WRAP round download 80%> |
| - | * {{: | + | |
| * {{: | * {{: | ||
| + | * **ADP5589 Driver: | ||
| + | * **PmodIOXP Demo for PIC32MX320F128H: | ||
| + | * **PIC32MX320F128H Common Drivers: | ||
| + | </ | ||
| ====== Digilent Cerebot MX3cK Quick Start Guide ====== | ====== Digilent Cerebot MX3cK Quick Start Guide ====== | ||
| Line 72: | Line 24: | ||
| * [[http:// | * [[http:// | ||
| * [[http:// | * [[http:// | ||
| + | * The ADP5589 demonstration project for PIC32MX320F128H. | ||
| + | |||
| + | <WRAP round info 80%> | ||
| + | The ADP5589 demonstration project for PIC32MX320F128H consists of three parts: the **ADP5589 Driver**, | ||
| + | |||
| + | All three parts have to be downloaded. | ||
| + | </ | ||
| ==== Hardware Setup ==== | ==== Hardware Setup ==== | ||
| - | A PmodIOXP has to be connected to the J2 connector of Cerebot MX3cK development board. | + | A PmodIOXP has to be connected to the J2 connector of Cerebot MX3cK development board. For this demonstration project, PmodKYPD must be connected to J2 connector of PmodIOXP, because the PWM signal is mapped on J1 connector, pin 4. |
| {{ : | {{ : | ||
| ==== Reference Project Overview ==== | ==== Reference Project Overview ==== | ||
| - | Following | + | The following |
| ^ Command ^ Description ^ | ^ Command ^ Description ^ | ||
| | help? | Displays all available commands. | | | help? | Displays all available commands. | | ||
| - | | pwmOnTime= | On time of the PWM pulse. Accepted values: | + | | pwmOnTime= | On time of the PWM pulse. Accepted values:\\ 1 .. 65535[us] - time when the signal is high. | |
| - | | pwmOffTime= | Off time of the PWM pulse. Accepted values: | + | | pwmOffTime= | Off time of the PWM pulse. Accepted values:\\ 1 .. 65535[us] - time when the signal is low. | |
| - | | lastKey? | Displays the last key which was pressed | | + | | keyPressed? | Displays the last key which was pressed. | |
| + | | keyReleased? | ||
| Commands can be executed using a serial terminal connected to the UART1 peripheral of PIC32MX320F128H. | Commands can be executed using a serial terminal connected to the UART1 peripheral of PIC32MX320F128H. | ||
| - | The following image shows a list of commands in a serial terminal connected to processor’s UART peripheral. | + | The following image shows a generic |
| {{ : | {{ : | ||
| - | |||
| ==== Software Project Setup ==== | ==== Software Project Setup ==== | ||
| {{page>: | {{page>: | ||
| Line 125: | Line 84: | ||
| ====== More information ====== | ====== More information ====== | ||
| - | {{page> | + | {{page>: |
resources/tools-software/uc-drivers/microchip/adp5589.1348828966.txt.gz · Last modified: 28 Sep 2012 12:42 by Andrei Cozma