Difference between revisions of "Python Code Samples"

From Lantronix Wiki!
Jump to navigation Jump to search
Line 78: Line 78:
 
   
 
   
 
  os.system('ctest sms-send ' + num + ' ' + msg)
 
  os.system('ctest sms-send ' + num + ' ' + msg)
 +
 +
 +
=== Setting up a menu on the serial port, and sending authenticated email ===
 +
This example makes use of several modules to access the serial port, ask the user for information, parse the result, and then send emails. All the modules used are already installed on the PremierWave firmware. To access the serial ports with use Pyserial, and to send emails we use smtplib which is part of the Standard Library.
 +
 +
#!/usr/bin/env python
 +
import serial
 +
import smtplib
 +
from time import sleep
 +
 +
Here we'll define a function to send emails. In this case we're using the Gmail servers. Notice that if you have 2-step verification enabled in your Gmail account, you'll need to use an App password instead of your standard password. See this document: https://support.google.com/accounts/answer/185833
 +
 +
def SendEmail(sender,recepient,subject,passwd,msg):
 +
smtpserver = 'smtp.gmail.com'
 +
smtpport = 587
 +
 +
s = smtplib.SMTP(smtpserver, smtpport)
 +
s.ehlo()
 +
s.starttls()
 +
s.ehlo()
 +
s.login(sender,passwd)
 +
s.sendmail(sender,recepient, 'To: ' + recepient + '\n' + 'From: ' + sender + '\n' + 'Subject: ' + subject + '\n\n' + msg +  '\n\n')
 +
s.close()
 +
 +
Also define a function to read a line (separated by a carriage return) and return everything in that line but the carriage return. This can be useful in many projects.
 +
def receive_line(ser):
 +
buffer = ''
 +
 +
while True:
 +
buffer = buffer + ser.read(ser.inWaiting())
 +
sleep(0.5)
 +
 +
if '\r' in buffer:
 +
lines = buffer.split('\r')
 +
return lines[-2]
 +
 +
port = '/dev/ttyS1'
 +
baud = 9600
 +
timeout = 30
 +
 +
ser = serial.Serial(port, baud)
 +
 +
ser.write('Welcome to the serial emailer!\n\r')
 +
ser.write('Please enter your Gmail email address (as sender)\n\r')
 +
sender = receive_line(ser)
 +
ser.write('From: ' + sender + '\n\rNow enter your Gmail password\n\r')
 +
passwd = receive_line(ser)
 +
ser.write('Got it, now enter the recepient of the email\n\r')
 +
recepient = receive_line(ser)
 +
ser.write('To: ' + recepient + '\n\rAlmost done here, enter a Subject for your email\n\r')
 +
subject = receive_line(ser)
 +
ser.write('Subject: ' + subject + '\n\rNow enter the body of the message. Finish with a blank line\n\r')
 +
 +
msg = ''
 +
 +
while True:
 +
line = receive_line(ser)
 +
 +
if line == '':
 +
SendEmail(sender,recepient,subject,passwd,msg)
 +
ser.write("Email sent, I'm done!\n\r")
 +
break
 +
else:
 +
msg = msg + line + '\n'
 +
 +
ser.close()

Revision as of 00:35, 18 November 2014

Code samples

Determining the type of device

Sometimes it is useful to find out what kind of device the script is running on, so that it can be deployed on multiple types of PremierWave devices without modifying.

The code below creates the pwDevice class. When an instance of this class is created, it will first find out what the MAC address of the device is. This can be useful to use as a unique identifier. It will then determine which type of device it is. As an example, it also creates a property called import_file which is a string with the path of the file used for importing configuration. This will become useful if a program needs to change configuration of the device.

import os.path
class pwDevice:
	def __init__(self):
		mac = commands.getoutput("ifconfig eth0| grep HWaddr | awk '{ print $5 }'").strip()			
		self.mac = mac.translate(None,':')
		if os.path.exists('/ltrx_user/pwxcr/pwxc_hspa_import.xcr'):
			self.type = "PremierWave XC HSPA+"
			self.import_file = '/ltrx_user/pwxcr/pwxc_hspa_import.xcr'
		elif os.path.exists('/ltrx_user/pwxcr/pwxn_import.xcr'):
			self.type = "PremierWave XN"
			self.import_file = '/ltrx_user/pwxcr/pwxn_import.xcr'
		elif os.path.exists('/ltrx_user/pwxcr/pwen_import.xcr'):
			self.type = "PremierWave EN"
			self.import_file = '/ltrx_user/pwxcr/pwen_import.xcr'
		elif os.path.exists('/ltrx_user/pwxcr/pwse1000_import.xcr'):
			self.type = "PremierWave SE1000"
			self.import_file = '/ltrx_user/pwxcr/pwse1000_import.xcr'
		else:
			self.type = "Unknown"

This example will create an instance, and log the MAC address to a file in the PremierWave's filesystem:

import logging
logging.basicConfig(level=logging.DEBUG, filename='pythonDebug.log')
if __name__ == '__main__':
	try:
		dev = pwDevice()
		logging.debug(dev.mac)
	except Exception, ex:
		logging.exception('Was not able to log')

Rebooting

The Lantronix application running on the PremierWave device safely handles the reboot cycle. You can kick off a reboot by importing XML into the configuration file that indicates to the application to start a reboot.

xml = '''<?xml version="1.0" standalone="yes"?>
<!DOCTYPE configrecord [  <!ELEMENTconfigrecord (configgroup+)>   
<!ELEMENT configgroup (configitem+,configgroup*)>   
<!ELEMENT configitem(value+)>   
<!ELEMENT value (#PCDATA)>   
<!ATTLIST configrecord version CDATA #IMPLIED>   
<!ATTLISTconfiggroup name CDATA #IMPLIED>   
<!ATTLIST configgroup instance CDATA #IMPLIED>   
<!ATTLIST configitem nameCDATA #IMPLIED>   
<!ATTLIST configitem instance CDATA #IMPLIED>   
<!ATTLIST value name CDATA #IMPLIED>]>
<configrecord version = "0.1.0.0T0">
<configgroup name = "xml import control">       
<configitem name = "reboot">           
<value>enable</value>       
</configitem>   
</configgroup>
</configrecord>'''

import logging
logging.basicConfig(level=logging.DEBUG, filename='pythonDebug.log')
if __name__ == '__main__':
       dev = pwDevice()	
       try: 
	       f = open(dev.import_file,'w')
	       f.write(xml)
	       f.close()
       except Exception, ex:
	       logging.exception('Reboot')

Sending SMS from PremierWave XC HSPA+

Sometimes it might be useful to send a text message (SMS) from the PremierWave XC HSPA+. The example below calls the ctest utility to do so. Note that because it's calling a Linux command line operation, special characters such as spaces need to be properly escaped.

import os

num = '+15555551212'
msg = 'Hello\ from\ PremierWave\ XC\ HSPA+'

os.system('ctest sms-send ' + num + ' ' + msg)


Setting up a menu on the serial port, and sending authenticated email

This example makes use of several modules to access the serial port, ask the user for information, parse the result, and then send emails. All the modules used are already installed on the PremierWave firmware. To access the serial ports with use Pyserial, and to send emails we use smtplib which is part of the Standard Library.

#!/usr/bin/env python
import serial
import smtplib
from time import sleep

Here we'll define a function to send emails. In this case we're using the Gmail servers. Notice that if you have 2-step verification enabled in your Gmail account, you'll need to use an App password instead of your standard password. See this document: https://support.google.com/accounts/answer/185833

def SendEmail(sender,recepient,subject,passwd,msg):
	smtpserver = 'smtp.gmail.com'
	smtpport = 587
	
	s = smtplib.SMTP(smtpserver, smtpport)
	s.ehlo()
	s.starttls()
	s.ehlo()
	s.login(sender,passwd)
	s.sendmail(sender,recepient, 'To: ' + recepient + '\n' + 'From: ' + sender + '\n' + 'Subject: ' + subject + '\n\n' + msg +  '\n\n')
	s.close()

Also define a function to read a line (separated by a carriage return) and return everything in that line but the carriage return. This can be useful in many projects.

def receive_line(ser):
	buffer = 
	
	while True:
		buffer = buffer + ser.read(ser.inWaiting())
		sleep(0.5)
		
		if '\r' in buffer:
			lines = buffer.split('\r')
			return lines[-2]			
			
port = '/dev/ttyS1'
baud = 9600
timeout = 30

ser = serial.Serial(port, baud)

ser.write('Welcome to the serial emailer!\n\r')
ser.write('Please enter your Gmail email address (as sender)\n\r')
sender = receive_line(ser)
ser.write('From: ' + sender + '\n\rNow enter your Gmail password\n\r')
passwd = receive_line(ser)
ser.write('Got it, now enter the recepient of the email\n\r')
recepient = receive_line(ser)
ser.write('To: ' + recepient + '\n\rAlmost done here, enter a Subject for your email\n\r')
subject = receive_line(ser)
ser.write('Subject: ' + subject + '\n\rNow enter the body of the message. Finish with a blank line\n\r')
	
msg = 
	
while True:
	line = receive_line(ser)

	if line == :
		SendEmail(sender,recepient,subject,passwd,msg)
		ser.write("Email sent, I'm done!\n\r")
		break
	else:
		msg = msg + line + '\n'
			
ser.close()