2bk0123_GPS_Test05

Users » Joeatsumi » Code » 2bk0123_GPS_Test05

Atsumi Toda / Mbed 2 deprecated 2bk0123_GPS_Test05

Fork of 2bk0123_GPS_Test05 by Takeuchi Kouichi

TextLCD0420.cpp@0:f3ff53b5b707, 2011-02-02 (annotated)

Committer:: takeuchi
Date:: Wed Feb 02 06:03:53 2011 +0000
Revision:: 0:f3ff53b5b707

Who changed what in which revision?

User	Revision	Line number	New contents of line
takeuchi	0:f3ff53b5b707	1	/* mbed TextLCD Library
takeuchi	0:f3ff53b5b707	2	* Copyright (c) 2007-2009 sford
takeuchi	0:f3ff53b5b707	3	* Released under the MIT License: http://mbed.org/license/mit
takeuchi	0:f3ff53b5b707	4	*/
takeuchi	0:f3ff53b5b707	5	// for 04row*20line LCD
takeuchi	0:f3ff53b5b707	6
takeuchi	0:f3ff53b5b707	7	#include "TextLCD0420.h"
takeuchi	0:f3ff53b5b707	8
takeuchi	0:f3ff53b5b707	9	#include "mbed.h"
takeuchi	0:f3ff53b5b707	10	#include "error.h"
takeuchi	0:f3ff53b5b707	11
takeuchi	0:f3ff53b5b707	12	using namespace mbed;
takeuchi	0:f3ff53b5b707	13
takeuchi	0:f3ff53b5b707	14	/*
takeuchi	0:f3ff53b5b707	15	* useful info found at http://www.a-netz.de/lcd.en.php
takeuchi	0:f3ff53b5b707	16	*
takeuchi	0:f3ff53b5b707	17	*
takeuchi	0:f3ff53b5b707	18	* Initialisation
takeuchi	0:f3ff53b5b707	19	* ==============
takeuchi	0:f3ff53b5b707	20	*
takeuchi	0:f3ff53b5b707	21	* After attaching the supply voltage/after a reset, the display needs to be brought in to a defined state
takeuchi	0:f3ff53b5b707	22	*
takeuchi	0:f3ff53b5b707	23	* - wait approximately 15 ms so the display is ready to execute commands
takeuchi	0:f3ff53b5b707	24	* - Execute the command 0x30 ("Display Settings") three times (wait 1,64ms after each command, the busy flag cannot be queried now).
takeuchi	0:f3ff53b5b707	25	* - The display is in 8 bit mode, so if you have only connected 4 data pins you should only transmit the higher nibble of each command.
takeuchi	0:f3ff53b5b707	26	* - If you want to use the 4 bit mode, now you can execute the command to switch over to this mode now.
takeuchi	0:f3ff53b5b707	27	* - Execute the "clear display" command
takeuchi	0:f3ff53b5b707	28	*
takeuchi	0:f3ff53b5b707	29	* Timing
takeuchi	0:f3ff53b5b707	30	* ======
takeuchi	0:f3ff53b5b707	31	*
takeuchi	0:f3ff53b5b707	32	* Nearly all commands transmitted to the display need 40us for execution.
takeuchi	0:f3ff53b5b707	33	* Exceptions are the commands "Clear Display and Reset" and "Set Cursor to Start Position"
takeuchi	0:f3ff53b5b707	34	* These commands need 1.64ms for execution. These timings are valid for all displays working with an
takeuchi	0:f3ff53b5b707	35	* internal clock of 250kHz. But I do not know any displays that use other frequencies. Any time you
takeuchi	0:f3ff53b5b707	36	* can use the busy flag to test if the display is ready to accept the next command.
takeuchi	0:f3ff53b5b707	37	*
takeuchi	0:f3ff53b5b707	38	* _e is kept high apart from calling clock
takeuchi	0:f3ff53b5b707	39	* _rw is kept 0 (write) apart from actions that uyse it differently
takeuchi	0:f3ff53b5b707	40	* _rs is set by the data/command writes
takeuchi	0:f3ff53b5b707	41	*/
takeuchi	0:f3ff53b5b707	42
takeuchi	0:f3ff53b5b707	43	TextLCD::TextLCD(PinName rs, PinName rw, PinName e, PinName d0, PinName d1,
takeuchi	0:f3ff53b5b707	44	PinName d2, PinName d3, int columns, int rows) : _rw(rw), _rs(rs),
takeuchi	0:f3ff53b5b707	45	_e(e), _d(d0, d1, d2, d3), _columns(columns), _rows(rows) {
takeuchi	0:f3ff53b5b707	46
takeuchi	0:f3ff53b5b707	47
takeuchi	0:f3ff53b5b707	48	// Mon, 27 Apr 2009 23:32:34 +0200
takeuchi	0:f3ff53b5b707	49	// Kevin Konradt:
takeuchi	0:f3ff53b5b707	50	// When using a LCD with 1 row x 16 characters
takeuchi	0:f3ff53b5b707	51	// instead of 2x16, try changing _columns to 8.
takeuchi	0:f3ff53b5b707	52	// (display seems to split the 16 characters into
takeuchi	0:f3ff53b5b707	53	// 2 virtual rows with 8 characters each.)
takeuchi	0:f3ff53b5b707	54
takeuchi	0:f3ff53b5b707	55	_rw = 0;
takeuchi	0:f3ff53b5b707	56	_e = 1;
takeuchi	0:f3ff53b5b707	57	_rs = 0; // command mode
takeuchi	0:f3ff53b5b707	58
takeuchi	0:f3ff53b5b707	59	// Should theoretically wait 15ms, but most things will be powered up pre-reset
takeuchi	0:f3ff53b5b707	60	// so i'll disable that for the minute. If implemented, could wait 15ms post reset
takeuchi	0:f3ff53b5b707	61	// instead
takeuchi	0:f3ff53b5b707	62	// wait(0.015);
takeuchi	0:f3ff53b5b707	63
takeuchi	0:f3ff53b5b707	64	// send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
takeuchi	0:f3ff53b5b707	65	for(int i=0; i<3; i++) {
takeuchi	0:f3ff53b5b707	66	writeNibble(0x3);
takeuchi	0:f3ff53b5b707	67	wait(0.00164); // this command takes 1.64ms, so wait for it
takeuchi	0:f3ff53b5b707	68	}
takeuchi	0:f3ff53b5b707	69	writeNibble(0x2); // 4-bit mode
takeuchi	0:f3ff53b5b707	70
takeuchi	0:f3ff53b5b707	71	writeCommand(0x28); // Function set 001 BW N F - -
takeuchi	0:f3ff53b5b707	72	writeCommand(0x0C);
takeuchi	0:f3ff53b5b707	73	writeCommand(0x6); // Cursor Direction and Display Shift : 0000 01 CD S (CD 0-left, 1-right S(hift) 0-no, 1-yes
takeuchi	0:f3ff53b5b707	74
takeuchi	0:f3ff53b5b707	75	cls();
takeuchi	0:f3ff53b5b707	76	}
takeuchi	0:f3ff53b5b707	77
takeuchi	0:f3ff53b5b707	78	int TextLCD::_putc(int value) {
takeuchi	0:f3ff53b5b707	79	if(value == '\n') {
takeuchi	0:f3ff53b5b707	80	newline();
takeuchi	0:f3ff53b5b707	81	} else {
takeuchi	0:f3ff53b5b707	82	writeData(value);
takeuchi	0:f3ff53b5b707	83	}
takeuchi	0:f3ff53b5b707	84	return value;
takeuchi	0:f3ff53b5b707	85	}
takeuchi	0:f3ff53b5b707	86
takeuchi	0:f3ff53b5b707	87	int TextLCD::_getc() {
takeuchi	0:f3ff53b5b707	88	return 0;
takeuchi	0:f3ff53b5b707	89	}
takeuchi	0:f3ff53b5b707	90
takeuchi	0:f3ff53b5b707	91	void TextLCD::newline() {
takeuchi	0:f3ff53b5b707	92	_column = 0;
takeuchi	0:f3ff53b5b707	93	_row++;
takeuchi	0:f3ff53b5b707	94	if(_row >= _rows) {
takeuchi	0:f3ff53b5b707	95	_row = 0;
takeuchi	0:f3ff53b5b707	96	}
takeuchi	0:f3ff53b5b707	97	locate(_column, _row);
takeuchi	0:f3ff53b5b707	98	}
takeuchi	0:f3ff53b5b707	99
takeuchi	0:f3ff53b5b707	100	void TextLCD::locate(int column, int row) {
takeuchi	0:f3ff53b5b707	101	int address;
takeuchi	0:f3ff53b5b707	102	if(column < 0 \|\| column >= _columns \|\| row < 0 \|\| row >= _rows) {
takeuchi	0:f3ff53b5b707	103	error("locate(%d,%d) out of range on %dx%d display", column, row, _columns, _rows);
takeuchi	0:f3ff53b5b707	104	return;
takeuchi	0:f3ff53b5b707	105	}
takeuchi	0:f3ff53b5b707	106
takeuchi	0:f3ff53b5b707	107	_row = row;
takeuchi	0:f3ff53b5b707	108	_column = column;
takeuchi	0:f3ff53b5b707	109	// 0220 => int address = 0x80 + (_row 40) + _column; // memory starts at 0x80, and is 40 chars long per row
takeuchi	0:f3ff53b5b707	110
takeuchi	0:f3ff53b5b707	111
takeuchi	0:f3ff53b5b707	112	if(_row == 0 ){
takeuchi	0:f3ff53b5b707	113	address = 0x80+_column;
takeuchi	0:f3ff53b5b707	114	}
takeuchi	0:f3ff53b5b707	115	else if(_row == 1 ){
takeuchi	0:f3ff53b5b707	116	address = 0x80+ (0x40) + _column;
takeuchi	0:f3ff53b5b707	117	}
takeuchi	0:f3ff53b5b707	118	else if(_row == 2){
takeuchi	0:f3ff53b5b707	119	address = 0x80+(0x14)+_column;
takeuchi	0:f3ff53b5b707	120	}
takeuchi	0:f3ff53b5b707	121	else if(_row == 3){
takeuchi	0:f3ff53b5b707	122	address = 0x80+(0x54)+_column;
takeuchi	0:f3ff53b5b707	123	}
takeuchi	0:f3ff53b5b707	124
takeuchi	0:f3ff53b5b707	125	writeCommand(address);
takeuchi	0:f3ff53b5b707	126	}
takeuchi	0:f3ff53b5b707	127
takeuchi	0:f3ff53b5b707	128	void TextLCD::cls() {
takeuchi	0:f3ff53b5b707	129	writeCommand(0x01); // Clear Display
takeuchi	0:f3ff53b5b707	130	wait(0.00164f); // This command takes 1.64 ms
takeuchi	0:f3ff53b5b707	131	locate(0, 0);
takeuchi	0:f3ff53b5b707	132	}
takeuchi	0:f3ff53b5b707	133
takeuchi	0:f3ff53b5b707	134	void TextLCD::reset() {
takeuchi	0:f3ff53b5b707	135	cls();
takeuchi	0:f3ff53b5b707	136	}
takeuchi	0:f3ff53b5b707	137
takeuchi	0:f3ff53b5b707	138	void TextLCD::clock() {
takeuchi	0:f3ff53b5b707	139	wait(0.000040f);
takeuchi	0:f3ff53b5b707	140	_e = 0;
takeuchi	0:f3ff53b5b707	141	wait(0.000040f); // most instructions take 40us
takeuchi	0:f3ff53b5b707	142	_e = 1;
takeuchi	0:f3ff53b5b707	143	}
takeuchi	0:f3ff53b5b707	144
takeuchi	0:f3ff53b5b707	145	void TextLCD::writeNibble(int value) {
takeuchi	0:f3ff53b5b707	146	_d = value;
takeuchi	0:f3ff53b5b707	147	clock();
takeuchi	0:f3ff53b5b707	148	}
takeuchi	0:f3ff53b5b707	149
takeuchi	0:f3ff53b5b707	150	void TextLCD::writeByte(int value) {
takeuchi	0:f3ff53b5b707	151	writeNibble(value >> 4);
takeuchi	0:f3ff53b5b707	152	writeNibble(value >> 0);
takeuchi	0:f3ff53b5b707	153	}
takeuchi	0:f3ff53b5b707	154
takeuchi	0:f3ff53b5b707	155	void TextLCD::writeCommand(int command) {
takeuchi	0:f3ff53b5b707	156	_rs = 0;
takeuchi	0:f3ff53b5b707	157	writeByte(command);
takeuchi	0:f3ff53b5b707	158	}
takeuchi	0:f3ff53b5b707	159
takeuchi	0:f3ff53b5b707	160	void TextLCD::writeData(int data) {
takeuchi	0:f3ff53b5b707	161	_rs = 1;
takeuchi	0:f3ff53b5b707	162	writeByte(data);
takeuchi	0:f3ff53b5b707	163	_column++;
takeuchi	0:f3ff53b5b707	164	if(_column >= _columns) {
takeuchi	0:f3ff53b5b707	165	newline();
takeuchi	0:f3ff53b5b707	166	}
takeuchi	0:f3ff53b5b707	167	}

Repository toolbox

Repository details

Type:	Program
Mbed OS support:	Mbed 2 deprecated
Created:	15 Feb 2018
Imports:	4
Forks:	1
Commits:	2
Dependents:	0
Dependencies:	2
Followers:	1

Important changes to repositories hosted on mbed.com

TextLCD0420.cpp@0:f3ff53b5b707, 2011-02-02 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Important changes to repositories hosted on mbed.com

TextLCD0420.cpp@0:f3ff53b5b707, 2011-02-02 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning