Dr. Abhishek Dutta

Nokia 6100 LCD support in serdisplib project

leave a comment »

  • Scanned version of original article published in Electronics For You : pdf (9.7MB)
  • Draft of article sent to EFY for publishing : pdf
  • gmailtolcd application : zip (please rename the file to gmailtolcd.zip)

My article titled “Using ‘serdisplib’ library to drive mobile phone LCD” was published in the “Do-It-Yourself” section of Electronics For You (May 2008 issue) magazine. This was the first time when I was paid money for writing an article. I have been reading this magazine since I was 12 and was delighted to see my name in one of the articles of this magazine. The utility of mobile phone lcd interfacing is demonstrated using a “gmailtolcd” application. The “gmailtolcd” application fetches  information about new emails from gmail POP server and then displays the information about new emails on the mobile phone LCD.

I contributed the code to add support for Nokia 6100 LCD in serdisplib library project. This is my first contribution to a open source project. I have been using open source stuffs from last 8 years. I had never thought that I would ever get involved in contributing to a OSS project. It was an amazing experience to see my name in “AUTHORS” file shipped with serdisplib package :).

gmailtolcd.py code listing

# GmailToLCD version 1.0
# Opens Gmail (http://www.gmail.com) mailbox and displays information
# about arrival of new mails on Nokia 6100 (S1D15G10 controller) LCD
# using serdisplib (http://serdisplib.sourceforge.net) library.
# Author:
# 	Abhishek Dutta
# 	thelinuxmaniac@gmail.com
# 	http://abhishekdutta.org
# 	Aug 15, 2007
# *************************************************************************
# * This program is free software; you can redistribute it and/or modify
# * it under the terms of the GNU General Public License as published by
# * the Free Software Foundation; either version 2 of the License, or (at
# * your option) any later version.
# *
# * This program is distributed in the hope that it will be useful, but
# * WITHOUT ANY WARRANTY; without even the implied warranty of
# * General Public License for more details.
# *
# * You should have received a copy of the GNU General Public License
# * along with this program; if not, write to the Free Software
# * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
# * 02111-1307, USA.  Or, point your browser to
# * http://www.gnu.org/copyleft/gpl.html
# *************************************************************************
# Revision History
# 	- Sep. 03, 2007
#		The GMAIL POP server considers the emails in "Sent Mail" folder (ie: the email messages
#		you send from gmail) as new messages. Hence, this script filters out all the new (not actually)
#		messages whose "From: " field email address matches the email address of the mailbox
#		being checked. This modification was made to only show the new mail messages arriving in the
#		mailbox.
# Copyright (c) 2007 by Abhishek Dutta

import poplib				# for pop mailbox access
import Image, ImageFont, ImageDraw
import sys					# for accessing argv[]
import re					# for regular expression matching
import os					# for os.system()
import time					# for sleep()		

if (len(sys.argv) < 3):

	print "GmailToLCD version 1.0"
	print ""
	print "Usage: $ python gmailtolcd.py USERNAME PASSWORD"
	print ""
	print "View README file for details"

	print "GmailToLCD\tver. 1.0"
	os.system("./multidisplay -n n6100 -f app_template.png")
	print "Querying mailbox ..."

	# Gmail POP3 access requirements
	pop_gmail   = 'pop.gmail.com'
	username    = sys.argv[1]
	password    = sys.argv[2]
	port        = 995

	# time (in seconds) to delay between each mailbox query
	delay       = 60

	# Add string "@gmail.com" if not supplied by user
	if not(username.endswith('@gmail.com')):
		username = username + "@gmail.com"

	# regular expression for matching "From: " and "Subject: "
	# fields in the new retrived email
	pat_from = re.compile('From:*')
	pat_subject = re.compile('Subject:*')

	# loop until user presses Ctrl + C key
	while 1:
		print "Checking for new message ...\t",
		# access the gmail inbox using POP3 SSL
		# NOTE: The details of latest email (from, subject)
		# message will be shown on the LCD
		mbox = poplib.POP3_SSL(pop_gmail,port)
		numMessages = len(mbox.list()[1])

		if not(numMessages == 0) :
			# Counts the new mails in 'Inbox' folder
			new_msg_count = 0;

			print "Total ",str(numMessages)," new messages. (in Inbox & Sent Mail)"
			# Query all the messages from server
			for i in range(numMessages):
				for j in mbox.retr(i+1)[1]:
					# extract the matching lines
					m1 = pat_from.match(j)
					m2 = pat_subject.match(j)
					#print j
					if m1:
						# print j
						# index of first occurence of inverted comma "
						a1 = j.find('"',0,len(j))
						# extract the name of sender which begins after inverted comma
						name = j[(int)(a1+1):(int)(a1+15)]

						# Gmail POP server sends the new messages in
						# "Send Mail" folder as new mails to this script
						# Hence, discard messages whose "From" field
						# indicate the user executing this script
						pos_st_em = j.find("<",0,len(j))
						pos_ed_em = j.find(">",0,len(j))
						from_email_addr = j[(int)(pos_st_em+1):pos_ed_em]
						if not(from_email_addr == username) :
							print "\tNew Email in Inbox - From: ",name,"\t",
							new_msg_count = new_msg_count + 1;
							# the message received belongs to
							# "Sent Mail" folder
					elif m2:
						# Find the index of space between 'Subject:' and the subject
						a1 = j.find(" ",0,len(j))
						a1 = a1+1
						# MAX CHARS in line 1 of LCD 'Subject' field = 13
						line1 = j[a1:(int)(a1+13)]
						# MAX CHARS in line 2 of LCD 'Subject' field = 21
						line2 = j[(int)(a1+13):(int)(a1+13+21)]
						print "Subject: ",line1,
						print line2

			# Display alert if new message has arrived
			# in 'Inbox' folder only
			if not (new_msg_count == 0) :
				# Open the template image file
				im = Image.open("app_template.png")
				draw = ImageDraw.Draw(im)

				# use a truetype font
				# NOTE: These font's must exist in the directory from
				# which gmailtolcd.py is being executed
				# Liberation Mono True Type Font (GPL Font release by Redhat)
				font = ImageFont.truetype("LiberationMono-Regular.ttf", 10)
				font12 = ImageFont.truetype("LiberationMono-Regular.ttf", 12)

				# append a '0' to message count
				if numMessages < 10 :
					msg_count = "0"+str(numMessages)
					msg_count = numMessages

				# Write no. of new mails to image
				# MAX CHARS = 2
				draw.text((109, 62),str(msg_count) , font=font12,fill=228)
				# Write name of sender to image
				# MAX CHARS = 13
				draw.text((38, 80), name, font=font,fill=228)

				# Write subject to the image
				# MAX CHARS (Total) 34
				# line 1 of subject field MAX CHARS = 13
				draw.text((48, 100), line1, font=font,fill=228)
				# line 2 of subject field MAX CHARS = 21
				draw.text((2, 114), line2, font=font,fill=228)

				del draw
				#write new the image to file
				im.save("gmailbox.png", "PNG")
				print ("Updating LCD display")
				os.system("./multidisplay -n n6100 -f gmailbox.png")
				#new messages in "Send Mail" folder but not in "Inbox"
				print "No New Messages in 'Inbox' folder"

			print "No New Message in 'Inbox' and 'Send Mail'"
		print "Sleeping for",delay,"seconds ..."
		except (KeyboardInterrupt, SystemExit):
			# show BYE message in LCD before exiting
			os.system("./multidisplay -n n6100 -M 'Bye ! Bye !'")
			# reset the display before exiting
			print("Resetting LCD display ...")
			os.system("./multidisplay -n n6100 -Q")

Written by abhishekdutta

August 30, 2010 at 2:08 pm


Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s