3
Contents
Purpose of this Guide.......................................................................................................... 4
What Is Python?.................................................................................................................. 4
Additional Python Documentation ..................................................................................... 4
Getting Started .................................................................................................................... 5
First Program: “Hello, World!” ...................................................................................... 5
Python Commands in the Digi Command-Line Interface .................................................. 6
python ............................................................................................................................. 6
set python........................................................................................................................ 7
Loading Python Programs onto a Digi Device ................................................................... 8
Using modulefinder.py to Determine Files to Load ....................................................... 8
Using digi_build_zip.py to Automatically Build a zip File............................................ 9
Recommended Distribution of Python Interpreter............................................................ 10
Python Module Reference................................................................................................. 10
Fully Supported Python Built-In Modules.................................................................... 10
Python Modules with Digi-Specific Behavior.............................................................. 10
os............................................................................................................................... 11
random ...................................................................................................................... 12
re ............................................................................................................................... 12
socket ........................................................................................................................ 12
termios....................................................................................................................... 22
thread and threading.................................................................................................. 24
time ........................................................................................................................... 24
xbee_sensor............................................................................................................... 25
zigbee ........................................................................................................................ 30
File System Access ....................................................................................................... 32
Sample Programs .............................................................................................................. 33
GPS Demo .................................................................................................................... 33
Run the GPS Demo................................................................................................... 33
Files in GPS demo .................................................................................................... 34
Port Sharing Demo........................................................................................................ 36
Run the port sharing demo........................................................................................ 36
Files in port sharing demo......................................................................................... 36
ZigBee Sockets Examples............................................................................................. 37
Send “Hello, World!”................................................................................................ 37
Reading and Writing................................................................................................. 38
Non-Blocking I/O ..................................................................................................... 39
ZigBee Module Examples............................................................................................. 40
Perform a Network Node Discovery......................................................................... 40
Use DDO to Read Temperature from XBee Sensor ................................................. 41
Appendix A: python.zip manifest ..................................................................................... 42
Appendix B: modulefinder output for gps_demo.py ........................................................ 43
