全港音樂機械人大賽 - 蘋果日報

音樂機械人大賽學生鬥創意 - 蘋果日報 2013年08月24日

http://hk.apple.nextmedia.com/realtime/news/20130824/51670062

將軍澳一個商場與香港機械人學院今午合辦「全港首個音樂機械人大賽」,12支由中學生組成的隊伍將會參賽,參賽的機械人必須透過自動「敲擊」樂器,奏出一首最少一分鐘的樂曲,而機械人可裝備敲擊樂器或能發聲的物件,如電子琴、鼓、盛水玻璃瓶、鐵罐等物品。讓學生結合藝術、機械原理、物理等知識,發揮創意。奪大獎的隊伍將有8,000元獎金,另設最具創意奬,奬金5,000元,網上最具人氣獎有3,000元獎金。

主辦活動的商場 PopCorn 指比賽旨在推動香港機械教育,鼓勵同學激發潛能,挑戰結合音樂、藝術、科技三大元素的全新機械人創作概念,發揮無限創作想像力,成就小發明家 。

.END

7 segment LED function writing notes

// ***********************************************************************
// Program  - Test LPC1114
// Function - Test LPC1114
// Author   - TL Fong
// Build    - 2013.08.24.03
// Date     - 2013aug24hkt2102
// Hardware - LPC1114/102, LPC1114/301
// Software - GCC ARM 4.7, CoIDE 1.7.4,  CoLinkEx 1.1, Flash Magic v7.51
// ***********************************************************************

#include "blink031.h"
#include "blink032.h"
#include "display7SegLed031.h"

// ***********************************************************************
// Functions
// ***********************************************************************

void blinkLedP18();
void blinkLedP09();
void blinkAllLeds();
void displayAllDigits();

// ***********************************************************************
// Main Function
// ***********************************************************************

int main()
{
blinkLedP18(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_4_TIMES);
blinkLedP09(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_4_TIMES);
blinkAllLeds(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_4_TIMES);

displayAllDigits(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_4_TIMES);

return 0;
}

// ***********************************************************************
// End
// ***********************************************************************




// ***********************************************************************
// display7SegLed031.h
// ***********************************************************************

#include "config031.h"
#include "delay031.h"
#include "gpio032.h"

// ***********************************************************************
// 7 segment LED functions
// ***********************************************************************

// ***********************************************************************
// Function -
// Input    -
// Output   -
// ***********************************************************************

void displayOneDigit(portPinArrayPointerArray portPinArrayPointerArray, \
  deviceNumber ledNumber, int onTime, int offTime, int blinkCount)
{
int count = 0;
int portNumber = 0;
int pinNumber = 0;
GPIO_TypeDef *gpio_struct_ptr;
portPinArray *portPinArrayPointer;

portPinArrayPointer = portPinArrayPointerArray[ledNumber - 1];

   portNumber = getPortNumber(*portPinArrayPointer);
   pinNumber = getPinNumber(*portPinArrayPointer);
   gpio_struct_ptr = getGpioStructPointer(portNumber);

   for (count = 0; count < blinkCount; count++)
   {
  setGpioDataPinHigh(gpio_struct_ptr, pinNumber);
  delayTenthSecond(onTime);
  setGpioDataPinLow(gpio_struct_ptr, pinNumber);
  delayTenthSecond(offTime);
   }
}

// ***********************************************************************
// Function - Display all digits
// Input    -
// Output   -
// ***********************************************************************

void displayAllDigits(int onTime, int offTime, int repeatCount)
{
int digitNumber;

initializeAllLedPins(WhutBoardSevenSegmentLedPortPinArrayPointerArray, MAX_7_SEG_LED_PIN_NUMBER);

/*
    for (ledNumber = 1; ledNumber < (MAX_LED_NUMBER + 1); ledNumber++ )
    {
    blinkOneLed(WhutBoardLedPortPinArrayPointerArray, ledNumber, \
    onTime, offTime, repeatCount);
    }
    */
}

// ***********************************************************************
// End
// ***********************************************************************

Fong Blink 2013aug2404 build notes

// ***********************************************************************
// Program  - Test LPC1114
// Function - Test LPC1114
// Author   - TL Fong
// Build    - 2013.08.24.03
// Date     - 2013aug24hkt2102
// Hardware - LPC1114/102, LPC1114/301
// Software - GCC ARM 4.7, CoIDE 1.7.4,  CoLinkEx 1.1, Flash Magic v7.51
// ***********************************************************************

#include "blink031.h"
#include "blink032.h"

// ***********************************************************************
// Functions
// ***********************************************************************

void blinkLedP18();
void blinkLedP09();
void blinkAllLed();

// ***********************************************************************
// Main Function
// ***********************************************************************

int main()
{
blinkLedP18(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_2_TIMES);
blinkLedP09(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_2_TIMES);
blinkAllLed(ON_ONE_FIFTH_SECOND, OFF_ONE_FIFTH_SECOND, REPEAT_2_TIMES);

  return 0;
}

// ***********************************************************************
// End
// ***********************************************************************




// ***********************************************************************
// blink031.h
// ***********************************************************************

#include "config031.h"
#include "delay031.h"
#include "gpio031.h"

void blinkLedP18(int onTime, int offTime, int repeatCount)
{
 // systemInitialization();
 setPio18Direction(OUTPUT_DIRECTION);

  int i;
 for (i = 0; i < repeatCount; i++)
 {
  setPio18Output(HIGH_LEVEL);
  delayTime(onTime);

   setPio18Output(LOW_LEVEL);
  delayTime(offTime);
 }
}

void blinkLedP09(int onTime, int offTime, int repeatCount)
{
 // systemInitialization();
 setPio09Direction(OUTPUT_DIRECTION);

  int i;
 for (i = 0; i < repeatCount; i++)
 {
  setPio09Output(HIGH_LEVEL);
  delayTime(onTime);

   setPio09Output(LOW_LEVEL);
  delayTime(offTime);
 }
}

// ***********************************************************************
// End
// ***********************************************************************




// ***********************************************************************
// blink032.h
// ***********************************************************************

#include "config031.h"
#include "delay031.h"
#include "gpio032.h"

// ***********************************************************************
// Blink LED functions
// ***********************************************************************

// ***********************************************************************
// Function - initialize all LED port pins
// Input    - ledPortPinArrayPointerArray
// Output   - none
// ***********************************************************************

void initializeAllLed(portPinArrayPointerArray ledPortPinArrayPointerArray, int maxLedNumber)
{
  int ledNumber;

  for (ledNumber = 1; ledNumber < (maxLedNumber + 1); ledNumber++) // Caution!!! ledNumber starts 1, not 0 !!!
  {
   initializeLedPin(ledPortPinArrayPointerArray, ledNumber);
  }
}

// ***********************************************************************
// Function - Blink 1 LED
// Input    - PortPinArrayPointerArray, device number, on time, off time,
//            blink repetition times
// Output   - none
// ***********************************************************************

void blinkOneLed(portPinArrayPointerArray portPinArrayPointerArray, \
  deviceNumber ledNumber, int onTime, int offTime, int blinkCount)
{
int count = 0;
int portNumber = 0;
int pinNumber = 0;
GPIO_TypeDef *gpio_struct_ptr;
portPinArray *portPinArrayPointer;

portPinArrayPointer = portPinArrayPointerArray[ledNumber - 1];

   portNumber = getPortNumber(*portPinArrayPointer);
   pinNumber = getPinNumber(*portPinArrayPointer);
   gpio_struct_ptr = getGpioStructPointer(portNumber);

   for (count = 0; count < blinkCount; count++)
   {
  setGpioDataPinHigh(gpio_struct_ptr, pinNumber);
  delayTenthSecond(onTime);
  setGpioDataPinLow(gpio_struct_ptr, pinNumber);
  delayTenthSecond(offTime);
   }
}

// ***********************************************************************
// Function - Blink all LEDs
// Input    - PortPinArrayPointerArray, device number, on time, off time,
//            blink repetition times
// Output   - none
// ***********************************************************************

void blinkAllLed(int onTime, int offTime, int repeatCount)
{

int ledNumber;

  initializeAllLed(WhutBoardLedPortPinArrayPointerArray, MAX_LED_NUMBER);

    for (ledNumber = 1; ledNumber < (MAX_LED_NUMBER + 1); ledNumber++ )
    {
     blinkOneLed(WhutBoardLedPortPinArrayPointerArray, ledNumber, \
    onTime, offTime, repeatCount);
    }
}

// ***********************************************************************
// End
// ***********************************************************************




// ***********************************************************************
// * config031.h *
// ***********************************************************************

#include "lpc11xx_syscon.h"
#include "lpc11xx_gpio.h"
#include "lpc11xx_iocon.h"
#include "lpc11xx_uart.h"

#ifndef CONFIG_HEADER_SEEN
#define CONFIG_HEADER_SEEN

// ***********************************************************************
// * Logic voltage level, IO direction *
// ***********************************************************************

#define LOW 0
#define HIGH 1

#define LOW_LEVEL 0
#define HIGH_LEVEL 1

#define LOGIC_LOW_LEVEL 0
#define LOGIC_HIGH_LEVEL 1

// ***********************************************************************
// * GPIO Direction *
// ***********************************************************************

#define INPUT_DIRECTION 0
#define OUTPUT_DIRECTION 1

// ***********************************************************************
// * Delay tenth seconds *
// ***********************************************************************

#define ONE_FIFTH_SECOND  2
#define ONE_HALF_SECOND   5
#define ONE_SECOND       10

#define ON_ONE_FIFTH_SECOND   2
#define OFF_ONE_FIFTH_SECOND  2
#define ON_ONE_HALF_SECOND    5
#define OFF_ONE_HALF_SECOND   5
#define ON_ONE_SECOND        10
#define OFF_ONE_SECOND       10

// ***********************************************************************
// * Repeat times *
// ***********************************************************************

#define REPEAT_1_TIME 1
#define REPEAT_2_TIMES 2
#define REPEAT_3_TIMES 3
#define REPEAT_4_TIMES 4
#define REPEAT_5_TIMES 5
#define REPEAT_6_TIMES 6
#define REPEAT_8_TIMES 8
#define REPEAT_10_TIMES 10
#define REPEAT_20_TIMES 20

// *** GPIO port number, pin number, port/pin number ***

#define PORT0 0
#define PORT1 1
#define PORT2 2
#define PORT3 3

#define PIN0 0
#define PIN1 1
#define PIN2 2
#define PIN3 3
#define PIN4 4
#define PIN5 5
#define PIN6 6
#define PIN7 7
#define PIN8 8
#define PIN9 9
#define PIN10 10
#define PIN11 11

typedef int portNumber;
portNumber Port0 = 0;
portNumber Port1 = 1;
portNumber Port2 = 2;
portNumber Port3 = 3;

typedef int pinNumber;
pinNumber Pin0  =  0;
pinNumber Pin1  =  1;
pinNumber Pin2  =  2;
pinNumber Pin3  =  3;
pinNumber Pin4  =  4;
pinNumber Pin5  =  5;
pinNumber Pin6  =  6;
pinNumber Pin7  =  7;
pinNumber Pin8  =  8;
pinNumber Pin9  =  9;
pinNumber Pin10 = 10;
pinNumber Pin11 = 11;

typedef const int portPinNumber;

portPinNumber Pio05  = 5;
portPinNumber Pio08  = 8;
portPinNumber Pio09  = 9;

portPinNumber Rpio11 = 11;
portPinNumber Rpio12 = 12;
portPinNumber Pio19  = 19;
portPinNumber Rpio18 = 18;
portPinNumber Pio110  = 110;

// *** system timer number, match register number ***

typedef const int timerNumber;
timerNumber Ct16b0 = 0;
timerNumber Ct16b1 = 1;
timerNumber Ct32b0 = 2;
timerNumber Ct32b1 = 3;

typedef const int matchRegisterNumber;
matchRegisterNumber MatchRegister0 = 0;
matchRegisterNumber MatchRegister1 = 1;
matchRegisterNumber MatchRegister2 = 2;

typedef const int deviceNumber;

#define LED1 1
#define LED2 2
#define LED3 3
#define LED4 4
#define LED5 5

#define MAX_DEVICE_NUMBER 2
#define MAX_LED_NUMBER    5
#define MAX_KEY_NUMBER    2
#define MAX_PWM_NUMBER    2

// *** Port pin array typedef and declaration ***

// ***********************************************************************
// typedef portPinArray[]
// Description - this array denotes a GPIO port pin.  It has two elements,
//   portNumber and pinNumber
// **********************************************************************

typedef int portPinArray[2];

typedef int portPinArrayIndex;
portPinArrayIndex PortIndex = 0;
portPinArrayIndex PinIndex  = 1;


// ***********************************************************************
// WHUT LP!1114 Evaluation Board configuration
// ***********************************************************************

const int MaxBoardDeviceNumber =  5;
const int MaxBoardLedNumber = 5;
const int MaxBoardKeyNumber = 3;
const int MaxBoardPwmNumber = 5;

portPinArray WhutBoardLedPortPinArray1 = {PORT1, PIN8};  // LED D1
portPinArray WhutBoardLedPortPinArray2 = {PORT1, PIN9};  // LED D2
portPinArray WhutBoardLedPortPinArray3 = {PORT1, PIN10}; // LED D3
portPinArray WhutBoardLedPortPinArray4 = {PORT1, PIN11}; // LED D4
portPinArray WhutBoardLedPortPinArray5 = {PORT0, PIN9};  // JTAG pin13

#define SCLK_INDEX 0
#define DIN_INDEX 1
#define LATCH_INDEX 2

portPinArray WhutBoardSevenSegmentLedPortPinArraySclk = {PORT2, PIN1}; // Serial Clock
portPinArray WhutBoardSevenSegmentLedPortPinArrayDin = {PORT2, PIN3}; // Data in
portPinArray WhutBoardSevenSegmentLedPortPinArrayLatch = {PORT2, PIN0}; // Latch

// ***********************************************************************
// typedef portPinArrayPointerArray
// Description - Array pointers to pin array
// **********************************************************************

typedef portPinArray *portPinArrayPointerArray[MAX_DEVICE_NUMBER];

#define WHUT_MAX_LED_PIN_NUMBER 5

portPinArrayPointerArray WhutBoardLedPortPinArrayPointerArray[WHUT_MAX_LED_PIN_NUMBER] = \
  {&WhutBoardLedPortPinArray1, &WhutBoardLedPortPinArray2, \
  &WhutBoardLedPortPinArray3, &WhutBoardLedPortPinArray4, \
  &WhutBoardLedPortPinArray5};

#define WHUT_MAX_7_SEG_LED_PIN_NUMBER 3

portPinArrayPointerArray WhutBoardSevenSegmentLedPortPinArrayPointerArray[WHUT_MAX_7_SEG_LED_PIN_NUMBER] = \
  {&WhutBoardSevenSegmentLedPortPinArraySclk, &WhutBoardSevenSegmentLedPortPinArrayDin, \
       &WhutBoardSevenSegmentLedPortPinArrayLatch};

// ***********************************************************************
// typedef mcuBoardStruct (To test later)
// Description - MCU Board struct with LEDs, Keys, and PWMs
// **********************************************************************

typedef struct
 {
 portPinArrayPointerArray *LedPortPinArrayPointerArray;
 portPinArrayPointerArray *KeyPortPinArrayPointerArray;
 portPinArrayPointerArray *PwmPortPinArrayPointerArray;
 } mcuBoardStruct;


mcuBoardStruct *CreateDingBoardBoardStruct() // To be tested
 {
 mcuBoardStruct *FongBoardStruct;

   // DingBoardStruct->LedPortPinArrayPointerArray = FongBoardLedList1;
  // DingBoardStruct->KeyPortPinArrayPointerArray = FongBoardKeyList1;
  // DingBoardStruct->PwmPortPinArrayPointerArray = FongBoardPwmList1;

  return FongBoardStruct;
 }

void blinkAllLed02()
{
 systemInitialization();

  testBlinkAllLeds();
}

void FongSevenSegmentLed01()
{
 systemInitialization();

  testBlinkAllLeds();

  testSevenSegmentLed();
}

// * typedefs of logic level and IO direction *

#define PORT_INDEX 0
#define PIN_INDEX 1

typedef int logicLevelValue;

logicLevelValue LogicLevelLow = 0;
logicLevelValue LogicLevelHigh = 1;

typedef int directionValue;

directionValue InputDirection = 0;
directionValue OutputDirection = 1;

// ***********************************************************************
// typedef GPIO_TypeDef *gpioStructPointerArray[4];
// Description - CMSIS declares 4 struct pointers LPC_GPIO0, LPC_GPIO1,
// LPC_GPIO2, LPC_GPIO3 for the 4 structs each of which controls
// one port of up to 11 pins.
// ***********************************************************************

typedef GPIO_TypeDef *gpioStructPointerArray[4];
gpioStructPointerArray CmsisGpioStructPointerArray = {LPC_GPIO0, LPC_GPIO1, LPC_GPIO2, LPC_GPIO3};

#endif /* CONFIG_HEADER_SEEN */

// ***********************************************************************
// * End *
// ***********************************************************************




// ***********************************************************************
// delay031.h
// ***********************************************************************
// ***********************************************************************
// Name   - delayTenthSecond()
// Input  - tenth second count
// Output - none
// ***********************************************************************

#ifndef DELAY_HEADER_SEEN
#define DELAY_HEADER_SEEN

void delayTenthSecond(int count)
{
 int i, j, k;
 for (i = 0; i < count; i++)
 {
  for (j = 0; j < 0x4; j++)
     {
         for (k = 0; k < 0x000BB00; k++)
         {
         }
     }
 }
}

void delayTime(int count)
{
 delayTenthSecond(count);
}

#endif /* DELAY_HEADER_SEEN */

// ***********************************************************************
// * End *
// ***********************************************************************




// ***********************************************************************
// gpio031.h
// ***********************************************************************

#include "lpc11xx_syscon.h"
#include "lpc11xx_gpio.h"
#include "lpc11xx_iocon.h"
#include "lpc11xx_uart.h"

#include "config031.h"
#include "delay031.h"

// ***********************************************************************
// *** PIO1_8, PIO0_9 functions ***
// ***********************************************************************

// *** PIO1_8 ***

void setPio18Direction(int direction)
{
 /* Set pin to GPIO */
 IOCON_SetPinFunc(IOCON_PIO1_8, PIO1_8_FUN_PIO);

  /* Set pin direction */
 if (direction == OUTPUT_DIRECTION)
  GPIO_SetDir(PORT1, GPIO_Pin_8, 1);
 else
  GPIO_SetDir(PORT1, GPIO_Pin_8, 0);
}

void setPio18OutputHigh()
{
 GPIO_SetBits(PORT1, GPIO_Pin_8);
}

void setPio18OutputLow()
{
 GPIO_ResetBits(PORT1, GPIO_Pin_8);
}

void setPio18Output(int logicLevel)
{
 if (logicLevel == HIGH_LEVEL)
  GPIO_SetBits(PORT1, GPIO_Pin_8);
 else
  GPIO_ResetBits(PORT1, GPIO_Pin_8);
}

// *** PIO0_9 ***

void setPio09Direction(int direction)
{
 /* Set pin to GPIO */
 IOCON_SetPinFunc(IOCON_PIO0_9, PIO0_9_FUN_PIO);

  /* Set pin direction */
 if (direction == OUTPUT_DIRECTION)
  GPIO_SetDir(PORT0, GPIO_Pin_9, 1);
 else
  GPIO_SetDir(PORT0, GPIO_Pin_9, 0);
}

void setPio09OutputHigh()
{
 GPIO_SetBits(PORT0, GPIO_Pin_9);
}

void setPio09OutputLow()
{
 GPIO_ResetBits(PORT0, GPIO_Pin_9);
}

// ***********************************************************************
// *** blink P18, P09 LEDs ***
// ***********************************************************************

void setPio09Output(int logicLevel)
{
 if (logicLevel == HIGH_LEVEL)
  GPIO_SetBits(PORT0, GPIO_Pin_9);
 else
  GPIO_ResetBits(PORT0, GPIO_Pin_9);
}

// ***********************************************************************
// End
// ***********************************************************************




// ***********************************************************************
// gpio032.h
// ***********************************************************************

// ***********************************************************************
// Program  - Fong Seven Segment LED
// Function - Display 7 segment LED
// Author   - TL Fong
// Build    - 2013.08.23.02
// Date     - 2013aug23hkt1750
// Hardware - LPC1114/301, LPC1114/102,
// Software - GCC ARM 4.7, CoIDE 1.7.4,  CoLinkEx 1.1, Flash Magic v7.51
// ***********************************************************************

#include "lpc11xx_syscon.h"
#include "lpc11xx_gpio.h"
#include "lpc11xx_iocon.h"
#include "lpc11xx_uart.h"

#include "config031.h"
#include "delay031.h"

// ***********************************************************************
// Function List
// ***********************************************************************

void systemInitialization();
void delayTenthSecond(int count);

// ***********************************************************************
// System initialization functions
// ***********************************************************************

void systemInitialization() // CooCox code
{
 /* Enable GPIO block clock */
 SYSCON_AHBPeriphClockCmd(SYSCON_AHBPeriph_GPIO, ENABLE);
}

// ***********************************************************************
// GPIO functions
// ***********************************************************************

// ***********************************************************************
// Name   - getGpioStructPointer()
// Input  - port number
// Output - pointer to the struct of the port
// ***********************************************************************

GPIO_TypeDef *getGpioStructPointer(int portNumber)
{
 GPIO_TypeDef *gpioStructPointer;
 gpioStructPointer =  CmsisGpioStructPointerArray[portNumber];
 return gpioStructPointer;
}

// ***********************************************************************
// typedef gpioPortStructPinStruct;
// Description - this struct has 2 members: *GpioStructPointer and pin
//   pin number. This struct is not yet being used.
// ***********************************************************************

typedef struct
{
 GPIO_TypeDef *GpioStructPointer;
 int PinNumber;
} gpioPortStructPinStruct;

// ***********************************************************************
// Name   - getGpioPortStructPinStructPointer() // To be tested
// Input  - port number, pin number
// Output - pointer to gpioPortStructPinStruct
// ***********************************************************************

gpioPortStructPinStruct *getGpioPortStructPinStructPointer(portNumber portNumber, pinNumber pinNumber)
  {
 gpioPortStructPinStruct *gpioPortStructPinStruct;
 gpioPortStructPinStruct->GpioStructPointer = getGpioStructPointer(portNumber);
 gpioPortStructPinStruct->PinNumber = pinNumber;
 return gpioPortStructPinStruct;
  }

// ***********************************************************************
// GPIO functions
// ***********************************************************************

// ***********************************************************************
// Name   - setGpioDataPinInput()
// Input  - gpio_struct_ptr, pin number
// Output - none
// ***********************************************************************

void setGpioDataPinInput(GPIO_TypeDef *gpio_struct_ptr, int pinNumber)
{
 gpio_struct_ptr->DIR  &= ~(1 << pinNumber);
}

// ***********************************************************************
// Name   - setGpioDataPinOutput
// Input  - port control structure, pin number
// Output - set pin as output
// ***********************************************************************

void setGpioDataPinOutput(GPIO_TypeDef *gpio_struct_ptr, int pinNumber)
{
 gpio_struct_ptr->DIR |= (1 << pinNumber);
}

// ***********************************************************************
// Name   - setGpioDataPinLow
// Input  - port control structure, pin number
// Output - none
// ***********************************************************************

void setGpioDataPinLow(GPIO_TypeDef *gpio_struct_ptr, int pinNumber)
{
 gpio_struct_ptr->DATA &= ~(1 << pinNumber);
}

// ***********************************************************************
// Name   - setGpioDataPinHigh
// Input  - port control structure, pin number
// Output - set pin as output
// ***********************************************************************

void setGpioDataPinHigh(GPIO_TypeDef *gpio_struct_ptr, int pinNumber)
{
 gpio_struct_ptr->DATA |= (1 << pinNumber);
}

// ***********************************************************************
// Name   - setGpioDataPinDirection
// Input  - port control structure, pin number, direction value
// Output - set pin as input or output
// ***********************************************************************

void setGpioPinDirection(GPIO_TypeDef *gpio_struct_ptr, int pinNumber, directionValue directionValue)
{
 if (directionValue == INPUT_DIRECTION)
  setGpioDataPinInput(gpio_struct_ptr, pinNumber);
 else
  setGpioDataPinOutput(gpio_struct_ptr, pinNumber);
}

// ***********************************************************************
// Name   - setGpioDataRegister
// Input  - port control structure, pin number, data value
// Output - none
// ***********************************************************************

void setGpioDataPin(GPIO_TypeDef *gpio_struct_ptr, int pinNumber, logicLevelValue logicLevelValue)
{
 if (logicLevelValue == LOGIC_LOW_LEVEL)
  setGpioDataPinLow(gpio_struct_ptr, pinNumber);
 else
  setGpioDataPinHigh(gpio_struct_ptr, pinNumber);
}

// ***********************************************************************
// Function - getGpioDataPinValue
// Input    - GPIO structure pointer, pin number
// Output   - Gpio data pin value
// ***********************************************************************

logicLevelValue getGpioDataPinValue(GPIO_TypeDef *gpio_struct_ptr, int pinNumber)
{
 logicLevelValue logicLevelValue;

  int GpioDataPinMask = (1 << pinNumber);

  if ((gpio_struct_ptr->DATA  &= GpioDataPinMask) == GpioDataPinMask)
  logicLevelValue = HIGH;
 else
  logicLevelValue = LOW;

  return logicLevelValue;
}

// ***********************************************************************
// Name   - get port number of portPinArray
// Input  - port pin array
// Output - portNumber
// ***********************************************************************

portNumber getPortNumber(portPinArray portPinArray)
{
 int portNumber;
 portNumber = portPinArray[PORT_INDEX];
 return portNumber;
}

// ***********************************************************************
// Name   - get port number from portPinArrayPointerArray
// Input  - portPinPointerArray, deviceNumber
// Output - portNumber
// ***********************************************************************

portNumber getPortNumber01(portPinArrayPointerArray portPinArrayPointerArray, deviceNumber deviceNumber)
{
 int portNumber;
 portNumber = getPortNumber(*portPinArrayPointerArray[deviceNumber - 1]);
 return portNumber;
}

// ***********************************************************************
// Name   - get pin number of portPinArray
// Input  - port pin array
// Output - pinNumber
// ***********************************************************************

pinNumber getPinNumber(portPinArray portPinArray)
{
 int pinNumber;
 pinNumber = portPinArray[PIN_INDEX];
 return pinNumber;
}

// ***********************************************************************
// Name   - get pin number from portPinArrayPointerArray and index
// Input  - portPinPointerArray, index
// Output - pinNumber
// ***********************************************************************

pinNumber getPinNumber01(portPinArrayPointerArray portPinArrayPointerArray, deviceNumber deviceNumber)
{
 int pinNumber;
 pinNumber = getPinNumber(*portPinArrayPointerArray[deviceNumber - 1]);
 return pinNumber;
}

// ***********************************************************************
// LED Functions
// ***********************************************************************

// ***********************************************************************
// Name   - initialize LED port pin
// Input  - portPinPointerArray, index
// Output - none
// ***********************************************************************

void initializeLedPin(portPinArrayPointerArray portPinArrayPointerArray, deviceNumber ledNumber)
{
 int portNumber;
 int pinNumber;
 GPIO_TypeDef *gpioStructPointer;

  portNumber = getPortNumber01(portPinArrayPointerArray, ledNumber);
 pinNumber = getPinNumber01(portPinArrayPointerArray, ledNumber);
 gpioStructPointer = getGpioStructPointer(portNumber);

  // *** the 3 lines below are not working, don't know why - tlfong01 2013aug17 ***
 // gpioPortStructPinStruct *gpioPortStructPinStructPointer;
 // gpioPortStructPinStructPointer = getGpioPortStructPinStructPointer(portNumber, pinNumber);
 // gpioStructPointer = gpioPortStructPinStructPointer -> GpioStructPointer;

  setGpioDataPinOutput(gpioStructPointer, pinNumber);
 setGpioDataPinLow (gpioStructPointer, pinNumber);
  }

// ***********************************************************************
// End
// ***********************************************************************