Add missing files for NanoLogger

2 files changed, 433 insertions, 0 deletions

diff --git a/nanologger/PCD8544.cpp b/nanologger/PCD8544.cpp
new file mode 100644
index 0000000..6b339fe
--- /dev/null
+++ b/nanologger/PCD8544.cpp
@@ -0,0 +1,316 @@
+/*
+ * PCD8544 - Interface with Philips PCD8544 (or compatible) LCDs.
+ *
+ * Copyright (c) 2010 Carlos Rodrigues <cefrodrigues@gmail.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+
+#include "PCD8544.h"
+
+#include <Arduino.h>
+#include <avr/pgmspace.h>
+
+extern const PROGMEM unsigned char font5x8[][5];
+
+/*
+ * If this was a ".h", it would get added to sketches when using
+ * the "Sketch -> Import Library..." menu on the Arduino IDE...
+ */
+
+PCD8544::PCD8544(unsigned char sclk, unsigned char sdin,
+                 unsigned char dc, unsigned char reset,
+                 unsigned char sce):
+    pin_sclk(sclk),
+    pin_sdin(sdin),
+    pin_dc(dc),
+    pin_reset(reset),
+    pin_sce(sce)
+{}
+
+
+void PCD8544::begin(unsigned char model)
+{
+    this->column = 0;
+    this->line = 0;
+
+    // Sanitize the custom glyphs...
+    memset(this->custom, 0, sizeof(this->custom));
+
+    // All pins are outputs (these displays cannot be read)...
+    pinMode(this->pin_sclk, OUTPUT);
+    pinMode(this->pin_sdin, OUTPUT);
+    pinMode(this->pin_dc, OUTPUT);
+    pinMode(this->pin_reset, OUTPUT);
+    pinMode(this->pin_sce, OUTPUT);
+
+    // Reset the controller state...
+    digitalWrite(this->pin_reset, HIGH);
+    digitalWrite(this->pin_sce, HIGH);
+    digitalWrite(this->pin_reset, LOW);
+    delay(100);
+    digitalWrite(this->pin_reset, HIGH);
+
+    // Set the LCD parameters...
+    this->send(PCD8544_CMD, 0x21);  // extended instruction set control (H=1)
+    this->send(PCD8544_CMD, 0x13);  // bias system (1:48)
+
+    if (model == CHIP_ST7576) {
+        this->send(PCD8544_CMD, 0xe0);  // higher Vop, too faint at default
+        this->send(PCD8544_CMD, 0x05);  // partial display mode
+    } else {
+        this->send(PCD8544_CMD, 0xc2);  // default Vop (3.06 + 66 * 0.06 = 7V)
+    }
+
+    this->send(PCD8544_CMD, 0x20);  // extended instruction set control (H=0)
+    this->send(PCD8544_CMD, 0x09);  // all display segments on
+
+    // Clear RAM contents...
+    this->clear();
+
+    // Activate LCD...
+    this->send(PCD8544_CMD, 0x08);  // display blank
+    this->send(PCD8544_CMD, 0x0c);  // normal mode (0x0d = inverse mode)
+    delay(100);
+
+    // Place the cursor at the origin...
+    this->send(PCD8544_CMD, 0x80);
+    this->send(PCD8544_CMD, 0x40);
+}
+
+
+void PCD8544::stop()
+{
+    this->clear();
+    this->setPower(false);
+}
+
+
+void PCD8544::clear()
+{
+    this->setCursor(0, 0);
+
+    for (unsigned short i = 0; i < PCD8544_WIDTH * (PCD8544_HEIGHT/8); i++) {
+        this->send(PCD8544_DATA, 0x00);
+    }
+
+    this->setCursor(0, 0);
+}
+
+
+void PCD8544::clearLine()
+{
+    this->setCursor(0, this->line);
+
+    for (unsigned char i = 0; i < PCD8544_WIDTH; i++) {
+        this->send(PCD8544_DATA, 0x00);
+    }
+
+    this->setCursor(0, this->line);
+}
+
+
+void PCD8544::setPower(bool on)
+{
+    this->send(PCD8544_CMD, on ? 0x20 : 0x24);
+}
+
+
+inline void PCD8544::display()
+{
+    this->setPower(true);
+}
+
+
+inline void PCD8544::noDisplay()
+{
+    this->setPower(false);
+}
+
+
+void PCD8544::setInverse(bool inverse)
+{
+    this->send(PCD8544_CMD, inverse ? 0x0d : 0x0c);
+}
+
+
+void PCD8544::home()
+{
+    this->setCursor(0, this->line);
+}
+
+
+void PCD8544::setCursor(unsigned char column, unsigned char line)
+{
+    if (column > PCD8544_WIDTH) {
+        column = 0;
+        line++;
+    }
+    if (line > PCD8544_HEIGHT / 8)
+        line = 0;
+
+    this->column = column;
+    this->line = line;
+
+    this->send(PCD8544_CMD, 0x80 | column);
+    this->send(PCD8544_CMD, 0x40 | line);
+}
+
+
+void PCD8544::createChar(unsigned char chr, const unsigned char *glyph)
+{
+    // ASCII 0-31 only...
+    if (chr >= ' ') {
+        return;
+    }
+
+    this->custom[chr] = glyph;
+}
+
+
+size_t PCD8544::write(uint8_t chr)
+{
+    // ASCII 7-bit only...
+    if (chr >= 0x7f) {
+        return 0;
+    }
+
+    if (chr == '\n') {
+        column = 0;
+        line = (line + 1) % (PCD8544_HEIGHT/9 + 1);
+        return 0;
+    } else if (chr == '\r') {
+        column = 0;
+        return 0;
+    }
+
+    const unsigned char *glyph;
+    unsigned char pgm_buffer[5];
+
+    if (chr >= ' ') {
+        // Regular ASCII characters are kept in flash to save RAM...
+        memcpy_P(pgm_buffer, &font5x8[chr - ' '], sizeof(pgm_buffer));
+        glyph = pgm_buffer;
+    } else {
+        // Custom glyphs, on the other hand, are stored in RAM...
+        if (custom[chr]) {
+            glyph = custom[chr];
+        } else {
+            // Default to a space character if unset...
+            memcpy_P(pgm_buffer, &font5x8[0], sizeof(pgm_buffer));
+            glyph = pgm_buffer;
+        }
+    }
+
+    // Output one column at a time...
+    for (unsigned char i = 0; i < 5; i++) {
+        this->send(PCD8544_DATA, glyph[i]);
+    }
+
+    // One column between characters...
+    this->send(PCD8544_DATA, 0x00);
+
+    // Update the cursor position...
+    this->column = (this->column + 6) % PCD8544_WIDTH;
+
+    if (this->column == 0) {
+        this->line = (this->line + 1) % (PCD8544_HEIGHT/9 + 1);
+    }
+
+#if ARDUINO >= 100
+    return 1;
+#endif
+}
+
+void PCD8544::draw8x8(const unsigned char *data)
+{
+    // Output one column at a time...
+    for (unsigned char i = 0; i < 8; i++) {
+        this->send(PCD8544_DATA, data[i]);
+    }
+    this->setCursor(column + 8, line);
+}
+
+void PCD8544::draw16x16(const unsigned char *data)
+{
+    unsigned char scolumn = this->column;
+    unsigned char sline = this->line;
+    // Output one column at a time...
+    for (unsigned char i = 0; i < 16; i++) {
+        this->send(PCD8544_DATA, data[i]);
+    }
+    this->setCursor(scolumn, sline + 1);
+    for (unsigned char i = 0; i < 16; i++) {
+        this->send(PCD8544_DATA, data[i + 16]);
+    }
+    // Update the cursor position...
+    this->setCursor(scolumn + 16, sline);
+}
+
+void PCD8544::drawColumn(unsigned char lines, unsigned char value)
+{
+    unsigned char scolumn = this->column;
+    unsigned char sline = this->line;
+
+    // Keep "value" within range...
+    if (value > lines*8) {
+        value = lines*8;
+    }
+
+    // Find the line where "value" resides...
+    unsigned char mark = (lines*8 - 1 - value)/8;
+
+    // Clear the lines above the mark...
+    for (unsigned char line = 0; line < mark; line++) {
+        this->setCursor(scolumn, sline + line);
+        this->send(PCD8544_DATA, 0x00);
+    }
+
+    // Compute the byte to draw at the "mark" line...
+    unsigned char b = 0xff;
+    for (unsigned char i = 0; i < lines*8 - mark*8 - value; i++) {
+        b <<= 1;
+    }
+
+    this->setCursor(scolumn, sline + mark);
+    this->send(PCD8544_DATA, b);
+
+    // Fill the lines below the mark...
+    for (unsigned char line = mark + 1; line < lines; line++) {
+        this->setCursor(scolumn, sline + line);
+        this->send(PCD8544_DATA, 0xff);
+    }
+
+    // Leave the cursor in a consistent position...
+    this->setCursor(scolumn + 1, sline);
+}
+
+
+void PCD8544::send(unsigned char type, unsigned char data)
+{
+    digitalWrite(this->pin_dc, type);
+
+    digitalWrite(this->pin_sce, LOW);
+    shiftOut(this->pin_sdin, this->pin_sclk, MSBFIRST, data);
+    digitalWrite(this->pin_sce, HIGH);
+}
+
+
+/* vim: set expandtab ts=4 sw=4: */
diff --git a/nanologger/PCD8544.h b/nanologger/PCD8544.h
new file mode 100644
index 0000000..c96bc7e
--- /dev/null
+++ b/nanologger/PCD8544.h
@@ -0,0 +1,117 @@
+/*
+ * PCD8544 - Interface with Philips PCD8544 (or compatible) LCDs.
+ *
+ * Copyright (c) 2010 Carlos Rodrigues <cefrodrigues@gmail.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+
+#ifndef PCD8544_H
+#define PCD8544_H
+
+
+#if ARDUINO < 100
+#include <WProgram.h>
+#else
+#include <Arduino.h>
+#endif
+
+// Chip variants supported...
+#define CHIP_PCD8544 0
+#define CHIP_ST7576  1
+
+#define PCD8544_WIDTH 84
+#define PCD8544_HEIGHT 48
+
+#define PCD8544_CMD  LOW
+#define PCD8544_DATA HIGH
+
+class PCD8544: public Print {
+    public:
+        // All the pins can be changed from the default values...
+        PCD8544(unsigned char sclk  = 2,   /* clock       (display pin 2) */
+                unsigned char sdin  = 3,   /* data-in     (display pin 3) */
+                unsigned char dc    = 4,   /* data select (display pin 4) */
+                unsigned char reset = 6,   /* reset       (display pin 8) */
+                unsigned char sce   = 5);  /* enable      (display pin 5) */
+
+        // Display initialization (dimensions in pixels)...
+        void begin(unsigned char model=CHIP_PCD8544);
+        void stop();
+
+        // Erase everything on the display...
+        void clear();
+        void clearLine();  // ...or just the current line
+
+        // Control the display's power state...
+        void setPower(bool on);
+
+        // For compatibility with the LiquidCrystal library...
+        void display();
+        void noDisplay();
+
+        // Activate white-on-black mode (whole display)...
+        void setInverse(bool inverse);
+
+        // Place the cursor at the start of the current line...
+        void home();
+
+        // Place the cursor at position (column, line)...
+        void setCursor(unsigned char column, unsigned char line);
+
+        // Assign a user-defined glyph (5x8) to an ASCII character (0-31)...
+        void createChar(unsigned char chr, const unsigned char *glyph);
+
+        // Write an ASCII character at the current cursor position (7-bit)...
+#if ARDUINO < 100
+        virtual void write(uint8_t chr);
+#else
+        virtual size_t write(uint8_t chr);
+#endif
+
+        // Draw a chart element at the current cursor position...
+        void drawColumn(unsigned char lines, unsigned char value);
+
+        void draw8x8(const unsigned char *data);
+        void draw16x16(const unsigned char *data);
+
+    protected:
+        // Current cursor position...
+        unsigned char column;
+        unsigned char line;
+        // Send a command or data to the display...
+        void send(unsigned char type, unsigned char data);
+
+    private:
+        unsigned char pin_sclk;
+        unsigned char pin_sdin;
+        unsigned char pin_dc;
+        unsigned char pin_reset;
+        unsigned char pin_sce;
+
+        // User-defined glyphs (below the ASCII space character)...
+        const unsigned char *custom[' '];
+};
+
+
+#endif  /* PCD8544_H */
+
+
+/* vim: set expandtab ts=4 sw=4: */