Home

Manual - SNAP Portal Reference

Contents

1. 25 26 E EsetHook HOOK _STARTUE 20 O def startupEvent 29 This is hooked into the HOOK STARTUP event 30 global buttonState buttonTime gt d mt The file is read only m 0 a A mini toolbar provides buttons to E Save E Save As Open File Find Next 2 show path and Test SNAPpy Script Save The E Save button saves the script shown in the edit window If the script has never been saved before this button will be disabled greyed out and you will have to use the Save As button instead Auto completion of text requires that the synapse BuiltIn py file be present in your scripts directory This file is present when Portal is installed and you should not move delete or rename it Portal Reference Manual El Save As The Save As button is used when saving a script for the first time so you can give it a name or when you want to save a copy of an existing script to disk under a new name Clicking this button will cause a file dialog to appear allowing you to choose the directory and filename to be used for the newly created file Open File The Open File button can be used to change the file being edited in the text window below the toolbar Clicking this button will cause a file dialog to appear allowing you to choose the directory and file within that directory to load into the edit window Find The Find function does not have a toolbar button Like most text edit
2. If your network does not seem to be responding this is the first thing to check Although serial port including USB serial access is the most common case the Connect menu also supports remote connection to a SNAP Connect application assuming your PC has TCP IP connectivity for example Ethernet or WiFi If you click the Port pull down you will see that there is an additional option Remote Connection Connect to Port Connect to Port Port COM29 Le A Port Remote Connection gt el Remote Connection Progress COM29 ere PEA Progress Found SNAP Bridge Device on Port COM29 zeg META If you choose Remote Connection after clicking the Connect button you will see an additional options dialog not displayed when using serial port connectivity Remote Connection via SNAPconnect Remote Connection via SNAPconnect Address Address 192 168 1 97 Username se088 Username sessa Password TTT Password TILLI Geqnect Connect Cancel The SNAP TCP protocol is used with desktop PCs and embedded devices like the Synapse SNAP Connect E10 Gateway that are running the Python specific SNAP Connect 3 x library For more about this library refer to the SNAP Connect Python Package Manual and for more about the SNAP Connect E10 Gateway refer to the SNAP Connect E10 Users Guide Enter the correct IP Address of the E10 or PC that is running SNAP Connect and configured to a
3. A Broadcast Ping command seen by all nodes is also available in the Portal toolbar here E it dl Om Traceroute This action sends a SNAP traceroute packet to the current node A traceroute packet collects the SNAP network address and link quality of each node that it travels through to reach its destination For example a traceroute from Portal at address 00 00 0B to another node at address 00 13 8B might take the following path 00 00 0B to 00 2F A1 to 00 13 8B back to 00 2F A1 and finally back to 00 00 0B This path would be visualized in the Path pane as Path Portal 00 00 06 Bridge 00 2F A MeastCounter 00 13 88 96 Total Round Trip Time Sms The arrows represent a hop in the path where no link quality information needed to be collected The link between Portal 00 00 0B and the bridge node 00 2F A1 is a serial connection which has no link quality The 96 link quality shown in the example represents the link quality as received by node 00 13 8B when sent from 00 2F A1 Another way to describe it is the link quality shown is what the listening node heard from the sending node 20 Version 2 6 6 Lastly the Total Round Trip Time is the time it took for the bridge to send the traceroute request and then receive the response back You might notice that the time varies between traceroute requests to the same node This is due to external factors such as mesh network route discovery network collisions
4. s used There is a separate user manual for the SNAP Connect 3 x Python Library SNAP Connect allows you to monitor and control your nodes from remote locations using TCP IP networks There is a wealth of valuable information in the SNAP Hardware Technical Manual This document covers every jumper and every connector of every type of node included in the evaluation kit For your convenience much of the information available in the SNAP Hardware Technical Manual has been broken down into individual Quick Start guides For example there is a SN171 Proto Board Quick Start and a SN132 SNAP Stick Quick Start There is also a dedicated support forum at http forums synapse wireless com In the forum you can see questions and answers posted by other users as well as post your own questions The forum also has examples and Application Notes waiting to be downloaded You can download the latest SNAP Portal and SNAP Connect software from the forum The website forums also contain the latest documentation for all Synapse products A Version 2 6 6 2 A Portal Into Your Network Portal is a standalone software application that runs on any standard PC with Microsoft Windows 7 or higher Using a USB or RS232 interface it connects to any SNAP Engine in the SNAP Wireless Network becoming a user interface for the entire network A e i is used by default within Portal to generically represent a SNAP node is used
5. Clear Successful Cancel Above you can see the progress as the first of two nodes is uploaded After the first node has been sent a copy of the firmware Portal will automatically proceed with the next node in the set El Version 2 6 6 Multiple Node 2 Action Status SNAP Firmware Upload Completed Successfully Don t remove power to the device during this time McastC ounter Completed Successfully e AA A E Node Completed Successfully Ok Clear Successful Cancel Remember that for some nodes the node may not respond to inquiries for up to a little over two minutes Do not remove power from these nodes or manually reset them during this period or you will have to load new firmware into the nodes with a serial connection Portal Reference Manual 10 Menu Options The following sections discuss the menu options within Portal File Menu New Script The New Script menu option will allow you to open a new Code Editor window with a blank script This option has the same effect as using the 4 New Script button on the main toolbar Open File This menu option displays a standard open file dialog that will open a SNAPpy or Portal script to edit in a code editor panel This option has the same effect as using the Lal Open File button on the main toolbar Save SNAPpy Script When a code editor panel is currently active this option will save the current file This option has the same effect as using the
6. Generate Keeler V DOT UE 59 Change Portal e le 59 New COMMS Ua CON EEN 60 Open COMME URAL EE 60 Save COMMSULAUION EE 60 EXPO Node ist as EE 60 import Node Listas CS dad 60 SUECA SINAP MIMO nro 60 G BE EE 60 PortalReterence Ee ET EE 60 DIK ZOO SONS UI da A a a ica 60 SNAPPEIMO EE 60 SNAP USCIS GUIA dali 61 SNAP Reference Manual cias re a E 61 SNAP Sniffer Users GUIA deca 61 SNAP SUPPO FOLO EE 61 te E 61 Portal AP 62 Node Method E 62 leien get 62 PO Mal Tee ee EE 63 Contextual Vaal EE 65 1 Introduction Synapse Portal is a standalone software application that runs on a standard PC Using an RS232 or USB interface it connects directly to any node in a SNAP Wireless Network and becomes a graphical user interface GUI for the entire network Using Portal you can quickly and easily create configure deploy and monitor SNAP based network applications Once connected the Portal PC has its own unique SNAP Network Address and can participate in the SNAP network as a peer Portal can also remotely connect to your SNAP network over a TCP IP network to applications that incorporate the SNAP Connect 3 x Python Library The SNAP Connect 3 x Python Library allows you to develop configure and deploy SNAP applications over the Internet For more about this product refer to SNAP Connect Manual Instructions on how to connect to this product are covered later in this manual Along with this document there are several other doc
7. getColumn name getDottedNetAddr getHexNetId ping toggleResponding True refresh ping True toggleResponding True setColumn name value setNvParam id value setStdoutPortal linkQualityAsk linkQualityPercentVal macAsk netParamAsk reboot versionAsk Node Attributes Returns the current value stored for the specified column name Returns this node s network address as a string in the format HHA LAH Returns a string representing the node s network ID if known e g 0x1C2C PINGs the node Parameter toggleResponding determines how the result of the PING affects the Node Views and Node Info windows Queries the node for information to display in its Node Info tab Stores the specified value for the specified name ells the node to set the NV parameter d to the specified value ells the node to redirect its STDOUT to Portal s network address Whatever the node prints will appear in the Portal Event Log Deprecated Returns an integer value in the range 0 100 based on Deprecated Tells the node to reboot Deprecated Queries the node for its current version string The following are attributes bound to each node known to Portal i e visible in one of the Node Views Like the node methods these must be prefixed by a reference to the node you want to examine and a example an character For Version 2 6 6 print MyNode channel MyNode channel retur
8. 0 configparser 3 3 0 post2 cremod 1 7 NumPy 1 8 2 passlib 1 6 2 pycrypto 2 6 1 wxPython 3 0 1 pypiwin32 217 Python 2 6 6 Pylnstaller 2 1 Table of Contents 1 Arodu E E E E A 1 Start with an Evaluation Kit Users Guide 1 ADOUE TAS Manda 1 Other Important DOCUMENTATION ooocccccnnccnncnnncnncnnncnnnonanonnnnanonnnonconnonnrnnnonnnonnnnnnrnnnonarnnnonanonnnnanoss 2 A Portal Mo ne 3 acido A nn a Eo on A 3 AUNAR 4 The Portal ENVIFONMEON E is 10 Navigating Within Po alii 11 PUE CO WA MENU ada 11 ein KE 11 Tabbed WINdOW Setenta 11 EIERE EEN 11 FSI UNG egene 12 Co El E 12 ME PO NI e ROO OA 12 POS jo PP o o e Pene 13 OA e 16 SNAP Node Conte de Nucia titi 19 Network Configuration Parametere 19 Noda WI Task Nit 19 ETa 20 O EE 20 A 21 L Upload SNAPpy Image 21 Ld Erase SNAP DY ln 22 Lei EXPO SNAP OY lant 22 art Change Configuration Parameters c ccccccssccssscessscessccssscessscessecssecssssessecesecessessssensecentecsaeeens 23 d intercept Node OW CT EE 24 Gel A A 25 Rename Node nit 25 M REMOVE NOE ene 25 20 Beboot Nor es 25 d Upload Se E CR gun Te 25 Node Info SNAPpy Scripts Sechon 26 Portals Node TOO EE 27 A E E E 29 RENTA aT e 29 Ei Ee ug E 29 a ESC E E E E ee nee 30 connect Serial Port Disconnect Serial Port 30 I Broadcast nn be 31 mrt Node Views 31 T E 31 Event Deeg EN BW Command Une 32 be Pa LOLE EE 32 Chann IVI OE eree 33 EI 36
9. 03 F9 C6 T Frost 03 68 99 E 7 Vasquez 04 CB 47 Drake 04 00 9D 7 Hicks 06 73 95 In this example network we can see that node 03 E8 99 routes packets through the bridge node 03 F9 C6 to reach Portal while node 04 00 9D is routed through node 04 CB 47 to reach Portal As nodes are spread apart and it is necessary for nodes to hop through other nodes the tree view can become more and more branched This view enables you to see a snapshot of how nodes route messages through each other through the SNAP mesh network The last control in the Node Views toolbar is a drop down selector box that lets you choose to see only the Active Nodes or All Nodes Both views are identical as long as all nodes are online and communicating With the filter set to show All Nodes when Portal sees that a unit has stopped responding it is grayed out in all three views Node Views ml AT Al Nodes 3 nodes Node Network Address Device Portal 00 00 01 co Node 00 38 CA E Bridge JE CD BG Micast With the filter set to show only Active Nodes when Portal sees that a unit has stopped responding it is completely removed from all three views Node Views gt Elia e Active Nodes e 2 nodes Node Network Address Device Portal 00 00 01 e Bridge SE CD B6 Acast Screenshots are only shown for the Report View but both views behave similarly Version 2 6 6 5 SNAP Node Configuration The configuration of an indi
10. Application From C Users btice Downloads Portal setup 2 4 39 exe an JL Gei V Always ask before opening this file aa While files from the Intemet can be useful this file type can P potentially harm your computer Only run software from publishers The warning is harmless and you should click Run or Continue Anyway to proceed with the installation Synapse Portal is already installed Click OK to remove the previous version or Cancel to cancel this upgrade et The following screenshots assume you are installing version 2 6 6 Your precise Portal version number might be different from 2 6 6 but the process should be very similar 4 Version 2 6 6 A dialog box similar to the following will appear your version number likely will be higher CG Synapse Portal 2 6 6 Setup Welcome to the Synapse Portal 2 6 6 Setup Wizard This wizard will guide you through the installation of Synapse Portal 2 6 6 Itis recommended that you dose all other applications before starting Setup This will make it possible to update relevant system files without having to reboot your computer Click Next to continue Press Page Down to see the rest of the agreement Your use of the Portal Software and SNAP Software is subject to the 3 terms and conditions of the license agreement Agreement posted at apse wreless com portallcense If you accept the terms of the agreement dick I Agree
11. BASIS WITE Sample SNAPpy file for Evaluation Kit Boards Bridge End Device E Press the gelect switch on any device to increment counter on all Pm Use Synapse Evaluation Board definitions from synapse evalBase import Once the script is chosen Portal will erase any previous script and then upload the new script to the node d II Portal Reference Manual MeastCounter SNAPpy Upload Uploading McastCounter iw See details When the entire script has been uploaded to the node Portal will automatically reboot the node which in turn will cause the node to execute any script code contained within the HOOK_STARTUP event handler of that script If you click the name of a script within the Node Info window an editor window containing that script opens For the Portal node this action is named Change Portal Base File The Portal node is not restricted to SNAPpy scripts and can run any Python 2 6 script Therefore the button opens a standard Windows dialog allowing you to browse to the Python script of your choice For more information about SNAPpy scripting please consult the SNAP Reference Guide La Erase SNAPpy Image Clicking this action will erase any currently loaded and running script from the selected node For the Portal node this action is named Clear Portal Base File l4 Export SNAPpy Image This toolbar option allows you to export the SNAPpy script as a SNAPpy Export SPY file The SPY files
12. E Je Firmware Image Open Progress Please select a firmware image Click the Open button next to the Firmware Image field and choose the version of software that you wish to upgrade the unit to If you choose an invalid firmware image then you might see an error message like ES Version 2 6 6 Examples of invalid files would be sniffer firmware images or ATmega128RFA1 SNAP versions prior to 2 4 32 The following screenshot shows an example of upgrading the firmware on an RF200P81 module your platform may be different SCH firmware Search firmware D f i Organize e New folder Ce Favorites BZ Desktop de Downloads E Recent Places ay Libraries Ex Documents al Music Pictures i Synapse E Videos Name A sniffer ATmegal28RFR2_AES128_SnapV2 5 2 sfi ATmegal284RFR2_AES128 SnapV2 5 2 sfi RFLOO_AES128_SnapV2 5 0 sfi RF100_debug_AES128 SnapV2 5 0 sfi _ RFLOO_debug_SmapV2 5 0 sfi RFLOO_SnapV2 5 0 sfi RF200_AES128 debug SnapV2 5 2 sfi _ RF200_AES128 SnapV2 5 2 sfi RF200_debug_SnapV2 5 2 sfi Date modified 10 6 2014 2 15 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM 10 6 2014 12 33 PM File folder SFI File SFI File SFH File SFL File SFI File SFI File SH File SFL File SF File 50 KB 50 KB 4
13. KE Save button in the Code Editor toolbar Save SNAPpy Script As When a code editor panel is currently active this option will save the current file as a different filename This option has the same effect as using the ES Save As button in the Code Editor toolbar Export SNAPpy Script This menu option will display the following dialog box Export SNAPpy Image Please select the SNAP py script you would like to export HolidayBlink py HolidayBlinkDK200 py HolidayLightShow py HolidayLightShowDK200 py weTests py 12cTests5TM32W108 py ledCycling py ledToggle py LinkQualityRanger py ManyMeter py ManyMeterDK200 py MC13224 ledCycling py MeastC ounter py Node Platform NV 41 RF200 SNAP Core Version 2 6 2 with AES 128 SNAP Hardware Type RF200 OK Cancel Preview This option is similar to the Let Export SNAPpy Image button on the Node Info panel toolbar but this dialog allows you to manually specify the platform and version to use when exporting the script El Version 2 6 6 Preferences The preferences dialog box allows you to configure different options on how you would like Portal to behave tl Preferences Rap Ping TTL 5 Ping Response Spread 7 Data Logger Limit 1000 RPC Response Timeout g00 Link Quality Convert link quality from dBm to percent Show Result v Display the return value when clicking on a function Auto Port Scan Automati
14. NN 37 E Le As e e e eo ll 38 But EGITO tintos 39 E PP o A 39 E Save Ae 40 sal e A o PU o eee ee ee ee eee eet 40 A nn pun A 40 O a 40 MM STOW DEAL ridad 41 W Test O ad S16 0 Meron eee nee eee Rn Caen TE ee er ere Cer ne ere ne ree te ree 41 IO DO dC SIO UC EC 42 Firmware Updates via Direct CONNECTION csccscsccccccscsccccccscsceccccscnceccececscescececs 44 OD ane FEN E e 44 astane NEw dn 44 TOUDI OO UNE iaa 45 10 Firmware Updates via Remote Connection ccccscsecscsccsceccscnccscnccccncsccnceccscsceeces 46 ite Tiet Tun 46 Installing new Firmware One Node at a tiMe ccccccccccsssseccceceessecceseeeeeecceseeeeeecseseegeeceeeseegnes 46 Installing new Firmware Multiple Nodes in a batch oooccccnconnnccnnnnnnanocnnnnonanacannnonanoconnnonons 50 Menu ODTIONS EE 52 BICHER 52 Klee lee 52 TEE 52 Save SINAPDY EEN ee 52 SAVE SNAPPY SCIDUAS EE 52 EXPO SNAPPY CDE 52 A CS anie aa vac mienharaetu cate tone E OE E amen EE E eens 53 aaa 54 VIEW Menta eii 54 EE 55 Rearrange to Detail TE 55 Opus Mel A 55 Belt e EE 55 PIM e ere EE 55 UA O E a N A 55 Factory Default NV Parase td a A E ENAN 55 Efase SNAPPY Tae EE 55 COM MEUFE EE 55 SECWOTKINE DIECON EE 56 Restore Original Working Directoy eenn ENEE 58 Configure Python Library Directonm 58 Confeure Crypto SEUNG EE 58 Clear GUICOMPONEnt AITOR tees ean ida 59 NEIWOFK MEN 59 Broadcast PING nidad 59 FRANO GES aa A N 59
15. Node Info SNAPpy Scripts Section The right hand side of the Node Info tab shows a tree view of all the callable functions within that node Mode Info A gt ld Lila 2 ba Na A McastCounter Kan Firmware Version 2 6 2 with AES 128 SNAPpy Modules Platform RF200 Builtin Network Address 5E CD B6 evalBase McastCounter buttonEventipinNum eet lt GPIN changeLedPattern Image CRC OxDAS6 default TimerHandler lt 10ms Timer Image Size 4357 bytes 775 doEverySecond License AB incrementCountt reportButtontount setButtonCount newCount Network ID Geer startupEvent lt Startup Path timerlO00msEvent currentMs lt 100ms Timer H sevensegment MAC Address 00 1 0 2C 1 B 26 5E CD Bb Device Image McastCounter Channel 4 No path information collected Info In your Portal script use remoteNlode setColumn name value to display information here The Builtin functions represent the core SNAPpy feature set and are functions that can be called from Portal even when no user script has been uploaded into the node These same functions are also always available for use within scripts Refer to the SNAP Reference Guide for details on these built in SNAPpy functions The other branch es of the tree view show s the uploaded script s name with all of the callable functions implemented by that script If the script imports other scripts each imported script s functions will be shown under tha
16. PY File hardTime py 9 30 20149 10AM PY File 2 hexSupport py 9 30 2014 9 10 AM PY File Libraries LIS302DL py 9 30 2014 9 10 AM PY File LTC2412 py 9 30 2014 9 10 AM PY File Lal 2 M41 TOOCAP py 9 30 2014 9 10 AM PY File a M41T81 py 9 30 2014 9 10 AM PY File a MC1321xHardTime py 9 30 2014 9 10 AM PY File MC13224 PWM ov 9 30 2014 9 10 AM PY File 4 File name Files of type Source py files can be SNAPpy scripts these go into your SNAP nodes or full Python files these can be loaded into your Portal Portal Reference Manual 29 A Portal configuration specifies things like which nodes are available in the network and which Python script is loaded as the Portal base file Portal configurations are saved in files having a SWN Synapse Wireless Network extension and are created using the Save All toolbar button or the Save Configuration As option from the Network menu S Save All This toolbar button will save any open modified scripts and initiate creation of an SWN file containing all currently active Portal settings The most recently saved configuration file will automatically be re loaded by Portal when it restarts Connect Serial Port Disconnect Serial Port This modal toolbar button is used to connect and disconnect from the attached bridge node Because the icon along with its tool tip changes when you connect or disconnect it also serves as a quick status indicator
17. Portal Reference Manual D 3 The Portal Environment Starting Portal for the first time displays a blank network configuration and a dialog asking what port to use to connect to the SNAP bridge device Be sure you have a SNAP bridge device connected and select it in the drop down window Press Connect once the bridge device is detected this is probably going to be USBO Portal is the desktop environment used to configure and deploy a SNAP network and it provides a user customizable interface to aid in developing your SNAPpy scripts Starting Portal for the first time shows Portal s default window configuration Synapse Portal default swn Workspace C Users john brewer Documents Portal te Vie Da Nela n De Ver Options Met Et Main Toolbar dia AAA ah O Node Views Node Info is 2 Active Nodes 3 nodes DADES da e A ADA Nod Network Add Device I Link lity Device T a E S ress Device Image ink Quality ae ype Hi cks z Porta 00 orta k er s gt F Ripley 03 F9 C6 67 None AN PO O TEE WER OES LR E Hicks 16 73 05 nie es E plattorm RF200 2 Builtin Network Address 06 73 95 MAC Address 00 1C 2C 1A D6 06 73 95 Device Image Image CRC Image Size License Permanent Channel 14 Network ID OxFL5E NodelnfoPane No path information collected Info In your Portal script use remoteNode setColumn name value to display information here Event Log t y y Time 2015 10 27 14 25
18. Some SNAP nodes can be configured to perform this additional Vere ate Gore es packet validity check Nodes without this feature or without this feature enabled will simply ignore the additional information This option reduces the maximum packet payload size by two bytes Require CRC on When checked Portal will ignore any RPC or multicast RPC packets it receives that RPCs do not have a valid RPC CRC appended to them When checked Portal will reduce its maximum packet size by two bytes to accommodate a packet level CRC that can be applied to all radio traffic by nodes with firmware that supports this feature This CRC covers more than the payload CRC that Portal can append or require based on the previous two checkboxes in that it includes packet header information in addition to the packet payload If you check this checkbox Portal does not change the contents of any message it sends Packet CRC as the packet level CRC is applied only to radio traffic But if a radio node has the packet level CRC enabled required and this checkbox is not checked Portal may send serial packets that are too large for the radio nodes to be able to forward This will especially be true for script or over the air firmware uploads This feature was added in Portal and SNAP version 2 5 Checking this checkbox will not break compatibility with earlier SNAP versions It will simply result in Portal generating packets that are two bytes smaller than
19. are used to save the current local copy of the script as a compiled script ready to upload to a node For example SNAP Connect cannot upload py files because it requires the scripts to already be compiled This option allows you to create the necessary SPY file for SNAP Connect to upload to your nodes Another use for the SPY files is if you want to provide a script to another user of Portal without giving them the source code The Export SNAPpy Image action is not available for the Portal node because Portal can run Python 2 6 scripts that are not valid in another node E Version 2 6 6 Change Configuration Parameters Clicking this task will display the following tabbed dialog box McastCounter Configuration Parameters Network ID 01602 Channel A Radio Unicast Retries g Radio LO Threshold 497 Cancel Refresh Reboot After Apply From this dialog box you can view and edit the Configuration Parameters of the current SNAP Node Configuration Parameters are also known as Non Volatile NV Parameters and they are described in detail in the SNAP Reference Manual You can see the different NV Parameters broken down by category by clicking each of the six named tabs within the dialog box The Network tab lists parameters relating to general radio operations The Device tab lists parameters relating to node identity and som
20. can use the Refresh Node Info function to confirm that the upgrade process has been successful For example here is the Node Info pane of an RF200 node before it was upgraded 48 Version 2 6 6 Node Info x Daa al BEB Gsxee McastCounter Firmware Version 2 4 32 with AES 128 Out of Date 5 Platform RF200 Network Address 04 21 F4 MAC Address 00 1 C201 4 D604 21 F4 Device Image McastCounter Image CRC 0x7 AAA Image Size 4318 bytes 7 License Permanent Channel 4 Network ID Oxi CAC Path BuiltiIn evalBase McastCounter buttonEvent pinNum isSet lt GPIN changeLedPattern default TimerHandler lt 10ms Timer doEverySecond iIncrementCount reportButtontount setButtonCount newCount startupEvent lt Startup timerl00msEvent currentMs lt 100ms Timer GI sevensegment The following screen capture shows the same panel after doing an upgrade and after doing a Refresh Info to update the GUI Node Info ASPE aa xX ae McastCounter TS W Firmware Version 2 5 3 Debug with AES 128 Platform RE200 Network Address 04 21 F4 MAC Address 001 20 14 D0 04 21 F4 Device Image Image CRE Image Size License Permanent Channel Network ID Ox CAC Path Builtin Notice that the firmware revision and in this case the firmware capabilities have changed Before the upgrade the node was running a version 2 4 32 build of SNAP After the u
21. have specified an icon for the node Import Node List as CSV This option loads a text file of comma separated values either adding to replacing the nodes in your All Nodes view depending on whether you check the Clear Network First checkbox on the dialog The CSV file should include a header and three pieces of data for each entry Node Name SNAP Address and file path to an icon file if you have specified an icon for the node Launch SNAP Sniffer The SNAP Sniffer is an external program that helps to analyze and debug your SNAP network Please consult the SNAP Sniffer Users Guide for detailed information Help Menu Portal Reference Manual This option will open the Portal Reference Manual this document in your default PDF viewer DK 200 Users Guide This option will open the DK 200 Users Guide in your default PDF viewer SNAP Primer This option will open the SNAP Primer in your default PDF viewer 60 Version 2 6 6 SNAP Users Guide This option will open the SNAP Users Guide in your default PDF viewer SNAP Reference Manual This option will open the SNAP Reference Manual in your default PDF viewer SNAP Sniffer Users Guide This option will open the SNAP Sniffer Users Guide in your default PDF viewer SNAP Support Forums This option will open the Synapse Support Forums website in your default web browser This website is the preferred place to ask any technical questions you may have while using our
22. in a crowded channel random backoff or waiting for another node to finish transmitting The Traceroute action is not available for the Portal node gt Refresh Clicking this action will poll the node for the information shown on the Node Info tab Check the Event Log for confirmation of Refresh activity The Refresh action is not available for the Portal node L4 Upload SNAPpy Image Clicking this action will display a dialog box allowing you to choose which script to upload into the node McastCounter SNAPpy Image Please select the SNAPpy image you would like to upload This operation is service affecting ledCycling py a ledToggle py LessThan py LinkQualityRanger py ManyMeter py Math py mb_bridge py mb_light_lib py mb_mesh_board py mb_minimum py mb_switch py MC13224 ledCycling p OK Cancel Help Preview A node can only contain one script at a time but the script can actually consist of multiple source files using the Python import functionality If you are not sure which script you want you can click the Preview button to take a quick look at the currently selected script Click OK when you are done looking at it McastCounter py Copyright 2011 Synapse Wireless Inc A Subject to your agreement of the disclaimer set forth below pern BY USING ALL OR ANY PORTION OF THIS SNAPPY CODE YOU ACCEPT AND 2 THE CODE IS PROVIDED UNDER THIS LICENSE ON AN AS 15
23. in the Portal Event Log Lighter hello world In the above example the script did a print hello world The node name Lighter was pre pended by Portal providing an easy way to see which node printed the text You must specify which types of messages you want your node to redirect to Portal using the Preferences window available from the File menu in Portal You can have your nodes send STDOUT error messages both or neither to the Portal log If you have both the Intercept STDOUT and Intercept ERROR checkboxes unchecked on the Preferences window no output from the node will be redirected to the Portal log 24 Version 2 6 6 The Intercept Node Output action is not available for the Portal node Anything printed by Portal will always appear in the Event Log En Change Icon You can replace the default icon Portal uses to represent each node with your own 60x60 PNG file This might be used to make it easier to track which nodes are serving what purpose The graphic is only associated with the node while Portal is aware of the node If you remove the node from the network you will need to reassign your graphic icon to it If you save a configuration that includes a node for which you have changed the icon that icon will be restored when you reload that configuration data Rename Node The default logical name for a node with no name provided by the user and no script loaded is Node for the first one found
24. newer than 2 2 16 After choosing the correct firmware image to load press the Upgrade button to begin Follow the instructions given in the dialog which may have you restart power cycle or reset your device to complete the process Restart Please restart your device to start the upgrade New firmware will be sent to the SNAP node over the serial connection 5 SNAP Node Flash Upgrader Port COMS Firmware Image C Program Files x66 Synapse Portal firrmware RF200_AES128 SnapV2 5 3 sf1 Progress Press upgrade to start h The upgrade completed successfully Would you like to upgrade another Choose Yes to download the same image into another SNAP node or No to return to Portal Troubleshooting There is a possibility of interruption power serial connection etc in the midst of the upgrade process This may leave the SNAP node in a state where the SNAP application firmware is unusable However upgrade is still possible since the SNAP boot loader firmware is protected in a locked region of the node Simply restart the upgrade process This time you ll need to manually select the appropriate COM port for RS232 communication since Portal won t be able to detect a running SNAP Engine on the serial port Portal Reference Manual ES 9 Firmware Updates via Remote Connection The previous section covered the most common case upgrading a node that is directly connected to Portal Some SNAP platforms can
25. products About The about dialog displays information about the current version of Portal you are running Portal Reference Manual 11 Portal API This section details the API presented to Portal Scripts The Command Line window of Portal also has access to this API When a node makes a call to a Portal function two variables are set within the scope of the Portal function that allow easy identification of and access to the calling node The remoteNode variable is set to the calling node s node object and the remoteAddr variable is set to the address of the calling node These variable values persist only for the duration of the called function They can be used to invoke node methods or read node attributes on the node or to send messages or commands back to the node Node Methods The following are functions bound to each network device node known to Portal i e visible in one of the Node Views or appearing in the Node Info window To invoke one of these methods you must prefix the desired function name with a variable containing a reference to the node that you want to invoke the function on followed by a MyNode getDottedNetAdar aon character For example In order to get a reference to a node you can use the remoteNode property in your Portal script The remoteNode variable contains a reference to a node object any time Portal is running a function invoked by an RPC call from another node
26. this tool you can invoke the Device API on all discovered and active devices This is useful for testing and debugging commands interactively before incorporating them into Portal scripts Most of what can be done through the command line can also be done through the other parts of the GUI For example you can type the command roe HKH eet reboot Or you can just click on the node s reboot function in the Node Info tree Within the Command Line pane you can use the up and down cursor arrows to re select previously executed commands Position the cursor on a previously executed command and press the lt Enter gt key and it will be re displayed but not executed yet at the bottom of the Command Line window You can then edit the recalled command using the left and right cursor keys to move the cursor horizontally within the command When the command line has been edited to your liking press the lt Enter gt key again to execute it To re execute the most recently executed command as is no changes just press the keys lt Up gt lt Enter gt lt Enter gt The first lt Enter gt chooses the command for editing and the second lt Enter gt executes it Within the Command Line window you can type shell help to learn more of the tricks the Command Line window supports LC Data Logger The Data Logger window gives a strip chart view of a set of values plotted over time It is very simple for scripts in nodes to ad
27. to do this Revert an SN132 SNAPStick that has been set to respond as a irtual COM port back to responding as a USB device For most users there will never be a need to do this There are several commands that are deprecated or for Synapse internal use only They are listed here only for completeness you should not be calling these functions Version 2 6 6 SNAPpyErrorDecode node Synapse use only errorMsg Contextual Variable Within the scope of a running function in Portal you can use the remoteAddr variable to determine the SNAP address of the node that invoked the running function This serves much the same function in Portal that the rpcSourceAddr function serves in SNAPpy scripts at the module level If the function is invoked from the Node Info pane in Portal or by a scheduled event the remoteAddr variable will contain None Portal Reference Manual
28. within the Portal user interface to represent Portal itself Once connected Portal provides the capability to interactively build an intelligent wireless network You can e Discover new SNAP Devices e Upload intelligence to those Devices over the air using SNAPpy scripts e Customize Portal to suit your specific application Interactively you do all this within Portal observing the results immediately Intelligent the network is purpose built for your application with the ability to monitor and conditionally control things connected to it Throughout this manual the term Portal PC is used to refer to the Windows PC that Portal is running on Installing Portal You ll find the latest version of Portal along with the latest SNAP firmware and documentation on the Synapse Support Forum at https forums synapse wireless com showthread php t 9 Portal Reference Manual E Running Setup Download and run the Portal installer Portal setup 2 6 n exe where n indicates the latest release version You should unplug any Synapse devices from your PC before installing so that device drivers can install properly Depending on the version of Windows running on your PC you may get a warning dialog similar to the following somewhere in the installation process Open ie secur warra Do you want to run this file Name C Users btice Downloads Portal setup 2 4 39 exe Publisher Synapse Wireless Inc Type
29. 00 2015 10 27 14 25 00 2015 10 27 14 25 00 2015 10 27 14 25 00 2015 10 27 14 25 00 2015 10 27 14 25 00 2015 10 27 14 26 26 2015 10 27 14 26 40 Ready Event ll ZOULIJ IO L200 TU FAA INL OStkUIILEI NV PARAM McastCounter NV PARAM McastCounter NV PARAM McastCounter NV PARAM McastCounter NV PARAM McastCounter NV PARAM McastCounter STATUS McastCounter Changing device name from McastCounter to Hicks T RA VIER wore Vendor Confi None Multi cast Se None UARTO Defau None UARTI Defau None Default Radio None CSMA Setting None INFO ER www synapse wireless com Event Log Pane RPCs in Queue 0 Connected SNAPstick0 38400 From this user interface you can start viewing and configuring your SNAP network The nodes in your network are displayed in the Node Views window as they start responding to queries made by Portal Selecting a node by clicking it in the Node Views window will display detailed information about that node in the Node Info window Finally the Event Log window displays event messages about things that have occurred in the system and in the SNAP network More information on these windows and their functions is provided later in this document Version 2 6 6 Navigating within Portal Portal is straightforward to use However since it is extremely customizable by the user your screen layout may not always match the screen shots in this manual For that reason it is important to understand the f
30. 1 KE 44 KB 39 KE 36 KB 54 KB 49 KB 53 KE RF200_SnapV2 5 2 sfi 10 6 2014 12 33 PM SF File 48 KE Bb Computer F200 sna F266 AES128 de E Windows _OS C W I r DH ra oe oe em em e em rm es mb jm rm e 10 6 2014 12 33 PM SH File Press upgrade to start Upgrade Portal Reference Manual Click the button labeled Upgrade and wait for the upgrade process to complete The progress bar will fill in as the SNAP firmware image is transferred over to the node and stored in the temporary holding area The message displayed under the progress bar will change as the firmware is loaded 5 Over The Air SNAP Node Flash Upgrader lo meza Firmware Image C Program Files 86 5ynapse Portal firmware RF200P8 Open Progress File transfer in progress Over The Air SNAP Node Flash Upgrader Lo E aa Firmware Image C Program Files 86 5ynapsel Portal firmware RF200P8 Open Progress wr Programming may take up to 2 minutes after transfer completes 5 Over The Air SNAP Node Flash Upgrader Lo E aa Firmware Image E Program Files x86 Synapse P ortal firmware RF200P8 Open Progress we mm Don t remove power to the device during this time After the image is transferred the node will reprogram its own FLASH such that the previous SNAP firmware image is overwritten with the new one This will take several seconds over two minutes for some nodes You
31. 2a x14 x3b x44 xd7 x3c x70 xd2 x61 x96 x71 x91 xf5 x8f x69 xb9 or as some combination of the two e g xfbOF x06 xe4 xfOForty Two Standard security practices suggest you should use a complicated encryption E Version 2 6 6 key that would be difficult to guess If your hex values include characters that can be displayed Portal will convert them to displayable characters when you next view the key For example x37 would display as 7 If your encryption key includes both an apostrophe and quotation marks Portal will display the apostrophe as an escaped character the next time you view the key Crypto Settings Crypto Settings Enabled Encrypt and decrypt all packets Enabled Encrypt and decrypt all packets Type Basic Type Basic Key Apostrophe FZ Key Apostrophe FL Reconfigure Reconfigure all listed nodes with above settings Reconfigure Reconfigure all listed nodes with above settings cancel OK Cancel If you check the Reconfigure checkbox Portal will set all available nodes to use the same encryption settings using traceroute information to work from the outer edges of your network in Refer to the SNAP Reference Manual and SNAP Users Guide for more information about encrypted SNAP networks Clear GUI Component History Starting with Portal version 2 5 text fields maintain a history of the values that have been entered in them to facilitate making a particular func
32. 7398 fax www synapse wireless com License governing any code samples presented in this Manual Redistribution of code and use in source and binary forms with or without modification are permitted provided that it retains the copyright notice operates only on SNAP networks and the paragraphs below in the documentation and or other materials are provided with the distribution Copyright 2008 2015 Synapse Wireless Inc All rights Reserved Neither the name of Synapse nor the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission This software is provided AS IS without a warranty of any kind ALL EXPRESS OR IMPLIED CONDITIONS REPRESENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE HEREBY EXCLUDED SYNAPSE AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES IN NO EVENT WILL SYNAPSE OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE PROFIT OR DATA OR FOR DIRECT INDIRECT SPECIAL CONSEQUENTIAL INCIDENTAL OR PUNITIVE DAMAGES HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE EVEN IF SYNAPSE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Open source Libraries Included in Portal apy 2 4 1 argparse 1 3
33. Portal has queried The node has to tell Portal what it is capable of Factory Default NV Params This menu option displays the Factory Default NV Params dialog which allows you to reset all NV parameters to the defaults as shipped from the factory Erase SNAPpy Image This menu option displays the Erase SNAPpy Image dialog which allows you to erase the currently loaded SNAPpy script in your node This option is useful if your script has inadvertently been programmed to lock you out of your node over the air Configure Logging The Logging Configuration dialog enables the configuration of different logging levels and methods for Portal Logging Configuration Display Logging Level Info File Logging Level Debug e Log Unknown Functions Enable Logging of Unknown Function Calls s A The Display Logging Level field controls the level of detail printed to the Portal Event Log Portal Reference Manual ES The File Logging Level field controls the level of detail logged to disk The Log Unknown Functions checkbox enables logging of unknown function calls into the Portal Event Log In this context an unknown function call is a function that is not either a Portal built in function nor a function defined in the currently loaded Portal script For example if a remote node with SNAP Address 00 86 f9 were broadcasting moastRpc il 5 desomething Ly Z calls and Log Unknown Functions wer
34. Ppy Image function always defaults to this subdirectory when you choose to upload a script into a SNAP node other than Portal For example if you decide to keep your script work in C MyProject then the full tree will become C MyProject C MyProject SNAPpyImages Remember that auto completion of function names and variable names requires that Portal can locate the BuiltIn py file within the synapse directory If you do not copy that file into your new directory structure Portal will locate it and use it from the default location as long as you have not created a synapse directory in your own structure that does not contain a copy of the Builtin py file A few words about adding additional custom subdirectories Python Modules Just as Synapse used the synapse subdirectory to reduce the number of script source files contained in the SNAPpylmages directory you can add additional subdirectories to better organize your working environment For example you might set up something like C MyProject C MyPro ject SNAPpylImages C MyProject SNAPpyImages MySensors yy lt Your MySensors directory might contain scripts like Temperature pv Pressure py etc This will allow you to do things like from MySensors Temperature import in your top level scripts However in order for this to work Python not Portal requires a special file to be present in every subdirectory that you intend to
35. Python Library Directory The Configure Python Library Directory menu option displays a standard directory dialog box to choose the directory where you have optionally installed a local copy of Python 2 6 This enables you to use the power of full desktop Python in your Portal scripts If you have installed Python 2 6 on Windows in its default directory this will likely be something like C Python26 Lib Versions of Python other than 2 6 x are not supported in Portal and should not be selected Configure Crypto Settings The Crypto Settings dialog enables the configuration of encryption for the Portal node Beginning with firmware release 2 4 all serial communication between nodes is encrypted when encryption is enabled so Portal must be configured with the same encryption options used in your other nodes Crypto Settings Enabled C Encrypt and decrypt all packets Type Key Reconfigure Reconfigure all listed nodes with above settings cancel Check the Enabled checkbox to indicate that you want to use encryption Select the appropriate encryption type either Basic or AES128 if available and specify a 16 character encryption key The encryption key and the encryption type must exactly match the key and type used in your other nodes or they will not be able to communicate The key must be exactly 16 bytes long You can specify the key as a simple string e g TheeNcRyPtloNkEy as a series of hex values e g x
36. REFERENCE MANUAL Synapse Portal Reference Manual for Version 2 6 6 2008 2015 Synapse All Rights Reserved All Synapse products are patent pending Synapse the Synapse logo SNAP and Portal are all registered trademarks of Synapse Wireless Inc Doc 116 061520 009 A000 6723 Odyssey Drive Huntsville AL 35806 877 982 7888 Synapse Wireless com Disclaimers Information contained in this Manual is provided in connection with Synapse products and services and is intended solely to assist its customers Synapse reserves the right to make changes at any time and without notice Synapse assumes no liability whatsoever for the contents of this Manual or the redistribution as permitted by the foregoing Limited License The terms and conditions governing the sale or use of Synapse products is expressly contained in the Synapse s Terms and Condition for the sale of those respective products Synapse retains the right to make changes to any product specification at any time without notice or liability to prior users contributors or recipients of redistributed versions of this Manual Errata should be checked on any product referenced Synapse and the Synapse logo are registered trademarks of Synapse All other trademarks are the property of their owners For further information on any Synapse product or service contact us at Synapse Wireless Inc 6723 Odyssey Drive Huntsville Alabama 35806 256 852 7888 877 982 7888 256 924
37. Time 35ms Info In your Portal script use remoteNode setColumn name value to display information here Builtin DK200base McastCounterDK200 buttonEvent pinNum isSet lt GPIN changeLedPattern doEverySecond incrementCount reportButtonCount setButtonCount newCount buttonPressed startupEvent lt Startup timer100msEvent currentMs lt 100ms Timer There are four network configuration parameters Network Address MAC Address Channel and Network ID SNAP MAC addresses are standard 64 bit IEEE MAC addresses MAC addresses are assigned to the node at the factory The Network Address is the three byte identifier that is actually used by the SNAP wireless protocol It matches the last three bytes of the eight byte MAC address There are 16 allotted Channels for Synapse products In the 2 4 GHz band used under the 802 15 4 specification each channel maps to a particular specification channel See the SNAP Reference Manual for more details on the frequencies used by Synapse products The SNAP Network ID can be thought of as a logical channel This 16 bit integer may be assigned any hexadecimal value from 0x0001 through OxFFFE Devices in a SNAP network must share both the same Channel and same Network ID in order to communicate This allows multiple SNAP networks to share the same channel if required although it is preferred to place independent networks on separate physical channels to reduce col
38. also be upgraded remotely over the air AKA OTA The ability of a particular platform to support OTA firmware update depends not only on what hardware it is based on but in some cases also which version of SNAP firmware it is already running At the time of this writing the following versions of SNAP support OTA firmware update e SNAP on ATMEL ATmega128RFA1 2 4 32 or higher e SNAP on Synapse RF200 2 4 32 or higher e SNAP on Synapse SM200 2 4 32 or higher e SNAP on Synapse SM220 any e SNAP on Synapse RF266 2 4 32 or higher e SNAP on Synapse SS200 2 4 32 or higher The platforms that gained OTA capability in a particular version must already be running that version in order to be upgraded remotely So for example version 2 4 32 must be loaded via a direct connection into an RF200 but then it will be able to be wirelessly upgraded to a future version Obtaining Firmware Refer to the previous section of this document The firmware images used for OTA firmware update are identical to the ones used for direct serial update Installing new Firmware One Node at a time First make sure you have connectivity either wireless or direct serial to the node you wish to upgrade Second make sure it is selected in the Node Views pane and perform a Refresh Info Gi Third go to the Options menu and choose Upgrade Over The Air You should get a dialog box like the following 16 Over The Ar SNAP Node Flash Upgrader Lea
39. be significantly affected while the Channel Analyzer is running It may be best to Stop the channel analyzer while you perform other functions and then Start it again afterward Portal Reference Manual ES Like many panes the Channel Analyzer pane has its own mini toolbar e The Start button begins continuous channel scanning e Once started the Stop button can be used to stop channel scanning e The Packets Received indicator show the number of energy detection packets received from the bridge e The Clear Values button can be used to erase any existing data and start a fresh plot e The KE Save Graph button can be used to save the currently graphed data as a graphic e The Channel Help button brings up a list of channels with an indication of how clear each channel is This can help you choose the best channel for your nodes based on the observed radio traffic in your environment e AdBm Floor slider lets you choose a cutoff value for the graphed data This lets you ignore low level signals and focus on stronger ones While channel scanning is in progress the dBm Floor slider actually filters the incoming data incoming readings below the current cutoff value will be discarded When channel scanning is not in progress this slider just controls what already captured data is visible and thus controls what data is included in the zz Channel Help calculation To include more or less data in the calculation adjust the dBm Floo
40. by commas in the args field of the window For example you can use the rpc function from Portal to have one remote node use rpc to request that a different node perform some function mpc dstAddr dun sage remoteFnOb rpe args writePin 1 True NEO Portal is a Node Too Most of this section has been focused on using Portal to interact with remote SNAP nodes However Portal itself can function as a node on the network Many of the actions available in the toolbar work with the Portal node with exceptions and clarifications noted above If you select Portal in the Node Views pane the Node Info pane will show info similar to the following Node Info x a Gea Gi Le 4 Led ac ns xX B A Portal a A Software Version 2 5 0 a ER Platform Portal enese Network Address 00 00 01 MAC Address WA Device Image Image Modified Image Size N A License M A Channel N A Network ID M A Path Portal Reference Manual If a Portal script is loaded you will see it in the Portal Modules function tree You can invoke any functions defined in that script by clicking them just as you can with the functions defined in the remote SNAP nodes myPortalBaseFile py gt lt SIS ME def i 3 4 5 Edef 6 7 8 g 10 10 O def A 13 Lly check for updates rersends out an update request to all nodes mcastRpc 1 5 request_update update report sensor value Process a
41. cally start scanning ports for SNAP devices Discover Nodes Y PING nodes on startup Refresh Node Info J Refresh node information automatically Intercept STDOUT Y When intercepting node output include STDOUT Intercept ERROR When intercepting node output include ERROR Append CRC to RPCs Append extra CRC to RPC calls Require CRC on RPCs __ Validate extra CRC on incoming RPC calls Packet CRC _ Leave room in radio packets for packet CRC zen The following table describes each option in the Preferences dialog gt The Time to Live TTL value to use when Portal sends a broadcast ping request TTL Ping l i L e e a A8 is sometimes referred to as number of hops Ping Response The time in seconds across which to request nodes to randomize their broadcast Spread ping responses Data Logger Limit The number of data log entries to keep before dropping the oldest entry When Portal sends an RPC command to a node for which it expects a response such as a callout or a ping to the node this parameter specifies how long in RPC Response milliseconds Portal will wait for the response before sending the next packet If Timeout your network requires many hops to reach all your nodes you may want to lengthen this from the default value of 800 Link Quality Where applicable display link quality as a percentage instead of dBm When a function is clicked in the Node Info function tree request that the node Sh
42. ccept TCP IP connections In the screenshot above we are connecting to an E10 at IP Address 192 168 1 97 The IP Address can optionally be followed by a TCP IP port number using the usual separator The default port for SNAP TCP is 48625 so typing 192 168 1 97 and 192 168 1 97 48625 are equivalent El Version 2 6 6 The Username and Password fields default to the same default values that SNAP Connect uses namely Username public and Password public If you have not changed those in SNAP Connect then you don t have to enter anything into these two fields it has already been done for you A8 lt If you have changed the SNAP Connect settings from their default of public public then you must enter matching values including uppercase lowercase into these fields before the connection will work If Portal is having remote connectivity problems it will print the message Communications attempt failed please check your settings username password IP address into the Portal Event Log as a reminder To take down this remote connection just use the Disconnect button You can then use the amp Connect button to establish a different serial or remote connection Broadcast Ping ee Clicking this toolbar button will cause Portal to broadcast a special answer if you hear me message to all nodes When the nodes answer any nodes that Portal did not already know about will be ind
43. d completely new categories of data Just use a unique name and you ve created a new strip You can either send an RPC function call from your node to Portal s address invoking the LogData function with your desired data or you can RPC your data back to some other function in Portal where you can use Python code to evaluate and interpret your data before that function invokes logData Scaling The vertical axis is fixed at 100 units Since a heterogeneous collection of data types may occupy the same plot generic units are used However the logData function accepts a scaling factor so that each value can map its full scale range onto the vertical axis The horizontal axis is a continuous timeline with automatic scaling You can plot multiple values from the same or multiple nodes If you select a data point in the graph the window will tell you the point s data and time temp DU AU A El Version 2 6 6 illa Channel Analyzer Clicking this button will open the Channel Analyzer pane within Portal Channel Analyzer gt Packets Received 0 7 El aa mico 1 ce o Bm signal Strength cn a SEA Celtes alo KS Ka 3 10 D i ER ei e fpi Performing a channel analysis energy detection scan consumes significant resources on your bridge node so the function is only performed on demand Performance of other functions within Portal such as uploading scripts to a node or running a Portal script may
44. de This may be necessary if you have an environment with multiple computers running Portal where the nodes can interact If more than one node has the same network address the default is 00 00 01 you can have unpredictable results Portal Reference Manual El The valid network addresses for Portal range from 00 00 01 through 00 00 0F It is not necessary to restart Portal for this change to take effect New Configuration This option creates a new Portal configuration which deletes any locally saved Portal information Your window layout and all your preferences will be preserved however scheduled scripts and saved node information will be deleted For example all the nodes in the Node Views will be deleted and a broadcast ping will be performed to rediscover the network Open Configuration This option opens a previously saved SWN file that contains saved information about nodes Save Configuration As This option saves a Synapse Wireless Network SWN file that contains information about your nodes This includes a list of all the nodes about which Portal is currently aware plus changes such as custom node icons Export Node List as CSV This option saves a text file of comma separated values to the destination of your choice listing all the nodes currently included in your All Nodes view The CSV file includes a header and three pieces of data for each entry Node Name SNAP Address and file path to an icon file if you
45. des is the Node Views tab If this window is not already open you can click View then choose Node Views window Alternatively you can click the sas icon on the toolbar You will notice that the Node Views window has its own toolbar Cl 2 e active Nodes e 3 nodes The Node Views tabbed window lets you look at your nodes in two different ways e E Report View e E Tree View These two options provide different views of the same network information Click the E Change to Report View button in the Node Views toolbar not the main toolbar Several columns of information are shown about each node found e Views x 2 tee nodes Node Network Address Device Image Link Quality Device Type Portal 00 00 01 Portal Ripley 03 F9 06 67 None E CEES McastCounterDK200 The Node column shows an icon and a name for each node Both the icon and name can be changed by the user What you see here are just the default icons A W is used within Portal to generically represent any SNAP node H is used within the Portal user interface to represent Portal itself Remember Portal is able to participate in the network as if it were a wireless node The name for the node is assigned when the node is first discovered and can come from three possible sources e As of version 2 1 it is possible to assign a name to a node e lf you don t give a node a name it will use the name of any loaded script e Ifno name given and no scri
46. dows Update to search for software O Yes this time only Yes now and every time connect a device No not this time Click Next to continue Since the correct software is already available you just installed it along with Portal there is no need for Windows to connect to Windows Update just select No not this time and then click Next Portal Reference Manual Found Mew Hardware Wizard This wizard helps you install software for Synapse USE Device Li lf your hardware came with an installation CD w lt 3 or floppy disk insert it now What do you want the wizard to do Install the software automatically Recommended Install from a list or specific location Advanced Click Next to continue Choose Install the software automatically and click Next Depending on the version of Windows you are running you may get a warning dialog similar to the following Hardware Installation The software you are installing for this hardware Synapse USE Device has not passed Windows Logo testing to verify its compatibility with Windows AH Tell me why this testing is important Continuing your installation of this software may impair or destabilize the correct operation of pour system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has passed Windows Logo testi
47. e enabled checked then you would see events like the following in the Portal Event Log Node 0086F9 called function doSomething 1 2 which does not exist If you created a Python script that defined a doSomething a b function and loaded that into Portal that function would be invoked instead of the unknown function event being generated Depending on the logging level specified you may sometimes see messages in the log that are intended for advanced users and Synapse developers to assist with troubleshooting complicated network configurations Typically if the error message is not explicitly documented it can be ignored for most usages Set Working Directory The standard scripts that ship with Portal reside in a directory tree with the following naming conventions and structure The top level directory is named Portal and the source files in it are meant to be loaded into Portal itself Underneath the Portal directory is another directory named SNAPpylmages The source files in this directory are meant to be loaded into actual SNAP nodes such as the RF100 or SM220 Underneath the SNAPpylmages directory is a subdirectory named synapse These source files get imported by some of the example scripts in the SNAPpylmages directory By default this source code tree is rooted in the standard user files location for your particular operating system For example on Windows the
48. e hardware features As of Portal release 2 5 the tab includes a breakout of the Feature Bits indicating what each bit represents and allowing you to specify the numerical value to use by checking individual features you desire The Multi cast tab lists parameters relating to multicast communications The UART tab lists parameters relating to the buffering of data received from the system s universal asynchronous receiver transmitter s for serial communications The Mesh tab lists parameters relating to the mesh routing capabilities of the node Portal Reference Manual 23 Synapse nodes communicate with each other using mesh routing This means that any unit can communicate with any other unit they are all ogical peers within the mesh even though in some cases units that are out of radio range of each other might have to pass messages through intermediate nodes to do so Only units that are within radio range of each other can communicate directly physical peers The route discovery and packet forwarding necessary to make this work are all done automatically by the node There are several Mesh Routing Timeouts The default values should cover most network topologies Be careful if changing these values on remote nodes you could make it impossible to communicate with the node remotely See the SNAP Reference Manual for more info about tuning these timeout parameters pe There are also several non timeout paramet
49. e routine to invoke on the node and the remaining parameters are passed to that routine Sends data to the specified node in a way that mimics RANSPARENT MODE This lets Portal insert data into RANSPARENT MODE links his is the shorthand form of sendDataModePkt Portal Command Line only Sends data to the specified multicast group in a way that mimics RANSPARENT MODE This lets Portal insert data into RANSPARENT MODE links Group can be specified as a two byte binary string or as an integer For example to reach the broadcast group specify a group parameter of x00 x01 or 0x0001 To reach all groups specify a group parameter of xFF xFF or OxFFFF The string form of the parameter is supported for backward compatibility most users will prefer integer notation his is the shorthand form of sendMcastDataModePkt AI Sends a traceroute request packet to the specified node with the eo AN There are also some commands that must be prefixed by root Clears the Portal Event Log Pops up a tabbed window with the contents of an internal log file sometimes used in debugging Change Portal s network address from the default value of x00 x00 x01 00 00 01 Portal s network address can range rom x00 x00 x01 to x00 x00 xOF Convert an SN132 SNAPStick SNAP Engine carrier to respond to our computer as a virtual COM port rather than as a USB device For most users there will never be a need
50. ent and sizing and wish to have Portal return to its default layout select View Rearrange to Default View and you will be returned to a view with the Node Views window on the left the Node Info window on the right and the Event Log window across the bottom of the screen Version 2 6 6 7 Built in Editor Portal includes a built in code editor making it an all in one solution The code editor includes useful features such as line numbering automatic indentation code folding and text auto completion making it easy to develop scripts that meet your needs There are several ways to open an editor pane e Click on a script name from the Node Info pane e Usethe Open File button on the main toolbar e Use the 4 New Script button on the main toolbar Regardless of how you opened it all the edit windows work the same way McastCounter py X Ew a i ve 5 ee gt ME Sample SNAPpy file for Evaluation Kit Boards Bridge End Device ProtoBoard and SNAPStick BL Press the select switch on any device to increment counter on all devices 10 11 MN Use Synapse Evaluation Board definitions ia from synapse evalBase import 14 Wa Comment the following out if you have your own HOOK 10M5 handler MN and be sure to call updateSevenSegmentDisplay from your own handler MN EsetHook HOOK 10M5 TE E def defaultTimerHandler 19 updateSevenSegmentDisplay 20 210 secondCounter Sen buttonCount eh numPatterns 28 curPattern
51. ers Refer to the SNAP Reference Manual for information about using them The Security tab lists parameters relating to encryption Specify an Encryption Type of O for no encryption 1 for AES 128 encryption or 2 for Basic encryption If encryption is enabled the Encryption Key must be exactly 16 characters long and can be any combination of text string and hexadecimal values To change one or more of the editable fields just type the replacement value s in before clicking OK The new values are sent to the node and stored The Change Configuration Parameters action is not available for the Portal node except for when the Portal node is connected to a SNAP Connect instance Then a subset of relevant parameters are available for adjusting how Portal interacts with the network If you have a network that includes more than one instance of Portal the remote Portal node will not report useful information for the Change Configuration Parameters window Intercept Node Output Script output from print statements normally goes to the data sink specified by the script itself For example the script might be outputting text to serial port 0 For testing purposes it is sometimes handy to intercept the script output from the node which might be remotely located and display it within Portal instead Clicking this action will send the necessary commands to the node to accomplish this The intercepted text will appear
52. fields of all active units There is also a Refresh button you can click to force a refresh of a single node s Link Quality This button is on the Node Info toolbar Finally there is a E Watch Nodes button that essentially turns on automatic broadcast pings 2 The value shown is based on the received signal strength of the most recent message from any other wireless node It does not represent the signal strength between Portal and the node It is not an indication of the USB or RS232 quality between Portal and Portal s bridge node 3 It is possible that at the time the Link Quality field was read from the unit it had not yet received any radio messages from any other node In this case a value of O is reported This does not mean the unit has a faulty radio it simply has not done any radio communications yet This is most often seen with the node that is acting as a bridge for Portal because Portal can be interacting with this directly attached node without necessarily generating any radio traffic The Device Type column shows one of the non volatile NV configuration parameters of the unit Device Type is a second string label that can be applied to a node Unlike the Node Name this label does not have to be unique and is often used to show what job or role a node is filling This parameter can also be read by SNAPpy scripts allowing a single script to act differently on different nodes by setting the Device Type of each node app
53. for the selected lines Additionally the following keyboard shortcuts work in every pane in Portal as long as that pane has multiple tabs opened Ctrl Tab Select the next tabbed window in the same pane Ctrl Shift Tab Select the previous tabbed window in the same pane Ctrl Page Up Select the next tabbed window in the same pane Ctrl Page Down Select the previous tabbed window in the same pane Portal Reference Manual 8 Firmware Updates via Direct Connection The Firmware Version is shown in the Node Info pane for each SNAP node in your network Upgrading your devices to a newer version of SNAP is easy with Portal Obtaining Firmware Each new release of Portal includes the most current version of the SNAP firmware at the time of that Portal release Intermediate firmware only updates may also be available on the Synapse Support Web Site http forums synapse wireless com Look in the Latest Releases thread on the forum under the Software Releases topic If you download new firmware put it in the Program Files Portal firmware subdirectory for ease of use Installing new Firmware First make sure you have an RS232 connection to the device you are upgrading This requires a connection to the DB9 connector on the SN163 Evaluation Kit board as the USB connection on that board connects to UARTO which is not supported for firmware upgrades From Portal s Options menu select Firmware Upgrade The follow
54. in Hemnwork Address 06 7335 bp MAC Address O0 1C 2C A D6 06 7395 ee e d aan c llbeckicefterck rerpatef nb arm H Ke F Device image A alli Sh he nesr ll i image CRC harna cbus ginuerTe eag image Size 2121 bytes G bus betreie License Permanent Sub Channet l cos Lonpectidaticrel dasa Hee fasts ip SI Wemeork ID thf 15E E Path ene letrero Enabled get bspa lt anit Bffarnst pakong arica glo kader K i gaothi Ae path miinaan coletied gedit dt lea getstet which Stat In eur Partal ceript use ellos remoteblode seo lurmninarmme value DI j i El to depay information ben z z E E mee Wei rgsckacbis rines ignerePirtAck endy initiat huen Goel ete m ch UE a a F Event Lee d Time Event Device Type Value AF eer ae i Pee ee mayt ae era 2015 10 27 14 33 29 STATUS Hacker INFO Measti curgerkK 20 35 Lama 1 Fa QUEEN Hires Verne PGP hor 22004 1 Ze eg 104 14 3257 0200 Note that the node names are based on the names of the SNAPpy scripts loaded into those same nodes at the time of discovery but with additional trailing digits 2 3 4 etc added to enforce uniqueness If a node doesn t currently have a script loaded it will have a name like Node or Node2 Node Info Lots of information is shown in the Node Info tabbed window However Portal may not be set to automatically query the node for its information This is a configurable preference in Portal To be sure Portal knows eve
55. ing dialog box will display 2 SNAP Node Flash Upgrader Port COMS Firmware Image C Program Files x66 Synapse Portal firmware RF200_AES128 SnapV2 5 3 s Progress Press upgrade to start Upgrade Portal will list the available COM ports on your system under the Port dropdown Manually select the correct COM port E to which that your SNAP node is connected You may need to click the E Scan button for Portal to locate your serial connection DI Version 2 6 6 Select the Firmware Image to be used for the upgrade Starting with version 2 1 there are now four types of firmware images from which to choose e Firmware images with debug in the title have extra error checks to help debug user scripts and configurations These extra diagnostic checks come at the expense of a slight decrease in speed and SNAPpy image space e Firmware images without debug in the title do not have these extra error checks which allow them to run faster and have more room for SNAPpy images e Firmware images with AES128 in their name have built in support for AES 128 over the air encryption These images are not included with Portal but can be ordered separately from Synapse There is an additional charge for AES 128 support e Firmware images without AES in the title do not support AES 128 encryption The firmware image names also indicate the version of that firmware For example 2 4 10 is newer firmware than 2 4 6 and both are
56. ividually queried for additional information You can override this behavior under the Preferences menu You might use this button if you just added one or more new nodes to your network Broadcast Ping will only find nodes using the same channel and network ID as the bridge node sxa Node Views This tab provides a graphical display of the nodes in Portal s internal device directory Internally Portal indexes all nodes by network address When a new network address is discovered a corresponding icon in the Node Map will be created Deleting a node select the node and click Remove Node from the Node Info tab removes the device from Portal s internal database This removes all knowledge of the device from Portal If the device is subsequently re discovered usually via a ping it will reappear in the Node Map i Node Info The Node Info tab provides node information a mini toolbar for common tasks and SNAPpy script information about the currently selected node Event Log The Event Log captures real time event history for Portal All network affecting activity is recorded here Log entries are time stamped to a 1 second resolution Events Captured Include e Configuration save load e Script STDOUT and STDERR print statements errors e Status messages e RPC communication messages Portal Reference Manual E Command Line The Command Line window provides interactive access to Portal s Python based scripting engine Using
57. l 6 would be the best choice for newly deployed nodes as it is quietest right now followed by channels 8 and 3 You can click column headers to sort the list to quickly find the weakest signal seen most clear channel or strongest signal seen most crowded channel Portal Reference Manual ES Add Node Normally Portal only adds nodes to its internal database when it discovers them via actual SNAP communication The g Add Node function allows you to manually add a new node to Portal s node database This can be handy if the node is not installed yet or simply powered off but you know it will be online later Clicking the Add Node button will display the following dialog box Node Network Address Please enter the new node address Enter the SNAP Address for the node in any of the following formats e 12 34 56 using separators e x12 x34 x45 using the same format used in Python strings e 123456 raw hexadecimal characters only All three of the above examples will result in the same three byte SNAP address Reminder The SNAP address is the last 3 bytes of the MAC Address which is usually printed on the node somewhere look for a label Node Network Address Please enter the new node address d5 aa 96 After entering the correct SNAP Address click the OK button and the node will appear in Portal s View Nodes pane ES Version 2 6 6 ia Find Nodes Clicking this button will display the fol
58. l constants within Python or SNAPpy strings you use a leading x Going back to our example if you want to specify the node with address 12 34 56 you would use x12 x34 x56 in your script Portal also assigns names to nodes when it first discovers them If the node with address 12 34 56 has a displayed name of MyNode then instead of specifying an explicit address string you can just use the text MyNode instead So assuming node MyNode4 is at address AB CD EF the following two commands are equivalent sendData xXAB xCD xEF This is a test sendData MyNode4 This is a test dmcastRpc nodes Sends a directed multicast RPC request to the specified addresses groups E KR 2 S ttl in the nodes address list Parameter function is the routine to delay invoke on each node in the specified groups and the remaining parameters are passed to that routine function args logEvent message Log the specified message to the Event Log Portal Reference Manual e Plot the specified value to a named strip chart in the Data Logger window Sends a multicast RPC request to the specified groups Parameter unction is the routine to invoke on each node in the specified groups and the remaining parameters are passed to that routine he same as the mcastRpc function above but left for backwards compatibility with older versions of Portal Sends an RPC request to the specified node Parameter function is h
59. lisions Node Info Tasks Pane There are thirteen toolbar options in this pane Not all are active for the Portal node e 2 Ping poll a node for connectivity e Traceroute collect path information to the node e Refresh poll a unit for the values shown in the Node Info tab Portal Reference Manual e L Upload SNAPpy Image program a node with a new script This button is labeled Change Portal Base File for the Portal node e Ld Erase SNAPpy Image remove previously loaded script This button is labeled Clear Portal Base File for the Portal node e Lei Export SNAPpy Image export a SNAPpy image as a SPY file e Change Configuration Parameters more on this below e Intercept Node Output divert the node s script output to Portal e Ka Change Icon substitute an alternate PNG graphic file as the node s icon e Rename Node replace the node s current logical name e 2 Remove Node remove the node from the various Node Views e Reboot Node reboot the node e Upload SNAP Firmware send new SNAP firmware to the node via RPC calls This capability is only available nodes based on the AT128RFA1 platforms as of this release Ping Clicking this action causes Portal to make a quick connectivity test to the selected node Observe the Event Log for confirmation of Ping activity The Ping action is not available for the Portal node Portal cannot ping itself
60. lowing interactive dialog Mode Finder Channel a All Channels Specific Address Move to my Network Query for LO and Image Network Address Channel MetworkID LQ Device Image First choose a specific channel to scan or check the All Channels flag Next click the Scan button Portal will switch the bridge node to a special wildcard Network ID value that all nodes will respond to Portal will then broadcast pings on the specified channel or all channels and build up a list of all SNAP nodes that respond Node Finder Move to my Network Query for LO and Image Network Address Channel Network ID LQ Device Image 05 47 56 13 OxBEEF 04 07 65 13 OxBEEF 03 F4 74 13 OxBEEF 03 07 67 13 OxBEEF 00 87 DA 13 OxBEEF In the example shown here five nodes were found on Channel 13 on three separate networks Because the broadcast ping process uses unacknowledged broadcast messages some nodes may not respond You may have to hit the Scan button more than once to find the node you are looking for If the Node Finder locates a node on a different channel or using a different network ID than Portal s bridge node is using you can select the node within the list and click the Move to my Network button Portal will then command the node to change channel and or network ID as needed Press the Close button to close this dialog and resume normal Portal operations If you are looking for a specific node with a known network add
61. n update report when one is received address rpcSourceAddr value sensor value 1000 print Report from Sa 31 address value set controller controller_addr value Ser the controller value on a specified device rpe controller addr set control value value ER Portal Modules Q myPortalbaserile check for updates set controller controller addr value update report sensor value Version 2 6 6 6 Portal Tools The main toolbar provides quick access to Portal s tabbed windows These windows can be shown hidden or rearranged to suit a variety of operational modes Some of the toolbar buttons invoke immediate commands instead of opening new tabbed windows AAA TM Li New Script Clicking this button will open a new Edit Window containing a new empty source file NewScriptl py BAE LY E mr F The default name of the script will be NewScriptX where X is a trailing number to enforce uniqueness Open File Clicking this button will display a file chooser dialog from which you can select a previously saved source or Portal configuration file d synapse Name Date modified Type _init_ py 9 30 20149 10AM PY File Recent Places 2 AT25FS010 py 9 30 20149 10AM_ PY File Ca 2 Builtin py 9 30 2014 9 11 AM PY File 2 CAT24C128 py 9 30 2014 9 10 AM PY File Reig evalBase py 9 30 2014 9 10 AM
62. name in the tab Now that you know the basics of navigating within Portal we can continue with the tour Discovery We first need to look at the Node Views tabbed window If this window is not already open you can click Views and then choose Node Views window Alternatively z 3 ActiveNodes v 3 nodes you can click the sa icon on the toolbar SE You will notice that the Node Views window has its own toolbar lgnore all but the first four buttons for now The Node Views tabbed window lets you look at your nodes in two ways e E Report View e li Tree View Both views are just that views of the same network information Click the Report View button Version 2 6 6 You should see that two devices have been discovered The directly connected bridge device should be shown in blue while the remote device should be displayed in black When you double click a node in one of the Node Views Portal displays basic information about that node in a separate Node Info pane pre Portal delauht zg Workspace Uer brewer Dauments Portal OB am Vile otomi Hetean ide Jie ASI cad ag Node Verve Nude Info x Els ot elle age pl noves Dez Le L Is EE Made Nekscnt Addie Devore irme Lk Quality Deae Type pa E Hicks Portal OGL Portal F Ve ES Ai AECH Ripley HE aT Nene FS Beerg gn 2 ake with DESS gt 7 Hicks 06 13 56 McastCuunterDK200 77 Buzz Fiatom RFA Bu
63. ng Continue Anyway STOP Installation This warning is harmless and you should click Continue Anyway Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for Synapse USB Device Click Finish to close the wizard D Version 2 6 6 Congratulations Your Synapse USB Device is installed and ready to be used by Portal Program Launch After installation launch the Portal program You should see a screen similar to the following if e ei oi al i i E be Fm O fi Node Views gt Node Info E a g SI amp Active Node y 1 node eS s Xe Node Network Address Device Image Link Quality Device Type Portal 00 00 01 Portal Firmware Version Platform User Functions Network Address Hooks MAC Address Builtin Functions Connect to Port Port USBO Progress Found SNAP Bridge Device on Port USBO Connect Cancel i If you do see something similar you have now successfully installed Portal and detected a USB connected bridge device The Connect dialog box is automatically shown at Portal startup If you click the Cancel button you can bring this dialog back by clicking the a button on the main toolbar Also be aware that this toolbar button doubles as a status indicator When you are connected it looks like Z and functions as a disconnect button When you are not connected it looks like a and functions as a connect button
64. ns a number MyNode channel returns an error channel An integer corresponding to the node s channel dottedNetAddr he node s network address as a string in the format hexNetld A string representing the node s network ID if known e g Ox1C2C isResponding A Boolean value indicating whether the last query was successful IqVal A float value of the node s last queried link quality in dBm name A string that describes this node in Portal s node views netAddr A string containing this node s unformatted network address networkld An integer corresponding to the node s network id version A string containing the node s last queried version Portal Methods The following methods are independent of SNAP Nodes They provide a system level interface between Portal scripts and system wide capabilities Because they are not node specific you do not prefix them with a node name and a character Some of these routines do take a node parameter You can specify the correct node in two different ways e By explicit address e By node name the node s name as shown in the Node Info pane within Portal Explicit addresses are three byte strings Portal shows node Network Addresses in hexadecimal but omits any number base prefixes or suffixes If Portal shows a node s Network Address as 12 34 56 then the individual address bytes are 0x12 0x34 and 0x56 hex not 12 34 and 56 decimal To specify hexadecima
65. nt size for the current window Ctrl C Copy selected text to the clipboard Ctrl D Duplicate the current line Ctrl F Invoke the Find dialog Once a search has executed F3 repeats the search for the next instance Ctrl L Delete the current line Ctrl N Decrease font point size for the current window Ctrl S Save the current code file Ctrl T Swap the current line with the previous line Ctrl V Paste from the clipboard Ctrl X Cut to the clipboard Ctrl Y Redo the last undo Ctrl Z Undo the last action Ctrl Move cursor to the beginning of the previous or current paragraph Ctrl Move cursor to the beginning of the next paragraph Ctrl Home Move cursor to the beginning of the file Ctrl End Move cursor to the end of the file Ctrl Delete Delete from the cursor to the beginning of the next word Version 2 6 6 Ctrl Shift Delete Delete from the cursor to the end of the line Ctrl Right Arrow Move cursor to the beginning of the next word Ctrl Left Arrow Move cursor to the beginning of the previous or current word Home Move cursor to the beginning of the current line End Move cursor to the end of the current line Alt Home Folds or Unfolds code Tab When multiple lines or sections thereof are selected increases indentation level for the selected lines Shift Tab When multiple lines or sections thereof are selected decreases indentation level
66. ode e g 2 6 2 Select the platform and the appropriate CPU The platform selected will control which code is compiled into your script It matches the Platform specified for the node If you exclusively use the default platforms specified by Synapse Wireless the CPU will automatically default for you Refer to the platform selections listed in the platforms py file included in the SNAPpylmages synapse directory for examples of the default platform values You will notice a Create Map File checkbox next to the Cancel button If you select this before clicking the OK button an additional diagnostic file will be created that has the same base filename as the SNAPpy script but has an extension of map For example MCastCounter py will result in a map file named MCastCounter map This file will automatically be opened in a new editor window so that you may review it If you have opened a read only file a message on the toolbar will tell you so You can perform a ES Save As to create a separate editable copy This lets you start with an existing demo script and make your own custom variations If you try to type characters into the edit window of a read only file Portal volunteers to save the file to a writable copy for you Read only File This file is read only and changes cannot be saved to this file Would you like to save this file as a different name Yes Cancel If you did not mean to be editing the read only file j
67. or NodeX for subsequent nodes where X is a number starting at 2 that represents the order in which Portal discovered the nodes The Rename Node action allows you to choose your own name for a node instead of using the default name assigned by Portal This given name is stored in the node itself in NV Parameter 8 and will automatically be reported by Portal instead of Node if Portal re discovers the node in the future Node names may not contain spaces punctuation or any special characters other than underscore You should not specify a node names longer than 64 characters X Remove Node Clicking this action will remove the node from Portal including removing the node from the Node Views Be aware that if the node really does still exist It may be re discovered by Portal on the next broadcast ping The Remove Node action is not available for the Portal node 2 Reboot Node Clicking this action will display the following prompt Reboot are you sure Warning Node activity will be interrupted during reboot If you really do want to reboot restart the node select Yes otherwise select No The Reboot Node action is not available for the Portal node Upload SNAP Firmware This toolbar button is a shortcut to the Upgrade Over The Air feature that can also be found under the Options menu Refer to section Firmware Updates via Remote Connection for more information Portal Reference Manual ES
68. ors Portal uses Ctrl F as the keyboard shortcut for Find Typing Ctrl F will display a dialog box asking what text to search for Find Search for Cancel If you highlight some text within the text file before typing Ctrl F that text will automatically be filled into the dialog box as the default value l Find Next The y Find Next button is used to continue the text search Clicking the Find Next button or pressing F3 will advance to the next instance of the search text and highlight it in the edit window below If you click this button or press the F3 key without ever doing an initial Find Ctrl F Portal will automatically display the Search for dialog box E Version 2 6 6 show path Hovering the mouse over this question mark just brings up the full filename including directory path of the file in the edit window as a tool tip handy when you want to confirm you are editing the correct source file Test SNAPpy Script The Test SNAPpy Script button lets you validate SNAPpy scripts before you try to upload them into a node Starting in version 2 2 the platform and version can affect how a script is compiled for a node When you click the button to compile the script you will be prompted for the platform and version appropriate for your target SNAP node SNAPpy Senpt Settings Version 3672 Platform RF200 Create Map File For the version enter the firmware version for your n
69. ow Result i i send the return value of that function to Portal s event log Auto Port Scan At startup have Portal automatically start scanning for SNAP bridge nodes y Automatically have Portal send a broadcast ping once connected to a bridge node Discover Nodes i e This does not prevent Portal from discovering who the bridge node is When Portal receives a message from a node not previously heard from this option Refresh Node Info automatically retrieves the node s information When administering a large SNAP network you may want to turn this off to reduce traffic When you select a node and use the Intercept STDOUT function any messages that a node would normally output through a print statement are redirected to the Portal log instead If you have both this checkbox and the Intercept ERROR checkbox unchecked the Intercept STDOUT function does not do anything Intercept STDOUT Portal Reference Manual When you select a node and use the Intercept STDOUT function any error messages generated by SNAP in the node redirected to the Portal log instead If you have both this checkbox and the Intercept STDOUT checkbox unchecked the Intercept ERROR Ee Intercept STDOUT function does not do anything In nodes with firmware older than release 2 4 error messages are included in STDOUT automatically and this option has no effect When checked Portal will compute a payload CRC and append it to all RPC and multicast RPC calls
70. pgrade the node is running a version 2 5 3 build of SNAP with the debugging checks turned on Also notice that the unit no longer has a SNAPpy script in it As explained previously the SNAPpy script gets erased to make room for the incoming firmware image Simply use Portal to reload the script back into the node Portal Reference Manual Installing new Firmware Multiple Nodes in a batch Portal has supported single node OTA Firmware Update for some time but now also supports multi select Firmware Update much like you can do multi select Script Update Use the Refresh Node button to make sure you have connectivity either wireless or direct serial to all of the nodes you wish to upgrade Next make sure all of those nodes are selected in the Node Views pane then go to the Options menu and choose Upgrade Over The Air You should see a dialog box like the following 9 Over The Air SNAP Node Flash Upgrader lp a Firmware Imaqe Open Progress Please select a firmware image You will notice this is the same dialog box as was shown in the one node selected scenario except that in this case the Progress Bar Is missing Choose the filename to be uploaded just like in the single node case and then press the Upload button The original dialog will be replaced with a multi node progress dialog Multiple Node 2 Action Status SNAP Firmware Upload
71. pt loaded Portal will use Node as a base name If more than one node will have the same name based on this arrangement a trailing numeric identifier is appended to the base name so that all nodes have unique names This is a Portal requirement You can rename your units but each name must be unique The Network Address column shows the three byte Network Address for each node The Network Address is simply the last three bytes of the node s MAC Address and is not user definable The Device Image column shows the SNAPpy script image loaded into the device If there is no script loaded into the node then this field is blank Notice that this field tracks the currently loaded script If you upload a different script into a node after it has been discovered named then this column can be different from the Node column Version 2 6 6 The Link Quality column shows a snapshot of the radio receive level By default it is expressed as a percentage with 0 representing the weakest possible signal and 100 representing a maximum strength signal You can configure the system preferences to display the direct signal strength in dBm in the system preferences See Preferences for more details It is important to understand three things about the displayed Link Quality 1 Normally this field is not continuously refreshed Portal does not poll nodes unless you tell it to You can use the A Broadcast PING button to update the Link quality
72. r slider and then select again Here is a screenshot taken from a system while scanning was actually in progress 40 50 dBm signal Strength d a DU Tan Audi II Th dh III wi Tiir l wh wull wm Inf TI wv Ir ee III PF EN Version 2 6 6 The colored bars in the chart provide three pieces of information simultaneously 1 The horizontal position of each bar tells you the channel on which the signal was seen 2 The vertical position tells you the signal strength seen for that signal 3 The color of each bar tells you the number of times a signal of that level has been seen in form A color legend near the top of the pane shows you the scaling In the example above you can see that the strongest signals have been detected on channel 12 around 48 dBm but that the most frequently seen signal is on channel 6 at around 87 dBm You can restart your graph at any time with the 7 Clear Values button and you can save as many graphs as you want using the El Save Graph button Be sure to use the Stop button when you are done This will give your bridge node more time to handle other network traffic Clicking Channel Help brings up a dialog similar to the following Channel Help Percent Clear 92 50 290 18 95 18 97 77 88 30 89 55 100 00 93 21 98 30 0 00 95 09 84 82 86 43 90 27 95 89 04 46 From the example chart you would expect that channe
73. ress you can use the Specific Address textbox to enter its network address This allows you to search for that specific node and move it to your current network if needed instead of getting a list of all nodes Portal Reference Manual Rearranging Windows The tabbed windows in Portal can be dragged and repositioned on the screen To do this press and hold the left mouse button while the cursor is positioned over the tab label you want to move While holding the button down drag the tab until you see a light blue shadow indicating a possible new position for the window When you ve found a suitable new position release the mouse button and the move will be complete S Synapse Portal default swn Workspace C Users john brewer Documents Portal File View Options Network Help Loy ai e A Dali Node View A a gt Le Te e gt fal el Ripley gt Firmware Version 2 6 2 with AES 128 Platform 55200 Network Address 03 F9 C6 MAC Address 00 1C 2C 1A 76 03 F9 06 Device Image Image CRC Image Size License Permanent Channel 14 Network ID OxF15E Path Drag tab as shown to move windows No path information collected Info In your Portal script use remoteNode setColumn name value to display information here Window panes may be resized by clicking and dragging the horizontal and vertical borders separating them If you have made changes to your window placem
74. ropriately You may notice the text for one of the nodes is blue This is Portal s way of showing which node it thinks is its bridge onto the SNAP network Clicking E Tree View displays the next Node View option d Portal 00 00 01 Unknown Path Ripley 03 F9 C6 7 Hicks 06 73 95 z E The tree view can show a hierarchical representation of how nodes reach each other By default Portal does not collect the path information to display a full tree view of a SNAP network However the Traceroute button described later can assist in getting this information The E Watch Nodes button has already been mentioned briefly This button toggles Portal s Node Watcher automatic periodic polling of nodes feature If you need to see nodes coming and going you can turn on the Node Watcher instead of manually clicking A Broadcast PING periodically To accommodate increased network traffic Portal extends its timeout for listening for ping replies by one second when Broadcast Ping is on You can set this timeout the Ping Response Spread from the Properties window Portal Reference Manual The 42 Traceroute button enables Portal to collect path information about currently displayed nodes This option is only available while in the tree view mode Once Portal has collected the path information on how to reach each node the tree view is updated Node Views SfE e Active Nodes zl 6 nodes E Portal 00 00 01 Eh Ripley
75. rything important ee l about your node click the Refresh Node Information icon in the toolbar that runs across the top of the Node Info tab Node Info x AQGa swor Ba Xa A Hicks lt gt Firmware Version 2 6 2 with AES 128 SSP ye Medie a O i Platform RF200 E Builtin Network Address 06 73 95 bist call rawOpcodes args MAC Address 00 1C 2C 1A D6 06 73 95 calllrawOpcodes args callback callback remoteFnObj args callout dstAddr callout remoteFnObj args Image CRC 0x37C7 cbusRd numToRead Image Size 2121 bytes 3 cbusWr byteStr License Permanent chrinumber crossConnect dataSrcl dataSrc2 dmeastRpc dstAddrs dstGroups ttl delayFacl eraselmage Path errno flowControl uartNum isEnabled getChannel nathrnvPi ret Device Image McastCounterDK200 Channel 14 Network ID OxFL5E Across the top a toolbar provides easy access to node specific functions Portal Reference Manual On the left hand side the Firmware Version Platform Network Address MAC Address Device Image Image CRC Image Size License Channel and Network Id are shown Below that is a block where Path information the path to from the node can be displayed Below that there is an Info field that can be controlled from Portal scripts to add your own custom field s to the Node Info panel Device Image refers to the SNAPpy script also referred to as a SNAPpy image loaded into the node Here you can see that the scrip
76. s OK or 2 You can press Cancel to abort the function invocation Don t forget that in the Python language True and False are case sensitive with the first letter capitalized You can also expand the tree of functions defined by each SNAPpy source file Version 2 6 6 As of Portal version 2 5 Portal tracks the history of the last eight entries into each field The last value used will default into the field and the previous seven values are available from a drop down selection making it easier to repeat common requests Node Info le S etaiboar ha ER Hicks Ts gt Firmware Version 2 6 2 with AES 128 E SNAP ja Modules Cl platform RF200 e Builtin W Network Address 06 73 95 MAC Address 00102201A D6 06 73 95 Device Image Micastl ounterDEZ00 AcastCounterDK200 buttonEwent pinflum 155et lt GPIN changeLedPattern Image CRL iL ETLE doEverySecond Image Size 2121 bytes 3 Increment ount License Permanent reportButton ounti setButtonicuntinew_ount buttonPresse Channet 14 CH starttupEvent lt gt Startup Network ID OxFLSE timer00rmstwent currentMhis lt 100ms Path Here you can see the various functions defined in the McastCounter py SNAPpy script Like the built in functions these can also be directly invoked by clicking them and entering any needed parameters Portal Reference Manual 4 SNAP Node Views The starting point for managing SNAP no
77. script source code tree can be found at Ce Users IPC Useri Documents Portal The full tree is C Users PC_User Documents Portal C Users PC_User Documents Portal SNAPpyImages C Users PC_User Documents Portal SNAPpyImages synapse You can add your own custom Portal and SNAPpy scripts into these same directories However users have requested the ability to work with alternate directories Making that possible is the purpose of this menu option The Set Working Directory menu option displays a standard directory dialog box to allow you to choose a different root directory for your Portal scripts and SNAPpy scripts E Version 2 6 6 Change Create Workspace Select a workspace directory Use the dialog box to browse to the desired alternate root directory and click the Select Folder button and then the OK button If you change your mind before you click the OK button you can click the Cancel button and the active working directory will not be changed If you change your mind after choosing an alternate directory you can use the Set Working Directory menu option again to browse back to the original default location However refer to the next menu option Restore Original Working Directory for an easier way to do this To maintain a streamlined work flow Portal will automatically create a SNAPpylmages directory under the directory you specify if one does not already exist This is because the Lit Upload SNA
78. t image McastCounter py has been loaded into the node You can click the device image name shown McastCounter and automatically display that script in Portal s built in source code editor On the right hand side a collapsible tree of available functions is shown In this next screenshot you can see the Builtin tree the tree of built in functions in expanded form Node Info x AAS awa otha Kee Hicks Ga Firmware Version 2 6 2 with AES 128 3 platform RF200 T Network Address 06 73 95 MAC Address 001 06 74 D6 06 3 95 Device Image MeastlounterDK200 Image CRC Ui cbusRd nurnToRead DI Image Size 2121 bytes 3 cbusWribyteStr License Permanent chrinumber Channel 14 aa Network ID OxFLSE Path Notice that there is a scroll bar on the right hand side of the pane there are too many built in functions to fit on the screen at one time Hovering the cursor over a function name will display a tool tip for that function More importantly you can click any function to invoke that function directly on the selected node Functions that do not require any parameters for example the reboot function will be executed immediately If the function requires any parameters Portal will automatically prompt you for them For example clicking the writePin function will prompt you to enter the actual value to output on that GPIO pin You can either 1 Enter a value ex pin 1 isHigh True and pres
79. t script s name in the tree In this example the McastCounter script imports both the evalBase and sevenSegment scripts Functions with names beginning with an underscore character are considered private by SNAPpy they can be called by other functions in the script but cannot be called from outside the node Hovering the mouse cursor over the links in any branch of the tree will display a short tool tip on that function if one has been defined Clicking any function name in the tree will cause the selected node to execute that function If the function takes parameters a dialog box will prompt the user for the needed values 26 Version 2 6 6 writePin pin In the above example clicking the writePin function activated a dialog box asking for pin which IO pin and for a Boolean True or False value to make the pin high True or low False As of Portal version 2 5 Portal tracks the history of the last eight entries into each field The last value used will default into the field and the previous seven values are available from a drop down selection making it easier to repeat common requests Once you fill in the values click the OK button to invoke the function on the actual node This can be very useful for learning the built in functions as well as for testing and debugging scripts Some functions have a variable number of parameters it may be necessary to include more than one parameter separated
80. they would otherwise be Exit This menu option closes Portal prompting to save any open and unsaved scripts first View Menu The first six options in the View menu correspond to toolbar options to toggle the display of other windows View Menu Option Toolbar Icon Node View window e Node Info window L Event Log window eo Command Line window em Data Logger window Loi Channel Analyzer window If a menu item has a check mark next to it this indicates the window is currently open 54 Version 2 6 6 Clear Windows The Clear event log window and Clear data logger window menu options allow each window s respective captured data to be cleared Rearrange to Default View If you have rearranged your Portal window layout this option will rearrange the windows to the default layout view It also resets any color settings you have applied to the Node Views pane Options Menu Connection This menu option shows the standard Portal connect dialog box This option has the same effect as using the button in the main toolbar Firmware Upgrade This menu option displays the Firmware Upgrade dialog to facilitate upgrading your SNAP nodes to a different version Upgrade Over The Air This menu option displays the Remote Firmware Upgrade dialog to facilitate upgrading your SNAP nodes to a different version Portal will disable this menu option unless you have selected a node that supports OTA upgrade and that
81. tion call or node configuration again When you invoke an RPC window or a configuration window Portal will show you the current setting or the most recent previous value used If more than one value has been specified in the field since Portal was installed or since the GUI component history was cleared Portal will display a down arrow indicating that there are other options available for selection Using this option from the Options menu removes this history data leaving Portal with a fresh lack of knowledge about what calls have been made in the past Network Menu Broadcast PING jimh This menu option sends a broadcast PING request to the SNAP network This option has the same effect as using the Broadcast PING button on the main toolbar Find Nodes This menu option opens the Find Nodes dialog box to search for nodes across different SNAP networks This option has the same effect as using the ES Find Nodes button on the main toolbar Generate Topology DOT File This option generates a topology dot file to view a snapshot of your SNAP mesh network This is accomplished by having the SNAP nodes query for any nodes that are one hop away and report that information for Portal To view the DOT file which is saved in your Portal documents directory you will need to use a DOT file viewer There are several freely available viewers on the Internet Change Portal Address This option changes the network address of your Portal no
82. to Ma chine142M Easy caei Make sure the desired components are checked and click Install D Version 2 6 6 al Synapse Portal 2 6 6 Setup Completing the Synapse Portal 2 6 6 Setup Wizard Synapse Portal 2 6 6 has been installed on your computer Click Finish to dose this wizard Run Synapse Portal 2 6 6 You have now successfully installed Portal There will be a Portal icon on your Windows Desktop if you specified there should be as well as in the Start Menu We recommend that you do not run Portal until you have completed the bridge device driver installation through the following steps so you should uncheck the Run Synapse Portal checkbox before clicking Finish Plug in a Bridge Device A bridge device such as a Synapse SS200 SNAP Stick should now be plugged into a USB port on the PC where you installed Portal Depending on the drivers loaded on your system and which version of Windows you are using it may be necessary for the Synapse USB drivers to complete installation This will only occur the first time the bridge device is connected and powered up If necessary the following dialog box will appear Found New Hardware Wizard Welcome to the Found New Hardware Wizard Windows wll search for current and updated software by looking on your computer on the hardware installation CD or on the Windows Update Web site vith pour permission Dead our privacy policy Can Windows connect to Win
83. to continue You must accept the agreement to install Synapse Portal 2 6 6 agree to the terms in the license agreement Synapse Wireless Making Internet enabled witeless Machine to Machine zur Easy Bak ver cancel Read the license agreement at the specified URL check the I agree box and then click Next Portal Reference Manual Synapse Portal 2 6 6 Setup aay Choose the folder in which to install Synapse Portal 2 6 6 Setup will install Synapse Portal 2 6 6 in the following folder To install in a different folder dick Browse and select another folder Click Next to continue Destination Folder C Program Files x86 S ynaps Browse Space required 67 9MB Space available 44 068 Synapse Wireless Making Inbermebenabled Wireless Machine to Machine Wen Easy lt Back Next gt Cancel You can either enter the desired destination folder manually browse to the desired folder or just click Next to accept the default Synapse Portal 2 6 6 Setup Choose Components Choose which features of Synapse Portal 2 6 6 you want to install Check the components you want to install and uncheck the components you don t want to install Click Install to start the installation Description Position Your mouse ovek a component to see ts description Select components to install Space required 67 9MB Synapse Wireless Maling Intemetenabled wireless Machine
84. uments you need to be aware of Start with an Evaluation Kit Users Guide Each evaluation kit comes with its own users guide For example the DK 200 kit comes with the DK 200 Evaluation Kit Users Guide DK 200 Guide Evaluation Kit Users Guides walk you through the basics of unpacking an evaluation kit setting up wireless nodes and installing Portal software on a PC Synapse SNAP nodes and even their component SNAP Engines are also sold separately as well as bundled into evaluation kits Evaluation kit manuals are available from the Synapse support forum forums synapse wireless com showthread php t 9 The SNAP Users Guide contains general information about SNAP and SNAPpy It covers topics like the SNAPpy language and how to use it There is also a companion manual to this user s guide the SNAP Reference Manual In the SNAP Reference Manual you can find detailed information about SNAP and how to use it About This Manual This manual assumes you have read and understood an evaluation kit guide It assumes you have installed the Portal software and are now familiar with the basics of discovering nodes uploading SNAPpy scripts into them and controlling and monitoring them from Portal Portal Reference Manual Other Important Documentation Be sure to check out all of the SNAP documentation If you are completely new to SNAP be sure to check out the SNAP Primer which provides a complete overview of SNAP and how it
85. undamental concepts used in navigating the Portal GUI Pull down Menus At the top of the Portal GUI are pull down menus for File View Options Network and Help operations Clicking one of these top level menu choices will pull down a sub menu of additional choices For example clicking Network will present a sub menu from which you perform actions like Broadcast Ping Find Nodes or New Configuration Similarly clicking Help will display choices for SNAP Reference Manual Portal Reference Manual etc The convention is that menu choices ending in usually display additional menus or dialog boxes and menu choices not ending in cause immediate action to be taken with no further prompting Tool Bar Below the pull down menus is a horizontal Tool Bar from which you can initiate several actions Hovering the cursor over each button will display a short tool tip help message and clicking each button will initiate the action displayed by the tool tip Tabbed Windows The remainder of the Portal GUI is taken up by a changeable collection of tabbed windows Each of these windows has a name which is displayed in the tab for that window Many of the tabbed windows have toolbars of their own located in the horizontal region just below their labeled tab Portal starts out with an initial set of tabbed windows visible Sometimes clicking certain controls within one tabbed window will open and or switch to another tabbed
86. use in this way A This special file is required to be named init__ py tl Int D notice that there are two leading and two trailing underscore characters can be an empty file 0 bytes long but it is required to be present to tell Python which Portal is running internally that a directory is to be considered a module and thus imports from it should be allowed For more on this topic please refer to the standard Python programming documentation www python org is always a good place to start Portal Reference Manual Restore Original Working Directory The Restore Original Working Directory menu option provides an easy way to get back to the default set of script source files If you choose this menu option when you are in fact already using the original settings Portal will tell you so ks 7 Already using standard working directory nothing to revert If you were in fact using an alternate directory tree Portal will prompt you to make sure you want to change back Revert to standard working directory are you sure Note Your alternate working directory will remain unaltered Choose Yes to revert back to the original directory tree or No to continue using the alternate directory tree As the dialog box indicates the files in your alternate directory tree are unaffected by this change and you can resume working with them later by once again using the Set Working Directory menu option Configure
87. ust click on No If you do want to edit a copy of the original read only file click on Yes The usual file dialog box will allow you to specify the new file name The edit window will automatically switch to editing the newly created file Portal Reference Manual MyMcastCounter py EISIECIN WEI AS 1 TE TE TE OI Sample SNAPpy file for Evaluation Kit Boards Bridge End Device ProtoBoard and SNAPStick 3 4 io Dm JA Om Om 10 11 12 LA 14 15 16 17 18 19 20 21 22 23 24 25 d Press the gelect switch on any device to increment counter on all devices TE TE Te m Use Synapse Evaluation Board definitions from synapse evalBase import Comment the following out if you have your own HOOK 10M5 handler and be sure to call updateSevenSegmentDisplay from your own handler setHook HOOK 10M5 def defaultTimerHandler updatesevenseqmentDisplay secondCounter buttonCount numPatterns curPattern 0 Hs CO EsetHook HOOK STARTUP def startupEvent This is hooked into the HOOK STARTUP event global buttonState buttonTime r IT P Be sure to E Save your edits when you are done Your new script can be uploaded into one or more SNAP nodes using the 14 Upload SNAPpy Image button in the Node Info window Keyboard Shortcuts There are several keyboard shortcuts available in the Code Editor window Ctrl A Select all text in the window Ctrl B Increase font poi
88. vidual node including the Portal node can be viewed and changed from the Node Info tab If the Node Info tab is already visible within Portal selecting a node in the Node Views tab will display that specific node s info in the Node Info tab If the Node Info tab is not already visible you can display it by clicking View Node Info Window or by double clicking the desired node in the Node Views tab Starting in the upper left hand corner the Node Info tab shows the e Logical name of the node e Firmware or software for the Portal node version and type if special Debug AES 128 e Some network configuration parameters e Device Image and Image CRC for remote nodes or Image Modified date for Portal images e Image size information indicating how much space is in use in the node for SNAPpy scripts e License information Permanent or Demo e Some more network configuration parameters The left hand side continues with Path and Info panes The right hand side shows a tree view of the callable scripted functions Network Configuration Parameters AaQSadaeererxde Hicks N Firmware Version 2 6 2 with AES 128 platform RF200 U Network Address 06 73 95 MAC Address 00 1C 2C 1A D6 06 73 95 Device Image McastCounterDK200 Image CRC 0x37C7 Image Size 2121 bytes 3 License Permanent Channel 14 Network ID OxF15E Path Portal 00 00 01 J 1 Ripley 03 F9 C6 53 Hicks 06 73 95 68 t Total Round Trip
89. window You can also open additional tabbed windows by choosing them from the View menu Finally many of the tabbed windows can be launched from the main tool bar Rearranging Windows The tabbed windows in Portal can be dragged and repositioned on the screen To do this press and hold the left mouse button while the cursor is positioned over the tab label you want to move While holding the button down drag the tab until you see a light blue shadow indicating a possible new position for the window When you ve found a suitable new position release the mouse button and the move will be complete Portal Reference Manual Synapse Portal default swn Workspace C Users john brewer Documents Portal File VIEW Options Network Help y la S D tml E a Node View A a gt L Ripley gt Firmware Version 2 6 2 with AES 128 Platform 55200 Network Address 03 F9 C6 MAC Address 00 10 2C 14 76 03 F9 C6 Device Image Image CRC Image Size License Permanent Channel 14 Network ID OxF15E Path Drag tab as shown to move windows No path information collected Info In your Portal script use remoteNode setColumn name value to display information here Resizing Windows may be resized by clicking and dragging the horizontal and vertical borders separating them Closing Tabs You can close tabbed windows that you no longer want by clicking the small X located to the right of the

Download Pdf Manuals

Related Search

Related Contents

Viewsonic PJD5234L data projector  Sunjoy L-GZ605PST-A1 Installation Guide  DULCOTEST® DT1B Photomètre  Obstetrics & Gynecology- Specific PDA: A Resident Gadget  los sistemas de comederos Modelos C, C2, G y H2  User Manual - Dux Comfort (2.5kw, 3.4kw, 6.4kw) - v5  User Manual  003-2631-02 Guide de l`utilisateur Unité dentaire Elevance  顧客操作型端末におけることばインタフェース    

Copyright © All rights reserved. Failed to retrieve file