max7219 function refactoring notes

// ***************************************************************************
// Program  - Fong EKG v5.09
// Function - Testing Olimex EKG
// Author   - TL Fong
// Build    - 2013.11.21.01
// Date     - 2013nov21hkt1451
// Hardware - WuyinS/Olimex/CooCox/MagicBlue/WHUT/Somy LPC1114/C14/301
//            Olimex EKG/EMG R.B 2011
// Software - CoIDE 1.7.5, CoLinkEx 1.1, Flash Magic v7.66, GCC ARM 4.7
// **************************************************************************

#include "test050.h"

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

int main()
{
testMax7219V090();
}

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

// ***********************************************************************
// test050.h 2013nov21hkt2222
// ***********************************************************************

#include "led050.h"
#include "key050.h"
#include "spi050.h"
#include "adc050.h"
#include "eeprom050.h"
#include "spi080.h"
#include "mled080.h"


void testMax7219V090()
{
testMax7219V0901();
}

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

// ***********************************************************************
// mled080.h 2013nov24hkt2229
// ***********************************************************************

// #include "spi050.h"

// *** MAX7219 Register Addresses ***
#define NO_OP_ADDR 0x00
#define DIGIT_ADDR_0 0x01
#define DIGIT_ADDR_1 0x02
#define DIGIT_ADDR_2 0x03
#define DIGIT_ADDR_3 0x04
#define DIGIT_ADDR_4 0x05
#define DIGIT_ADDR_5 0x06
#define DIGIT_ADDR_6 0x07
#define DIGIT_ADDR_7 0x08
#define DECODE_MODE_ADDR 0x09
#define INTENSITY_ADDR     0x0a
#define SCAN_LIMIT_ADDR 0x0b
#define OPERATION_ADDR   0x0c // Shutdown address actually
#define DISPLAY_TEST_ADDR   0x0f

// *** MAX7219 Commands ***
#define SHUT_DOWN              0x00
#define NORMAL                 0x01
#define CODE_B_ALL_DIGITS      0xff
#define NO_DECODE_ALL_DIGITS   0x00
#define DECODE_ALL_8_DIGITS    0xff
#define NO_DECODE_ALL_8_DIGITS 0x00
#define NO_DECODE_ALL_8_ROWS   0x00
#define DISPLAY_8_DIGITS       0x07
#define SCAN_ALL_8_DIGITS      0x07
#define SCAN_ALL_8_ROWS        0x07

// *** Data Constants ***

#define MATRIX_0 0
#define MATRIX_1 1
#define MATRIX_2 2
#define MATRIX_3 3
#define MATRIX_4 4
#define MATRIX_5 5
#define MATRIX_6 6

#define DIGIT_0 0
#define DIGIT_1 1
#define DIGIT_2 2
#define DIGIT_3 3
#define DIGIT_4 4
#define DIGIT_5 5
#define DIGIT_6 6
#define DIGIT_7 7
#define DIGIT_8 8
#define DIGIT_9 9
#define CHAR_HYPHEN 10
#define CHAR_E 11
#define CHAR_H 12
#define CHAR_L 13
#define CHAR_P 14
#define CHAR_BLANK 15

#define PATTERN_ALL_ON 0xff
#define PATTERN_ALL_OFF 0x00

#define ADDRESS_INDEX 0
#define DATA_INDEX 1

#define MAX_MATRIX_NUMBER 16
#define MAX_BUFFER_SIZE 32

uint8_t char_A[5] = {0x7E, 0x11, 0x11, 0x11, 0x7E};
uint8_t char_K[5] = {0x41, 0x22, 0x14, 0x08, 0x7f};
uint8_t char_O[5] = {0x3E, 0x41, 0x41, 0x41, 0x3E};

uint8_t MatrixChar_A[5] = {0x7E, 0x11, 0x11, 0x11, 0x7E};
uint8_t MatrixChar_K[5] = {0x41, 0x22, 0x14, 0x08, 0x7f};
uint8_t MatrixChar_O[5] = {0x3E, 0x41, 0x41, 0x41, 0x3E};

uint8_t TriGram0[8] = {0x54, 0x54, 0x54, 0x00, 0x54, 0x54, 0x54, 0x00};

// ***************************************************************************
// MAx7219 Functions
// ***************************************************************************

void displayMax7219EightDigitV090(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                     uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                     uint8_t digit1, uint8_t digit2, uint8_t digit3, uint8_t digit4, \
                     uint8_t digit5, uint8_t digit6, uint8_t digit7, uint8_t digit8)
{
// *** Set up all SPI channels and SPI slave select ports ***
setupAllSpiChannelsAndSlaveSelectPorts(portPinArraryPointerArrayArray);

    // *** Display 8 digits ***
printf("\n\n*** test Max7219 - 2013nov22 ***\n\n");
setupAndDisplayMax7219EightDigitsV080(portPinArraryPointerArrayArray, \
                        spiChannelNumber, slaveSelectNumber, \
                                     digit1, digit2, digit3, digit4, \
                                     digit5, digit6, digit7, digit8);
printf("\n*** End of test ***\n");
}

void setupAndDisplayMax7219EightDigitsV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                       uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                                uint8_t digit1, uint8_t digit2, uint8_t digit3, uint8_t digit4, \
                                uint8_t digit5, uint8_t digit6, uint8_t digit7, uint8_t digit8)
{
setupMax7219DigitModeV080(portPinArraryPointerArrayArray, \
                 spiChannelNumber, slaveSelectNumber);

    displayMax7219EightDigitsV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, MATRIX_1, digit1, digit2, \
               digit3, digit4, digit5, digit6, digit7, digit8);
}

void setupMax7219DigitModeV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, SHUT_DOWN);
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, DECODE_MODE_ADDR, DECODE_ALL_8_DIGITS);
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, SCAN_LIMIT_ADDR, SCAN_ALL_8_DIGITS);
}

void setupMax7219PositionDigitModeV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, uint8_t positionNumber)
{
writeMax7219PositionCommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, SHUT_DOWN, positionNumber);
writeMax7219PositionCommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, DECODE_MODE_ADDR, DECODE_ALL_8_DIGITS, positionNumber);
writeMax7219PositionCommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, SCAN_LIMIT_ADDR, SCAN_ALL_8_DIGITS, positionNumber);
}

void displayMax7219EightDigitsV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, uint8_t ledDriverNumber, \
           uint8_t digit1, uint8_t digit2, uint8_t digit3, uint8_t digit4, \
           uint8_t digit5, uint8_t digit6, uint8_t digit7, uint8_t digit8)
{
shutDownMax7219V080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, ledDriverNumber);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_7, digit1);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_6, digit2);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_5, digit3);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_4, digit4);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_3, digit5);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_2, digit6);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_1, digit7);
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber, DIGIT_ADDR_0, digit8);
    startUpMax7219V080(portPinArraryPointerArrayArray, \
    spiChannelNumber, slaveSelectNumber, ledDriverNumber);
}

void displayMax7219OneDigitV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
               uint8_t deviceNumber, uint8_t digitAddress, uint8_t digitData)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, digitAddress, digitData);
}

void writeMax7219CommandV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                    uint8_t commandRegisterAddress, uint8_t command)
{
uint8_t txBuffer[2];
uint8_t rxBuffer[2];

SSP_DATA_SETUP_Type xferConfig;
    xferConfig.tx_data = txBuffer;
    xferConfig.rx_data = rxBuffer;
    xferConfig.length =  2;

    txBuffer[ADDRESS_INDEX] = commandRegisterAddress;
txBuffer[DATA_INDEX] = command;

    spiTransmit082(portPinArraryPointerArrayArray, spiChannelNumber, slaveSelectNumber, xferConfig);
}

void writeMax7219CommandV0803(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                     uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                     uint8_t matrixNumber, \
                     uint8_t commandRegisterAddress, uint8_t command)
{
uint8_t txBuffer[MAX_BUFFER_SIZE];
uint8_t rxBuffer[MAX_BUFFER_SIZE];

SSP_DATA_SETUP_Type xferConfig;
    xferConfig.tx_data = txBuffer;
    xferConfig.rx_data = rxBuffer;
    xferConfig.length =  2 * (matrixNumber +1);

    txBuffer[ADDRESS_INDEX] = commandRegisterAddress;
txBuffer[DATA_INDEX] = command;

int i;
for (i = 1; i < matrixNumber; i++)
{
   txBuffer[(i * 2) + ADDRESS_INDEX] = NO_OP_ADDR;
}

    spiTransmit082(portPinArraryPointerArrayArray, spiChannelNumber, slaveSelectNumber, xferConfig);
}

void shutDownMax7219V080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, SHUT_DOWN);
}

void startUpMax7219V080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, NORMAL);
}

void shutDownMax7219V0803(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, uint8_t matrixNumber)
{
writeMax7219CommandV0803(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, matrixNumber, OPERATION_ADDR, SHUT_DOWN);
}

void startUpMax7219V0803(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, uint8_t matrixNumber)
{
writeMax7219CommandV0803(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, matrixNumber, OPERATION_ADDR, NORMAL);
}

// *** Matrix mode ***********************************************************

void setupMax7219MatrixModeV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, SHUT_DOWN);
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, DECODE_MODE_ADDR, NO_DECODE_ALL_DIGITS); // No decode
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, SCAN_LIMIT_ADDR, SCAN_ALL_8_DIGITS);

}

void setupMax7219MatrixModeV090(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, uint8_t matrixNumber)
{
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, OPERATION_ADDR, SHUT_DOWN);
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, DECODE_MODE_ADDR, NO_DECODE_ALL_DIGITS); // No decode
writeMax7219CommandV080(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, SCAN_LIMIT_ADDR, SCAN_ALL_8_DIGITS);
}

void setupAndDisplayMax7219MatrixV080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                       uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                                uint8_t matrixColumn[])
{
setupMax7219MatrixModeV080(portPinArraryPointerArrayArray, \
                 spiChannelNumber, slaveSelectNumber);

displayMax7219OneMatrix080(portPinArraryPointerArrayArray, \
                               spiChannelNumber, slaveSelectNumber, \
                  matrixColumn);
}

void displayMax7219OneMatrix0803(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                       uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                       uint8_t matrixNumber, uint8_t matrixColumn[8])
{
shutDownMax7219V0803(portPinArraryPointerArrayArray, \
           spiChannelNumber, slaveSelectNumber, matrixNumber);

uint8_t columnNumber;
uint8_t digitAddress;

for (columnNumber = 0; columnNumber < 8; columnNumber++)
{
digitAddress = columnNumber + 1;
displayMax7219OneMatrixColumnV0803(portPinArraryPointerArrayArray, \
                  spiChannelNumber, slaveSelectNumber, \
                          matrixNumber, digitAddress,  matrixColumn[7 - columnNumber]);
}

startUpMax7219V0803(portPinArraryPointerArrayArray, \
           spiChannelNumber, slaveSelectNumber, matrixNumber);
}


void displayMax7219OneMatrixColumnV0803(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
               uint8_t matrixNumber, uint8_t digitAddress, uint8_t digitData)
{
writeMax7219CommandV0803(portPinArraryPointerArrayArray, \
spiChannelNumber, slaveSelectNumber, matrixNumber, digitAddress, digitData);
}


void displayMax7219OneMatrix080(portPinArrayPointerArray portPinArraryPointerArrayArray[], \
                       uint8_t spiChannelNumber, uint8_t slaveSelectNumber, \
                       uint8_t matrixColumn[8])
{
shutDownMax7219V080(portPinArraryPointerArrayArray, \
           spiChannelNumber, slaveSelectNumber);

uint8_t columnNumber;
uint8_t digitAddress;

for (columnNumber = 0; columnNumber < 8; columnNumber++)
{
digitAddress = columnNumber + 1;
displayMax7219OneDigitV080(portPinArraryPointerArrayArray, \
                  spiChannelNumber, slaveSelectNumber, \
                          0, digitAddress,  matrixColumn[7 - columnNumber]);
}

startUpMax7219V080(portPinArraryPointerArrayArray, \
           spiChannelNumber, slaveSelectNumber);
}

// ***************************************************************************
// Test function
// ***************************************************************************
void testMax7219V0901()
{
// *** Set up all SPI channels and SPI slave select ports ***
setupAllSpiChannelsAndSlaveSelectPorts(Olimex20SlaveSelectPortPinArrayPointerArrayArray);

// *** Set up Max7219 digit mode for SPI 0,1, 0,2, 0,3, 0,4 ***
setupMax7219DigitModeV080(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                 SPI_CHANNEL_0, SLAVE_SELECT_0);
setupMax7219DigitModeV080(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                 SPI_CHANNEL_0, SLAVE_SELECT_1);
setupMax7219DigitModeV080(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                 SPI_CHANNEL_0, SLAVE_SELECT_2);
setupMax7219DigitModeV080(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                 SPI_CHANNEL_0, SLAVE_SELECT_3);
setupMax7219DigitModeV080(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                 SPI_CHANNEL_0, SLAVE_SELECT_4);

// *** Set up Max7219 matrix mode for SPI 0,5 Matrix #1 and Matrix #2 ***
setupMax7219MatrixModeV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                               SPI_CHANNEL_0, SLAVE_SELECT_5, MATRIX_0);
setupMax7219MatrixModeV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                               SPI_CHANNEL_0, SLAVE_SELECT_5, MATRIX_1);

// *** Display 8 digits for SPI 0,1 to 0,4 ***
displayMax7219EightDigitV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
   SPI_CHANNEL_0, SLAVE_SELECT_0, 9, 0, 0, 0, 0, 0, 0, 0);

displayMax7219EightDigitV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
   SPI_CHANNEL_0, SLAVE_SELECT_1, 9, 0, 0, 0, 0, 0, 0, 1);

displayMax7219EightDigitV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
   SPI_CHANNEL_0, SLAVE_SELECT_2, 9, 0, 0, 0, 0, 0, 0, 2);

displayMax7219EightDigitV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
   SPI_CHANNEL_0, SLAVE_SELECT_3, 9, 0, 0, 0, 0, 0, 0, 3);

displayMax7219EightDigitV090(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
   SPI_CHANNEL_0, SLAVE_SELECT_4, 9, 0, 0, 0, 0, 0, 0, 4);

// *** Display matrix for for SPI 0,5 Matrix #1 and #2 ***
displayMax7219OneMatrix0803(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                                SPI_CHANNEL_0, SLAVE_SELECT_5, \
                                MATRIX_0, MatrixChar_O);

displayMax7219OneMatrix0803(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                                SPI_CHANNEL_0, SLAVE_SELECT_5, \
                                MATRIX_1, MatrixChar_K);
delayMilliSecond(2000);

// *** Looping display ***
while (1)
    {
displayMax7219OneMatrix0803(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                                SPI_CHANNEL_0, SLAVE_SELECT_5, \
                                MATRIX_0, MatrixChar_O);
delayMilliSecond(1000);

displayMax7219OneMatrix0803(Olimex20SlaveSelectPortPinArrayPointerArrayArray, \
                                SPI_CHANNEL_0, SLAVE_SELECT_5, \
                                MATRIX_0, MatrixChar_K);
delayMilliSecond(1000);
    }
}

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