jct/MAX7456
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Compare commits

base: jct:d9e5a345676b2f2de299e5e843a3806e1487b033
Branches Tags
jct:master
..
compare: jct:7ce4779101b12ba01d5569a3987411de86bb6fba
Branches Tags
jct:master

No commits in common. "d9e5a345676b2f2de299e5e843a3806e1487b033" and "7ce4779101b12ba01d5569a3987411de86bb6fba" have entirely different histories.
d9e5a34567 ... 7ce4779101

5 changed files with 230 additions and 140 deletions
Show Stats Expand all files Collapse all files

4
examples/Max7456Write/Max7456Write.ino
View File

@ -1416,8 +1416,8 @@ void setup() {
Serial.print(number); Serial.print(number);
Serial.println(F(" of 255")); Serial.println(F(" of 255"));
MAX7456::getCARACFromProgMem(tableOfAllCharacters, i, currentChar); //Because the table is too big for ram memory MAX7456::getCARACFromProgMem(tableOfAllCharacters, i, currentChar); //Because the table is too big for ram memory
MAX7456::printCharacterToSerial(tableOfAllCharacters[i], true);
osd->sendCharacter(currentChar, i); //We send currentChar at address i. osd->sendCharacter(currentChar, i & 0xF0, i & 0xF0); //We send currentChar at address i.
} }
Serial.println(F("---------- DONE! ----------")); Serial.println(F("---------- DONE! ----------"));
Serial.println(F("please unplug your arduino.")); Serial.println(F("please unplug your arduino."));

2
examples/WriteMCM/WriteMCM.ino
View File

@ -74,7 +74,7 @@ void setup()
{ {
byte spi_junk; byte spi_junk;
int x; int x;
Serial.begin(115200); Serial.begin(38400);
Serial.flush(); Serial.flush();
digitalWrite(USBSELECT,HIGH); //disable USB chip digitalWrite(USBSELECT,HIGH); //disable USB chip

222
src/MAX7456.cpp
View File

@ -2,6 +2,7 @@
#include <Arduino.h> #include <Arduino.h>
#include <SPI.h> #include <SPI.h>
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::MAX7456 // Implements MAX7456::MAX7456
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -17,34 +18,35 @@ void MAX7456::setBlinkParams(byte blinkBase, byte blinkDC)
{ {
_regVm1.bits.blinkingTime = blinkBase; _regVm1.bits.blinkingTime = blinkBase;
_regVm1.bits.blinkingDutyCycle = blinkDC; _regVm1.bits.blinkingDutyCycle = blinkDC;
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(VM1_ADDRESS_WRITE); SPI.transfer(VM1_ADDRESS_WRITE);
SPI.transfer(_regVm1.whole); SPI.transfer(_regVm1.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::setDisplayOffsets // Implements MAX7456::setDisplayOffsets
//---------------------------------------------------------------------------- //----------------------------------------------------------------------------
void MAX7456::setDisplayOffsets(byte horizontal, byte vertical) void MAX7456::setDisplayOffsets(byte horizontal, byte vertical)
{ {
_regHos.whole = 0; _regHos.whole = 0;
_regVos.whole = 0; _regVos.whole = 0;
_regHos.bits.horizontalPositionOffset = horizontal; _regHos.bits.horizontalPositionOffset = horizontal;
_regVos.bits.verticalPositionOffset = vertical; _regVos.bits.verticalPositionOffset = vertical;
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(HOS_ADDRESS_WRITE); SPI.transfer(HOS_ADDRESS_WRITE);
SPI.transfer(_regHos.whole); SPI.transfer(_regHos.whole);
SPI.transfer(VOS_ADDRESS_WRITE); SPI.transfer(VOS_ADDRESS_WRITE);
SPI.transfer(_regVos.whole); SPI.transfer(_regVos.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::MAX7456 // Implements MAX7456::MAX7456
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -52,18 +54,24 @@ MAX7456::MAX7456()
{ {
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::sendCharacter // Implements MAX7456::sendCharacter
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::sendCharacter(const charact chara, char address) void MAX7456::sendCharacter(const charact chara, byte x, byte y)
{ {
byte charAddress;
if(y<0)
charAddress = x;
else
charAddress = x + (y<<4);
activateOSD(false); activateOSD(false);
//datasheet p38 //datasheet p38
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(CMAH_ADDRESS_WRITE); SPI.transfer(CMAH_ADDRESS_WRITE);
SPI.transfer(address); SPI.transfer(charAddress);
for (byte i = 0; i < 54; i++) for(byte i = 0 ; i < 54 ; i++)
{ {
SPI.transfer(CMAL_ADDRESS_WRITE); SPI.transfer(CMAL_ADDRESS_WRITE);
SPI.transfer(i); SPI.transfer(i);
@ -76,15 +84,17 @@ void MAX7456::sendCharacter(const charact chara, char address)
SPI.transfer(_regCmm); SPI.transfer(_regCmm);
//while STAT[5] is not good, we wait. //while STAT[5] is not good, we wait.
_regStat.bits.characterMemoryStatus = 1; _regStat.bits.characterMemoryStatus = 1;
while (_regStat.bits.characterMemoryStatus == 1) while( _regStat.bits.characterMemoryStatus ==1)
{ {
SPI.transfer(STAT_ADDRESS_READ); SPI.transfer(STAT_ADDRESS_READ);
_regStat.whole = SPI.transfer(0x00); _regStat.whole = SPI.transfer(0x00);
} }
digitalWrite(_pinCS, HIGH);
digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::getCharacter // Implements MAX7456::getCharacter
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -92,14 +102,16 @@ void MAX7456::getCharacter(charact chara, byte x, byte y)
{ {
byte charAddress; byte charAddress;
if (y <= 0)
if(y<=0)
charAddress = x; charAddress = x;
else else
charAddress = x + y * 16; charAddress = x + y*16;
activateOSD(false); activateOSD(false);
//datasheet p38 //datasheet p38
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(CMAH_ADDRESS_WRITE); SPI.transfer(CMAH_ADDRESS_WRITE);
SPI.transfer(charAddress); SPI.transfer(charAddress);
@ -108,7 +120,8 @@ void MAX7456::getCharacter(charact chara, byte x, byte y)
SPI.transfer(CMM_ADDRESS_WRITE); SPI.transfer(CMM_ADDRESS_WRITE);
SPI.transfer(_regCmm); SPI.transfer(_regCmm);
for (byte i = 0; i < 54; i++)
for(byte i = 0 ; i < 54 ; i++)
{ {
SPI.transfer(CMAL_ADDRESS_WRITE); SPI.transfer(CMAL_ADDRESS_WRITE);
SPI.transfer(i); SPI.transfer(i);
@ -117,22 +130,24 @@ void MAX7456::getCharacter(charact chara, byte x, byte y)
chara[i] = SPI.transfer(0x00); chara[i] = SPI.transfer(0x00);
} }
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements Max7456::printCharacterToSerial // Implements Max7456::printCharacterToSerial
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::printCharacterToSerial(const charact array, bool img) void MAX7456::printCharacterToSerial(const charact array, bool img)
{ {
if (img)
if(img)
{ {
CARACT car; CARACT car ;
car = MAX7456::byteArray2CARACT(array); car = MAX7456::byteArray2CARACT(array);
Serial.println("------------"); Serial.println("------------");
for (int i = 0; i < 18; i++) for(int i = 0 ; i < 18 ; i++)
{ {
for (int j = 0; j < 3; j++) for(int j = 0 ; j < 3 ; j++)
{ {
printPixel(car.line[i].pixels[j].pix0); printPixel(car.line[i].pixels[j].pix0);
printPixel(car.line[i].pixels[j].pix1); printPixel(car.line[i].pixels[j].pix1);
@ -148,26 +163,26 @@ void MAX7456::printCharacterToSerial(const charact array, bool img)
else else
{ {
Serial.print("{"); Serial.print("{");
for (unsigned int i = 0; i < 53; i++) for(unsigned int i = 0 ; i < 53 ; i++)
{ {
Serial.print("0x"); Serial.print("0x");
Serial.print(String(array[i], HEX)); Serial.print(String(array[i],HEX));
Serial.print(", "); Serial.print(", ");
} }
Serial.print("0x"); Serial.print("0x");
Serial.print(String(array[53], HEX)); Serial.print(String(array[53],HEX));
Serial.println("};"); Serial.println("};");
} }
} }
void MAX7456::printPixel(byte value) void MAX7456::printPixel(byte value)
{ {
switch (value) switch(value )
{ {
case COLOR_BLACK: case COLOR_BLACK :
Serial.print("#"); Serial.print("#");
return; return;
case COLOR_WHITE: case COLOR_WHITE :
Serial.print("*"); Serial.print("*");
return; return;
default: default:
@ -176,54 +191,55 @@ void MAX7456::printPixel(byte value)
} }
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::print // Implements MAX7456::print
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::print(const char string[], byte x, byte y, byte blink, byte inv) void MAX7456::print(const char string[], byte x, byte y, byte blink,byte inv)
{ {
char currentChar; char currentChar;
byte size; byte size;
byte *chars = NULL; byte *chars = NULL;
if (!string) if(!string) return;
return;
size = 0; size = 0;
currentChar = string[0]; currentChar = string[0];
while (currentChar != '\0') while(currentChar != '\0')
{ {
currentChar = string[++size]; currentChar = string[++size];
} }
chars = (byte *)malloc(size * sizeof(byte)); chars = (byte*) malloc(size * sizeof(byte));
for (byte i = 0; i < size; i++) for(byte i = 0 ; i < size ; i++)
{ {
chars[i] = MAX7456::giveMAX7456CharFromAsciiChar(string[i]); chars[i] = MAX7456::giveMAX7456CharFromAsciiChar(string[i]);
} }
printMAX7456Chars(chars, size, x, y, blink, inv); printMAX7456Chars(chars, size, x, y, blink , inv );
free(chars); free(chars);
} }
void MAX7456::printMAX7456Char(const byte address, byte x, byte y, byte blink, byte inv) void MAX7456::printMAX7456Char(const byte address, byte x, byte y, byte blink, byte inv)
{ {
byte ad = address; byte ad = address;
printMAX7456Chars(&ad, 1, x, y, blink, inv); printMAX7456Chars(&ad,1,x,y,blink,inv);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::printMAX7456Chars // Implements MAX7456::printMAX7456Chars
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::printMAX7456Chars(byte chars[], byte size, byte x, byte y, byte blink, byte inv) void MAX7456::printMAX7456Chars(byte chars[],byte size,byte x, byte y, byte blink ,byte inv )
{ {
byte currentChar; byte currentChar;
byte posAddressLO; byte posAddressLO;
byte posAddressHI; byte posAddressHI;
unsigned int posAddress; unsigned int posAddress;
posAddress = 30 * y + x; posAddress = 30*y+x;
posAddressHI = posAddress >> 8; posAddressHI = posAddress >> 8;
posAddressLO = posAddress; posAddressLO = posAddress;
@ -233,63 +249,77 @@ void MAX7456::printMAX7456Chars(byte chars[], byte size, byte x, byte y, byte bl
_regDmm.bits.INV = inv; _regDmm.bits.INV = inv;
_regDmm.bits.BLK = blink; _regDmm.bits.BLK = blink;
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(DMM_ADDRESS_WRITE); SPI.transfer(DMM_ADDRESS_WRITE);
SPI.transfer(_regDmm.whole); SPI.transfer(_regDmm.whole);
SPI.transfer(DMAH_ADDRESS_WRITE); // set start address high SPI.transfer(DMAH_ADDRESS_WRITE); // set start address high
SPI.transfer(posAddressHI); SPI.transfer(posAddressHI);
SPI.transfer(DMAL_ADDRESS_WRITE); // set start address low SPI.transfer(DMAL_ADDRESS_WRITE); // set start address low
SPI.transfer(posAddressLO); SPI.transfer(posAddressLO);
for (int i = 0; i < size; i++)
for(int i = 0; i < size ; i++)
{ {
currentChar = chars[i]; currentChar = chars[i];
SPI.transfer(DMDI_ADDRESS_WRITE); SPI.transfer(DMDI_ADDRESS_WRITE);
SPI.transfer(currentChar); SPI.transfer(currentChar);
} }
//end character (we're done). //end character (we're done).
SPI.transfer(DMDI_ADDRESS_WRITE); SPI.transfer(DMDI_ADDRESS_WRITE);
SPI.transfer(0xff); SPI.transfer(0xff);
digitalWrite(_pinCS, HIGH); /*
_regVm0.bits.
SPI.transfer(VM0_ADDRESS_WRITE);
SPI.transfer(0x4c);*/
digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::print // Implements MAX7456::print
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::print(double value, byte x, byte y, byte before, byte after, byte blink, byte inv) void MAX7456::print(double value, byte x, byte y, byte before, byte after, byte blink,byte inv)
{ {
char *strValue = NULL; char *strValue = NULL;
strValue = (char *)malloc((before + after + 2) * sizeof(char)); strValue = (char*) malloc((before+after+2)* sizeof(char));
if (after == 0)
dtostrf(value, before + after, after, strValue); if(after==0)
dtostrf(value,before+after,after,strValue);
else else
dtostrf(value, before + after + 1, after, strValue); dtostrf(value,before+after+1,after,strValue);
for (int i = 0; i < before + after + 1; i++) for(int i = 0 ; i < before+after+1;i++)
{ {
if (strValue[i] == ' ' || strValue[i] == '-') if(strValue[i] == ' ' || strValue[i] == '-')
strValue[i] = '0'; strValue[i]='0';
} }
if (value < 0) if(value < 0)
strValue[0] = '-'; strValue[0]='-';
if (after == 0) //If the result is bigger, we truncate it so the OSD won't be falsed. if(after==0) //If the result is bigger, we truncate it so the OSD won't be falsed.
strValue[before] = '\0'; strValue[before]='\0';
else else
strValue[before + after + 1] = '\0'; strValue[before+after+1]='\0';
print(strValue, x, y, blink, inv); print(strValue,x,y,blink,inv);
free(strValue); free(strValue);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::giveMAX7456CharFromAsciiChar // Implements MAX7456::giveMAX7456CharFromAsciiChar
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -297,8 +327,8 @@ byte MAX7456::giveMAX7456CharFromAsciiChar(char ascii)
{ {
#ifdef MAX7456_TABLE_ASCII #ifdef MAX7456_TABLE_ASCII
#error Do not be here #error Do not be here
if (ascii >= ' ' && ascii <= 'z') if(ascii >= ' ' && ascii <= 'z')
return ascii - ' '; return ascii-' ';
else else
return ascii; return ascii;
#else #else
@ -306,12 +336,13 @@ byte MAX7456::giveMAX7456CharFromAsciiChar(char ascii)
#endif #endif
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::clearScreen // Implements MAX7456::clearScreen
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::clearScreen() void MAX7456::clearScreen()
{ {
_regDmm.bits.clearDisplayMemory = 1; _regDmm.bits.clearDisplayMemory = 1 ;
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS, LOW);
@ -319,14 +350,15 @@ void MAX7456::clearScreen()
SPI.transfer(_regDmm.whole); SPI.transfer(_regDmm.whole);
//wait for operation to be complete. //wait for operation to be complete.
while (_regDmm.bits.clearDisplayMemory == 1) while(_regDmm.bits.clearDisplayMemory == 1 )
{ {
SPI.transfer(DMM_ADDRESS_READ); SPI.transfer(DMM_ADDRESS_READ);
_regDmm.whole = SPI.transfer(0x00); _regDmm.whole = SPI.transfer(0x00);
} }
digitalWrite(_pinCS, HIGH); //disable device digitalWrite(_pinCS, HIGH); //disable device
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::init // Implements MAX7456::init
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -337,25 +369,26 @@ void MAX7456::init(byte iPinCS)
_regVm1.whole = 0b01000111; _regVm1.whole = 0b01000111;
pinMode(iPinCS, OUTPUT); pinMode(iPinCS, OUTPUT);
digitalWrite(iPinCS, HIGH); //disable device digitalWrite(iPinCS, HIGH); //disable device
delay(100); //power up time delay(100); //power up time
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(VM0_ADDRESS_WRITE); SPI.transfer(VM0_ADDRESS_WRITE);
_regVm0.whole = 0x00; _regVm0.whole = 0x00;
_regVm0.bits.videoSelect = 1; //PAL _regVm0.bits.videoSelect=1; //PAL
_regVm0.bits.softwareResetBit = 1; _regVm0.bits.softwareResetBit = 1;
SPI.transfer(_regVm0.whole); SPI.transfer(_regVm0.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
delay(500); delay(500);
digitalWrite(_pinCS, LOW);
for (int x = 0; x < 16; x++) digitalWrite(_pinCS,LOW);
for(int x = 0 ; x < 16 ; x++)
{ {
_regRb[x].whole = 0x00; _regRb[x].whole = 0x00;
_regRb[x].bits.characterWhiteLevel = 2; _regRb[x].bits.characterWhiteLevel = 2;
SPI.transfer(x + RB0_ADDRESS_WRITE); SPI.transfer(x+RB0_ADDRESS_WRITE);
SPI.transfer(_regRb[x].whole); SPI.transfer(_regRb[x].whole);
} }
@ -367,72 +400,77 @@ void MAX7456::init(byte iPinCS)
SPI.transfer(_regVm0.whole); SPI.transfer(_regVm0.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::activateOSD // Implements MAX7456::activateOSD
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::activateOSD(bool act) void MAX7456::activateOSD(bool act)
{ {
if (_isActivatedOsd != act) if(_isActivatedOsd != act)
{ {
_regVm0.bits.videoSelect = 1; _regVm0.bits.videoSelect = 1;
if (act) if(act)
_regVm0.bits.enableOSD = 1; _regVm0.bits.enableOSD = 1;
else else
_regVm0.bits.enableOSD = 0; _regVm0.bits.enableOSD = 0;
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(VM0_ADDRESS_WRITE); SPI.transfer(VM0_ADDRESS_WRITE);
SPI.transfer(_regVm0.whole); SPI.transfer(_regVm0.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
_isActivatedOsd = act; _isActivatedOsd = act;
} }
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::activateExternalVideo // Implements MAX7456::activateExternalVideo
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
void MAX7456::activateExternalVideo(bool activExtVid) void MAX7456::activateExternalVideo(bool activExtVid)
{ {
if (!activExtVid) if(!activExtVid)
_regVm0.bits.synchSelect = 3; //11 _regVm0.bits.synchSelect = 3; //11
else else
_regVm0.bits.synchSelect = 0; //0 _regVm0.bits.synchSelect = 0; //0
digitalWrite(_pinCS, LOW); digitalWrite(_pinCS,LOW);
SPI.transfer(VM0_ADDRESS_WRITE); SPI.transfer(VM0_ADDRESS_WRITE);
SPI.transfer(_regVm0.whole); SPI.transfer(_regVm0.whole);
digitalWrite(_pinCS, HIGH); digitalWrite(_pinCS,HIGH);
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::CARACT2ByteArray // Implements MAX7456::CARACT2ByteArray
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
byte *MAX7456::CARACT2ByteArray(const CARACT car) byte* MAX7456::CARACT2ByteArray(const CARACT car)
{ {
byte *array = NULL; byte *array = NULL;
array = new charact; array = new charact;
for (int i = 0; i < 54; i++) for(int i = 0 ; i < 54 ; i++)
array[i] = car.whole[i]; array[i]= car.whole[i];
return array; return array;
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::byteArray2CARACT // Implements MAX7456::byteArray2CARACT
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
CARACT MAX7456::byteArray2CARACT(const charact array) CARACT MAX7456::byteArray2CARACT(const charact array)
{ {
CARACT car; CARACT car;
for (int i = 0; i < 54; i++) for(int i = 0 ; i < 54 ; i++)
car.whole[i] = array[i]; car.whole[i] = array[i];
return car; return car;
} }
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
// Implements MAX7456::getCARACFromProgMem // Implements MAX7456::getCARACFromProgMem
//----------------------------------------------------------------------------- //-----------------------------------------------------------------------------
@ -440,10 +478,10 @@ void MAX7456::getCARACFromProgMem(const char *table, byte i, charact car)
{ {
unsigned long index; unsigned long index;
byte read; byte read;
index = i * 54; index = i*54;
for (unsigned long j = 0; j < 54; j++) for(unsigned long j = 0 ; j < 54 ; j++)
{ {
read = pgm_read_byte_near(table + index + j); read = pgm_read_byte_near(table +index+j );
car[j] = read; car[j] = read;
if (car[j] == 0x55) if (car[j] == 0x55)
car[j] = 0xff; car[j] = 0xff;

82
src/MAX7456.h
View File

@ -9,6 +9,7 @@
#ifndef MAX7456_H #ifndef MAX7456_H
#define MAX7456_H #define MAX7456_H
//def next only if you changed your table for an ascii one //def next only if you changed your table for an ascii one
//i.e address 0x00 -> ' ' //i.e address 0x00 -> ' '
//.... //....
@ -18,10 +19,13 @@
#include "MAX7456Registers.h" #include "MAX7456Registers.h"
/** /**
* @mainpage MAX7456 Arduino library * @mainpage MAX7456 Arduino library
*/ */
/** /**
* @class MAX7456 * @class MAX7456
* @brief Represents a MAX7456 device communicating through SPI port * @brief Represents a MAX7456 device communicating through SPI port
@ -29,11 +33,14 @@
class MAX7456 class MAX7456
{ {
public: public:
/** /**
* Default constructor * Default constructor
*/ */
MAX7456(); MAX7456();
/** /**
* Constructor * Constructor
* Initialize communications and device * Initialize communications and device
@ -41,6 +48,7 @@ public:
*/ */
MAX7456(byte pinCS); MAX7456(byte pinCS);
/** /**
* Initialize communications and device * Initialize communications and device
* @param pinCS : pin ~CS of the arduino where MAX7456 is plugged. * @param pinCS : pin ~CS of the arduino where MAX7456 is plugged.
@ -58,18 +66,21 @@ public:
*/ */
void setBlinkParams(byte blinkBase, byte blinkDC); void setBlinkParams(byte blinkBase, byte blinkDC);
/** /**
* Set Horizontal and Vertical display offset * Set Horizontal and Vertical display offset
* @param horizontal : the horizontal offset in pixels (between 0 and 63). * @param horizontal : the horizontal offset in pixels (between 0 and 63).
* @param vertical : the vertical offset in pixels (between 0 and 31). * @param vertical : the vertical offset in pixels (between 0 and 31).
*/ */
void setDisplayOffsets(byte horizontal, byte vertical); void setDisplayOffsets(byte horizontal, byte vertical);
/** /**
* Erase Display Memory. * Erase Display Memory.
*/ */
void clearScreen(); void clearScreen();
/** /**
* Activate osd on screen * Activate osd on screen
* @param act : * @param act :
@ -78,6 +89,7 @@ public:
*/ */
void activateOSD(bool act = true); void activateOSD(bool act = true);
/** /**
* Activate input video as a background * Activate input video as a background
* @param activExtVid : * @param activExtVid :
@ -86,17 +98,20 @@ public:
*/ */
void activateExternalVideo(bool activExtVid = true); void activateExternalVideo(bool activExtVid = true);
/** /**
* Put a character in the memory character of MAX7456 * Put a character in the memory character of max7456
* @param array : the byte array representing the character (54 bytes long) * @param array : the byte array representing the character (54 bytes long)
* @param adress : the address of character in memory * @param x : the horizontal position of character in memory
* @param y : the vertical position of character in memory.
* @code * @code
* charact c={0x44,....} //Whatever charact here * charact c={0x44,....} //Whatever charact here
* max.sendCharacter(c,0x54); //put c at 4th line 5th column ie. address 54. * max.sendCharacter(c,4,5); //put c at 4th line 5th column ie. address 54.
* max.sendCharacter(c,0x43); //put c in mem at address 43. * max.sendCharacter(c,0x43); //put c in mem at address 43.
* @endcode * @endcode
*/ */
void sendCharacter(const charact array, char address); void sendCharacter(const charact array, byte x, byte y);
/** /**
* Get a character from the character memory of max7456 * Get a character from the character memory of max7456
@ -106,6 +121,7 @@ public:
*/ */
void getCharacter(charact array, byte x, byte y); void getCharacter(charact array, byte x, byte y);
/** /**
* Put a string in the display memory of max7456 * Put a string in the display memory of max7456
* @param string : The string to be displayed * @param string : The string to be displayed
@ -118,7 +134,9 @@ public:
* characters the ascii characters between ' ' and 'z' * characters the ascii characters between ' ' and 'z'
* (' ' being at address 0x00, z being at address 'z'-' '). * (' ' being at address 0x00, z being at address 'z'-' ').
*/ */
void print(const char string[], byte x, byte y, byte blink = 0, byte inv = 0); void print(const char string[], byte x, byte y, byte blink = 0,byte inv = 0);
/** /**
* Put a float in the display memory of max7456 * Put a float in the display memory of max7456
@ -138,7 +156,8 @@ public:
* //Will print "003.1400" on screen * //Will print "003.1400" on screen
* @endcode * @endcode
*/ */
void print(double value, byte x, byte y, byte before, byte after, byte blink = 0, byte inv = 0); void print(double value, byte x, byte y, byte before, byte after, byte blink=0,byte inv=0);
/** /**
* Put some characters in the display memory of MAX7456. * Put some characters in the display memory of MAX7456.
@ -155,7 +174,8 @@ public:
* max.printMAX7456Chars(chars,3,x,y); * max.printMAX7456Chars(chars,3,x,y);
* @endcode * @endcode
*/ */
void printMAX7456Chars(byte chars[], byte size, byte x, byte y, byte blink = 0, byte inv = 0); void printMAX7456Chars(byte chars[],byte size,byte x, byte y, byte blink = 0,byte inv = 0);
/** /**
* Put one character from the character memory in the display memory of MAX7456 * Put one character from the character memory in the display memory of MAX7456
@ -165,7 +185,7 @@ public:
* @param blink : if 1 then character will blink * @param blink : if 1 then character will blink
* @param inv : if 1 then color character will be inverted * @param inv : if 1 then color character will be inverted
*/ */
void printMAX7456Char(const byte address, byte x, byte y, byte blink = 0, byte inv = 0); void printMAX7456Char(const byte address, byte x, byte y, byte blink=0, byte inv=0);
/** /**
* Print a character to Serial port * Print a character to Serial port
@ -176,12 +196,14 @@ public:
*/ */
static void printCharacterToSerial(const charact array, bool img = true); static void printCharacterToSerial(const charact array, bool img = true);
/** /**
* Converts a CARACT character to a byte array representation. * Converts a CARACT character to a byte array representation.
* @param car : the CARACT character * @param car : the CARACT character
* @return : the byte array representing the character (54 bytes long) * @return : the byte array representing the character (54 bytes long)
*/ */
static byte *CARACT2ByteArray(const CARACT car); static byte* CARACT2ByteArray(const CARACT car);
/** /**
* Converts a byte array to a CARACT character. * Converts a byte array to a CARACT character.
@ -190,6 +212,7 @@ public:
*/ */
static CARACT byteArray2CARACT(const charact array); static CARACT byteArray2CARACT(const charact array);
/** /**
* Get the ith character from program memory * Get the ith character from program memory
* @param table the address of the array in prog memory * @param table the address of the array in prog memory
@ -199,33 +222,36 @@ public:
* @note When accessing this array, 0x55 are interpreted as 0xFF (you can't have 0xFF in program memory. * @note When accessing this array, 0x55 are interpreted as 0xFF (you can't have 0xFF in program memory.
* @note See file example for more informations. * @note See file example for more informations.
*/ */
static void getCARACFromProgMem(const char *table, byte i, charact c); static void getCARACFromProgMem(const char *table, byte i,charact c);
private: private:
byte giveMAX7456CharFromAsciiChar(char ascii); byte giveMAX7456CharFromAsciiChar(char ascii);
static void printPixel(byte value); static void printPixel(byte value);
byte _pinCS; byte _pinCS;
bool _isActivatedOsd; bool _isActivatedOsd;
//registers (only here for convenience : not forced to be used). //registers (only here for convenience : not forced to be used).
REG_VM0 _regVm0; REG_VM0 _regVm0;
REG_VM1 _regVm1; REG_VM1 _regVm1;
REG_HOS _regHos; REG_HOS _regHos;
REG_VOS _regVos; REG_VOS _regVos;
REG_DMM _regDmm; REG_DMM _regDmm;
REG_DMAH _regDmah; // not used yet REG_DMAH _regDmah; // not used yet
REG_DMAL _regDmal; // not used yet REG_DMAL _regDmal; // not used yet
REG_DMDI _regDmdi; // not used yet REG_DMDI _regDmdi; // not used yet
REG_CMM _regCmm; REG_CMM _regCmm;
REG_CMAH _regCmah; // not used yet REG_CMAH _regCmah; // not used yet
REG_CMAL _regCmal; // not used yet REG_CMAL _regCmal; // not used yet
REG_CMDI _regCmdi; // not used yet REG_CMDI _regCmdi; // not used yet
REG_OSDM _regOsdm; // not used yet REG_OSDM _regOsdm; // not used yet
REG_RBN _regRb[16]; // not used yet REG_RBN _regRb[16]; // not used yet
REG_OSDBL _regOsdbl; // not used yet REG_OSDBL _regOsdbl; // not used yet
REG_STAT _regStat; // not used yet REG_STAT _regStat; // not used yet
DMDO _regDmdo; // not used yet DMDO _regDmdo; // not used yet
REG_CMDO _regCmdo; // not used yet REG_CMDO _regCmdo; // not used yet
}; };
#endif /* MAX7456_H_ */ #endif /* MAX7456_H_ */

60
src/MAX7456Registers.h
View File

@ -8,8 +8,10 @@
#ifndef MAX7456REGISTERS_H_ #ifndef MAX7456REGISTERS_H_
#define MAX7456REGISTERS_H_ #define MAX7456REGISTERS_H_
#include <Arduino.h> #include <Arduino.h>
/** /**
* @typedef charact * @typedef charact
* @brief Represents a character as stored in MAX7456 character memory. * @brief Represents a character as stored in MAX7456 character memory.
@ -26,7 +28,7 @@ typedef byte charact[54];
union REG_VM0 union REG_VM0
{ {
/**@brief The whole value*/ /**@brief The whole value*/
unsigned char whole; unsigned char whole ;
/** /**
* @var bits * @var bits
* @brief access to individual bits*/ * @brief access to individual bits*/
@ -36,7 +38,7 @@ union REG_VM0
* @li 0 = Enable * @li 0 = Enable
* @li 1 = Disable(VOUT is high impedance) * @li 1 = Disable(VOUT is high impedance)
*/ */
unsigned char videoBuffer : 1; unsigned char videoBuffer :1;
/**@brief Software Reset Bit /**@brief Software Reset Bit
* @li When bit set all register are set to default. * @li When bit set all register are set to default.
@ -66,7 +68,7 @@ union REG_VM0
* @li 0 = NTSC * @li 0 = NTSC
* @li 1 = PAL * @li 1 = PAL
*/ */
unsigned char videoSelect : 1; unsigned char videoSelect :1;
/**@brief don't care*/ /**@brief don't care*/
unsigned char unused : 1; unsigned char unused : 1;
@ -74,6 +76,7 @@ union REG_VM0
} bits; } bits;
}; };
#define VM1_ADDRESS_WRITE 0x01 #define VM1_ADDRESS_WRITE 0x01
#define VM1_ADDRESS_READ 0x81 #define VM1_ADDRESS_READ 0x81
@ -98,6 +101,7 @@ union REG_VM1
*/ */
unsigned char blinkingDutyCycle : 2; unsigned char blinkingDutyCycle : 2;
/**@brief Blinking Time (BT) /**@brief Blinking Time (BT)
* @li b00 (0) = 2 fields (NTSC = 33ms ; PAL = 40ms) * @li b00 (0) = 2 fields (NTSC = 33ms ; PAL = 40ms)
* @li b01 (1) = 4 fields (NTSC = 67ms ; PAL = 80ms) * @li b01 (1) = 4 fields (NTSC = 67ms ; PAL = 80ms)
@ -106,6 +110,7 @@ union REG_VM1
*/ */
unsigned char blinkingTime : 2; unsigned char blinkingTime : 2;
/**@brief Background Mode Brightness /**@brief Background Mode Brightness
* @li b000 (0) = 0% * @li b000 (0) = 0%
* @li b001 (1) = 7% * @li b001 (1) = 7%
@ -158,6 +163,7 @@ union REG_HOS
} bits; } bits;
}; };
#define VOS_ADDRESS_WRITE 0x03 #define VOS_ADDRESS_WRITE 0x03
#define VOS_ADDRESS_READ 0x83 #define VOS_ADDRESS_READ 0x83
@ -258,9 +264,12 @@ union REG_DMM
/**@brief Don't care*/ /**@brief Don't care*/
unsigned char unsused : 1; unsigned char unsused : 1;
} bits; } bits;
}; };
#define DMAH_ADDRESS_WRITE 0x05 #define DMAH_ADDRESS_WRITE 0x05
#define DMAH_ADDRESS_READ 0x85 #define DMAH_ADDRESS_READ 0x85
/**@union REG_DMAH /**@union REG_DMAH
@ -284,10 +293,12 @@ union REG_DMAH
} bits; } bits;
}; };
#define DMAL_ADDRESS_WRITE 0x06 #define DMAL_ADDRESS_WRITE 0x06
#define DMAL_ADDRESS_READ 0x86 #define DMAL_ADDRESS_READ 0x86
typedef unsigned char REG_DMAL; typedef unsigned char REG_DMAL;
#define DMDI_ADDRESS_WRITE 0x07 #define DMDI_ADDRESS_WRITE 0x07
#define DMDI_ADDRESS_READ 0x87 #define DMDI_ADDRESS_READ 0x87
typedef unsigned char REG_DMDI; typedef unsigned char REG_DMDI;
@ -342,6 +353,7 @@ union REG_CMDI
} bits; } bits;
}; };
#define OSDM_ADDRESS_WRITE 0x0C #define OSDM_ADDRESS_WRITE 0x0C
#define OSDM_ADDRESS_READ 0x8C #define OSDM_ADDRESS_READ 0x8C
@ -368,6 +380,7 @@ union REG_OSDM
*/ */
unsigned char osdInsertionMuxSwitchingTime : 3; unsigned char osdInsertionMuxSwitchingTime : 3;
/**@brief OSD Rise And Fall Time /**@brief OSD Rise And Fall Time
* @li b000 (0) : 20ns (maximum sharpness/maximum crosscolor artifacts ) * @li b000 (0) : 20ns (maximum sharpness/maximum crosscolor artifacts )
* @li b001 (1) : 30ns * @li b001 (1) : 30ns
@ -378,12 +391,14 @@ union REG_OSDM
*/ */
unsigned char osdRiseAndFallTime : 3; unsigned char osdRiseAndFallTime : 3;
/**@brief don't care*/ /**@brief don't care*/
unsigned char unused : 2; unsigned char unused : 2;
} bits; } bits;
}; };
#define RB0_ADDRESS_WRITE 0x10 #define RB0_ADDRESS_WRITE 0x10
#define RB0_ADDRESS_READ 0x90 #define RB0_ADDRESS_READ 0x90
@ -547,6 +562,7 @@ union REG_STAT
} bits; } bits;
}; };
#define DMDO_ADDRESS_READ 0xB0 #define DMDO_ADDRESS_READ 0xB0
/**@typedef DMDO /**@typedef DMDO
@ -579,26 +595,33 @@ union REG_CMDO
} bits; } bits;
}; };
/**\def COLOR_BLACK /**\def COLOR_BLACK
* \brief Black value for a pixel (2bits) * \brief Black value for a pixel (2bits)
*/ */
#define COLOR_BLACK 0 #define COLOR_BLACK 0
/**\def COLOR_WHITE /**\def COLOR_WHITE
* \brief White value for a pixel (2bits) * \brief White value for a pixel (2bits)
*/ */
#define COLOR_WHITE 2 #define COLOR_WHITE 2
/**\def COLOR_TRANSPARENT /**\def COLOR_TRANSPARENT
* \brief Transparent value for a pixel (2bits) * \brief Transparent value for a pixel (2bits)
*/ */
#define COLOR_TRANSPARENT 1 #define COLOR_TRANSPARENT 1
/**\def COLOR_GREY /**\def COLOR_GREY
* \brief Grey value for a pixel (2bits) * \brief Grey value for a pixel (2bits)
*/ */
#define COLOR_GREY COLOR_TRANSPARENT #define COLOR_GREY COLOR_TRANSPARENT
/**@struct PIXEL /**@struct PIXEL
* @brief represent a 4-pixels value * @brief represent a 4-pixels value
*/ */
@ -611,8 +634,10 @@ struct PIXEL
/**@brief 2nd pixel*/ /**@brief 2nd pixel*/
byte pix1 : 2; byte pix1 : 2;
/**@brief 1st pixel*/ /**@brief 1st pixel*/
byte pix0 : 2; byte pix0 : 2;
}; };
/**@union LINE /**@union LINE
@ -626,6 +651,7 @@ union LINE
struct PIXEL pixels[3]; struct PIXEL pixels[3];
}; };
/** /**
* @union CARACT * @union CARACT
* @brief Represents a character with lines and pixels. * @brief Represents a character with lines and pixels.
@ -639,20 +665,20 @@ union CARACT
union LINE line[18]; union LINE line[18];
}; };
enum
{ enum{
_BT_BT = 0, _BT_BT=0,
_BT_2BT, _BT_2BT,
_BT_3BT, _BT_3BT,
_3BT_BT _3BT_BT
}; };
enum enum{
{ _2fields=0,
_2fields = 0, _4fields,
_4fields, _6fields,
_6fields, _8fields
_8fields
}; };
#endif /* MAX7456REGISTERS_H_ */ #endif /* MAX7456REGISTERS_H_ */