diff --git a/tools/cooja/build.xml b/tools/cooja/build.xml index f9468a4df..38c3feb33 100644 --- a/tools/cooja/build.xml +++ b/tools/cooja/build.xml @@ -51,6 +51,7 @@ The COOJA Simulator + @@ -64,6 +65,7 @@ The COOJA Simulator + @@ -78,6 +80,7 @@ The COOJA Simulator + @@ -110,6 +113,7 @@ The COOJA Simulator + @@ -125,6 +129,7 @@ The COOJA Simulator + @@ -139,6 +144,7 @@ The COOJA Simulator + @@ -153,6 +159,7 @@ The COOJA Simulator + @@ -166,6 +173,7 @@ The COOJA Simulator + @@ -181,6 +189,7 @@ The COOJA Simulator + @@ -227,7 +236,7 @@ The COOJA Simulator - + diff --git a/tools/cooja/java/org/contikios/cooja/plugins/VariableWatcher.java b/tools/cooja/java/org/contikios/cooja/plugins/VariableWatcher.java index 6c8c82ea9..616aee0fb 100644 --- a/tools/cooja/java/org/contikios/cooja/plugins/VariableWatcher.java +++ b/tools/cooja/java/org/contikios/cooja/plugins/VariableWatcher.java @@ -1,4 +1,5 @@ /* + * Copyright (c) 2014, TU Braunschweig. * Copyright (c) 2009, Swedish Institute of Computer Science. * All rights reserved. * @@ -32,49 +33,54 @@ package org.contikios.cooja.plugins; import java.awt.BorderLayout; import java.awt.Color; -import java.awt.Component; import java.awt.Dimension; +import java.awt.FlowLayout; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; -import java.awt.event.FocusAdapter; import java.awt.event.FocusEvent; import java.awt.event.FocusListener; -import java.awt.event.KeyEvent; -import java.awt.event.KeyListener; -import java.beans.PropertyChangeEvent; -import java.beans.PropertyChangeListener; +import java.awt.event.ItemEvent; +import java.awt.event.ItemListener; import java.text.NumberFormat; +import java.text.ParseException; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.List; -import java.util.Vector; - +import javax.swing.AbstractButton; import javax.swing.BorderFactory; import javax.swing.Box; import javax.swing.BoxLayout; import javax.swing.JButton; +import javax.swing.JCheckBox; import javax.swing.JComboBox; import javax.swing.JFormattedTextField; import javax.swing.JLabel; +import javax.swing.JOptionPane; import javax.swing.JPanel; import javax.swing.JTextField; -import javax.swing.SwingUtilities; +import javax.swing.JToggleButton; +import javax.swing.event.PopupMenuEvent; +import javax.swing.event.PopupMenuListener; import javax.swing.text.AttributeSet; import javax.swing.text.BadLocationException; +import javax.swing.text.DefaultFormatterFactory; +import javax.swing.text.DocumentFilter; import javax.swing.text.PlainDocument; - -import org.jdom.Element; - +import org.apache.log4j.Logger; import org.contikios.cooja.ClassDescription; import org.contikios.cooja.Cooja; +import org.contikios.cooja.HasQuickHelp; import org.contikios.cooja.Mote; import org.contikios.cooja.MotePlugin; import org.contikios.cooja.PluginType; import org.contikios.cooja.Simulation; import org.contikios.cooja.VisPlugin; +import org.contikios.cooja.mote.memory.MemoryInterface; import org.contikios.cooja.mote.memory.UnknownVariableException; import org.contikios.cooja.mote.memory.VarMemory; +import org.jdesktop.swingx.autocomplete.AutoCompleteDecorator; +import org.jdom.Element; /** * Variable Watcher enables a user to watch mote variables during a simulation. @@ -83,41 +89,125 @@ import org.contikios.cooja.mote.memory.VarMemory; * User can also see which variables seems to be available on the selected node. * * @author Fredrik Osterlind + * @author Enrico Jorns */ @ClassDescription("Variable Watcher") @PluginType(PluginType.MOTE_PLUGIN) -public class VariableWatcher extends VisPlugin implements MotePlugin { +public class VariableWatcher extends VisPlugin implements MotePlugin, HasQuickHelp { private static final long serialVersionUID = 1L; - - private VarMemory moteMemory; + private static final Logger logger = Logger.getLogger(VariableWatcher.class.getName()); private final static int LABEL_WIDTH = 170; private final static int LABEL_HEIGHT = 15; - private final static int BYTE_INDEX = 0; - private final static int INT_INDEX = 1; - private final static int ARRAY_INDEX = 2; - private final static int CHAR_ARRAY_INDEX = 3; - - private JPanel lengthPane; + private JComboBox varNameCombo; + private JComboBox varTypeCombo; + private JComboBox varFormatCombo; + private JPanel infoPane; + private JFormattedTextField varAddressField; + private JTextField varSizeField; private JPanel valuePane; - private JPanel charValuePane; - private JComboBox varName; - private JComboBox varType; private JFormattedTextField[] varValues; - private JTextField[] charValues; - private JFormattedTextField varLength; + private byte[] bufferedBytes; + private JButton readButton; + private AbstractButton monitorButton; private JButton writeButton; private JLabel debuglbl; - private KeyListener charValueKeyListener; - private FocusListener charValueFocusListener; - private KeyListener varValueKeyListener; - private FocusAdapter jFormattedTextFocusAdapter; + private VarMemory moteMemory; + + MemoryInterface.SegmentMonitor memMonitor; + long monitorAddr; + int monitorSize; private NumberFormat integerFormat; + private ValueFormatter hf; private Mote mote; - + + @Override + public String getQuickHelp() { + return "Variable Watcher" + + "

Read and monitor variables or memory segments." + + "

Use the dropdown list to select variable to read. " + + "If no size information is available size can be set manually." + + "

To freely select the monitored region, enable address checkbox " + + "and set both address and size."; + } + + /** + * Display types for variables. + */ + public enum VarTypes { + + BYTE("byte", 1), + SHORT("short", 2), + INT("int", 2), + LONG("long", 4), + ADDR("address", 4); + + String mRep; + int mSize; + + VarTypes(String rep, int size) { + mRep = rep; + mSize = size; + } + + /** + * Returns the number of bytes for this data type. + * + * @return Size in bytes + */ + public int getBytes() { + return mSize; + } + + protected void setBytes(int size) { + mSize = size; + } + + /** + * Returns String name of this variable type. + * + * @return Type name + */ + @Override + public String toString() { + return mRep; + } + } + + /** + * Display formats for variables. + */ + public enum VarFormats { + + CHAR("Char", 0), + DEC("Decimal", 10), + HEX("Hex", 16); + + String mRep; + int mBase; + + VarFormats(String rep, int base) { + mRep = rep; + mBase = base; + } + + /** + * Returns String name of this variable representation. + * + * @return Type name + */ + @Override + public String toString() { + return mRep; + } + } + + VarFormats[] valueFormats = {VarFormats.CHAR, VarFormats.DEC, VarFormats.HEX}; + VarTypes[] valueTypes = {VarTypes.BYTE, VarTypes.SHORT, VarTypes.INT, VarTypes.LONG, VarTypes.ADDR}; + /** * @param moteToView Mote * @param simulation Simulation @@ -134,6 +224,7 @@ public class VariableWatcher extends VisPlugin implements MotePlugin { mainPane.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10)); mainPane.setLayout(new BoxLayout(mainPane, BoxLayout.Y_AXIS)); JPanel smallPane; + JPanel readPane; // Variable name smallPane = new JPanel(new BorderLayout()); @@ -141,29 +232,54 @@ public class VariableWatcher extends VisPlugin implements MotePlugin { label.setPreferredSize(new Dimension(LABEL_WIDTH,LABEL_HEIGHT)); smallPane.add(BorderLayout.WEST, label); - varName = new JComboBox(); - varName.setEditable(true); - varName.setSelectedItem("[enter or pick name]"); - List allPotentialVarNames = new ArrayList<>(moteMemory.getVariableNames()); Collections.sort(allPotentialVarNames); - for (String aVarName: allPotentialVarNames) { - varName.addItem(aVarName); - } - varName.addKeyListener(new KeyListener() { - public void keyPressed(KeyEvent e) { - writeButton.setEnabled(false); + varNameCombo = new JComboBox(allPotentialVarNames.toArray()); + AutoCompleteDecorator.decorate(varNameCombo); + varNameCombo.setEditable(true); + varNameCombo.setSelectedItem(""); + + // use longest variable name as prototye for width + String longestVarname = ""; + int maxLength = 0; + for (String w : allPotentialVarNames) { + if (w.length() > maxLength) { + maxLength = w.length(); + longestVarname = w; } - public void keyTyped(KeyEvent e) { - writeButton.setEnabled(false); + } + varNameCombo.setPrototypeDisplayValue(longestVarname); + + varNameCombo.addPopupMenuListener(new PopupMenuListener() { + + String lastItem = ""; + + @Override + public void popupMenuWillBecomeVisible(PopupMenuEvent e) { } - public void keyReleased(KeyEvent e) { - writeButton.setEnabled(false); + + // apply new variable name if popup is closed + @Override + public void popupMenuWillBecomeInvisible(PopupMenuEvent e) { + String currentItem = (String)varNameCombo.getSelectedItem(); + + /* If item did not changed, skip! */ + if (currentItem == null || currentItem.equals(lastItem)) { + return; + } + lastItem = currentItem; + + updateBySelectedVarname(); + } + + @Override + public void popupMenuCanceled(PopupMenuEvent e) { } }); + - smallPane.add(BorderLayout.EAST, varName); + smallPane.add(BorderLayout.EAST, varNameCombo); mainPane.add(smallPane); // Variable type @@ -172,77 +288,137 @@ public class VariableWatcher extends VisPlugin implements MotePlugin { label.setPreferredSize(new Dimension(LABEL_WIDTH,LABEL_HEIGHT)); smallPane.add(BorderLayout.WEST, label); - varType = new JComboBox(); - varType.addItem("Byte (1 byte)"); // BYTE_INDEX = 0 - varType.addItem("Integer (" + moteToView.getMemory().getLayout().intSize + " bytes)"); // INT_INDEX = 1 - varType.addItem("Byte array (x bytes)"); // ARRAY_INDEX = 2 - varType.addItem("Char array (x bytes)"); // CHAR_ARRAY_INDEX = 3 + /* set correct integer and address size */ + valueTypes[2].setBytes(moteToView.getMemory().getLayout().intSize); + valueTypes[4].setBytes(moteToView.getMemory().getLayout().addrSize); - varType.addActionListener(new ActionListener() { - public void actionPerformed(ActionEvent e) { - int selectedIndex = varType.getSelectedIndex(); - if (selectedIndex == ARRAY_INDEX || selectedIndex == CHAR_ARRAY_INDEX) { - lengthPane.setVisible(true); - setNumberOfValues(((Number) varLength.getValue()).intValue()); - if(selectedIndex == CHAR_ARRAY_INDEX) { - charValuePane.setVisible(true); - setNumberOfCharValues(((Number) varLength.getValue()).intValue()); - } else { - charValuePane.setVisible(false); - setNumberOfCharValues(1); - } - } else { - lengthPane.setVisible(false); - charValuePane.setVisible(false); - setNumberOfValues(1); - setNumberOfCharValues(1); + JPanel reprPanel = new JPanel(new BorderLayout()); + varTypeCombo = new JComboBox(valueTypes); + varTypeCombo.addItemListener(new ItemListener() { + + @Override + public void itemStateChanged(ItemEvent e) { + if (e.getStateChange() == ItemEvent.SELECTED) { + hf.setType((VarTypes) e.getItem()); + updateNumberOfValues(); // number of elements should have changed } - pack(); } }); - smallPane.add(BorderLayout.EAST, varType); + varFormatCombo = new JComboBox(valueFormats); + varFormatCombo.setSelectedItem(VarFormats.HEX); + varFormatCombo.addItemListener(new ItemListener() { + + @Override + public void itemStateChanged(ItemEvent e) { + if (e.getStateChange() == ItemEvent.SELECTED) { + + hf.setFormat((VarFormats) e.getItem()); + refreshValues(); // format of elements should have changed + } + } + }); + + reprPanel.add(BorderLayout.WEST, varTypeCombo); + reprPanel.add(BorderLayout.EAST, varFormatCombo); + + smallPane.add(BorderLayout.EAST, reprPanel); mainPane.add(smallPane); - /* The recommended fix for the bug #4740914 - * Synopsis : Doing selectAll() in a JFormattedTextField on focusGained - * event doesn't work. - */ - jFormattedTextFocusAdapter = new FocusAdapter() { - public void focusGained(final FocusEvent ev) { - SwingUtilities.invokeLater(new Runnable() { - public void run() { - JTextField jtxt = (JTextField)ev.getSource(); - jtxt.selectAll(); - } - }); - } - }; + mainPane.add(Box.createRigidArea(new Dimension(0,5))); - // Variable length - lengthPane = new JPanel(new BorderLayout()); - label = new JLabel("Variable length"); - label.setPreferredSize(new Dimension(LABEL_WIDTH,LABEL_HEIGHT)); - lengthPane.add(BorderLayout.WEST, label); + infoPane = new JPanel(); + infoPane.setLayout(new BoxLayout(infoPane, BoxLayout.Y_AXIS)); - varLength = new JFormattedTextField(integerFormat); - varLength.setValue(new Integer(1)); - varLength.setColumns(4); - varLength.addPropertyChangeListener("value", new PropertyChangeListener() { - public void propertyChange(PropertyChangeEvent e) { - setNumberOfValues(((Number) varLength.getValue()).intValue()); - if(varType.getSelectedIndex() == CHAR_ARRAY_INDEX) { - setNumberOfCharValues(((Number) varLength.getValue()).intValue()); + JPanel addrInfoPane = new JPanel(); + addrInfoPane.setLayout(new BoxLayout(addrInfoPane, BoxLayout.LINE_AXIS)); + JPanel sizeInfoPane = new JPanel(); + sizeInfoPane.setLayout(new BoxLayout(sizeInfoPane, BoxLayout.LINE_AXIS)); + + label = new JLabel("Address"); + addrInfoPane.add(label); + addrInfoPane.add(Box.createHorizontalGlue()); + final JCheckBox varAddrCheckBox = new JCheckBox(); + varAddrCheckBox.addItemListener(new ItemListener() { + + @Override + public void itemStateChanged(ItemEvent e) { + if (varAddrCheckBox.isSelected()) { + varNameCombo.setEnabled(false); + varNameCombo.setEditable(false); + varAddressField.setEditable(true); + varSizeField.setEditable(true); + } else { + varNameCombo.setEnabled(true); + varNameCombo.setEditable(true); + varAddressField.setEditable(false); + varSizeField.setEditable(false); + // switch back to var name control + updateBySelectedVarname(); } } }); - varLength.addFocusListener(jFormattedTextFocusAdapter); + addrInfoPane.add(varAddrCheckBox); - lengthPane.add(BorderLayout.EAST, varLength); - mainPane.add(lengthPane); - mainPane.add(Box.createRigidArea(new Dimension(0,5))); + DefaultFormatterFactory defac = new DefaultFormatterFactory(new ValueFormatter(VarTypes.LONG, VarFormats.HEX)); + varAddressField = new JFormattedTextField(defac); + varAddressField.setValue(null); + varAddressField.setEditable(false); + varAddressField.setColumns(8); + varAddressField.setMaximumSize(varAddressField.getPreferredSize()); + /* Select all text when clicking in text field */ + varAddressField.addFocusListener(new FocusListener() { - lengthPane.setVisible(false); + @Override + public void focusGained(FocusEvent e) { + varAddressField.selectAll(); + } + + @Override + public void focusLost(FocusEvent e) { + } + }); + /* Update when content might have changed */ + varAddressField.addActionListener(new ActionListener() { + + @Override + public void actionPerformed(ActionEvent e) { + updateNumberOfValues(); + } + }); + addrInfoPane.add(varAddressField); + + infoPane.add(addrInfoPane); + + label = new JLabel("Size"); + sizeInfoPane.add(label); + sizeInfoPane.add(Box.createHorizontalGlue()); + varSizeField = new JTextField("N/A"); + varSizeField.setEditable(false); + varSizeField.setColumns(8); + varSizeField.setMaximumSize(varSizeField.getPreferredSize()); + /* Select all text when clicking in text field */ + varSizeField.addFocusListener(new FocusListener() { + @Override + public void focusGained(final FocusEvent pE) { + varSizeField.selectAll(); + } + + @Override + public void focusLost(final FocusEvent pE) { + } + }); + /* Update size information when text box action fired */ + varSizeField.addActionListener(new ActionListener() { + @Override + public void actionPerformed(ActionEvent e) { + updateNumberOfValues(); + } + }); + sizeInfoPane.add(varSizeField); + + infoPane.add(sizeInfoPane); + mainPane.add(infoPane); // Variable value label label = new JLabel("Variable value"); @@ -252,346 +428,445 @@ public class VariableWatcher extends VisPlugin implements MotePlugin { // Variable value(s) valuePane = new JPanel(); - valuePane.setLayout(new BoxLayout(valuePane, BoxLayout.X_AXIS)); + valuePane.setLayout(new BoxLayout(valuePane, BoxLayout.PAGE_AXIS)); + + hf = new ValueFormatter( + (VarTypes) varTypeCombo.getSelectedItem(), + (VarFormats) varFormatCombo.getSelectedItem()); varValues = new JFormattedTextField[1]; varValues[0] = new JFormattedTextField(integerFormat); - varValues[0].setValue(new Integer(0)); + varValues[0].setValue(null); varValues[0].setColumns(3); - varValues[0].setText("?"); - - for (JFormattedTextField varValue: varValues) { - valuePane.add(varValue); - - } - charValuePane = new JPanel(); - charValuePane.setLayout(new BoxLayout(charValuePane, BoxLayout.X_AXIS)); - charValues = new JTextField[1]; - charValues[0] = new JTextField(); - charValues[0].setText("?"); - charValues[0].setColumns(1); - charValues[0].setDocument(new JTextFieldLimit(1, false)); - - /* Key Listener for char value changes. */ - charValueKeyListener = new KeyListener(){ - @Override - public void keyPressed(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JTextField jtxt = (JTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - if(jtxt.getText().trim().length() != 0) { - char ch = jtxt.getText().trim().charAt(0); - varValues[index].setValue(new Integer(ch)); - } else { - varValues[index].setValue(new Integer(0)); - } - } - - @Override - public void keyReleased(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JTextField jtxt = (JTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - if(jtxt.getText().trim().length() != 0) { - char ch = jtxt.getText().trim().charAt(0); - varValues[index].setValue(new Integer(ch)); - } else { - varValues[index].setValue(new Integer(0)); - } - } - - @Override - public void keyTyped(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JTextField jtxt = (JTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - if(jtxt.getText().trim().length() != 0) { - char ch = jtxt.getText().trim().charAt(0); - varValues[index].setValue(new Integer(ch)); - } else { - varValues[index].setValue(new Integer(0)); - } - } - }; - - /* Key Listener for value changes. */ - varValueKeyListener = new KeyListener() { - @Override - public void keyPressed(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JFormattedTextField fmtTxt = (JFormattedTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - try { - int value = Integer.parseInt(fmtTxt.getText().trim()); - char ch = (char)(0xFF & value); - charValues[index].setText(Character.toString(ch)); - } catch(Exception e) { - charValues[index].setText(Character.toString((char)0)); - } - } - - @Override - public void keyReleased(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JFormattedTextField fmtTxt = (JFormattedTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - try { - int value = Integer.parseInt(fmtTxt.getText().trim()); - char ch = (char)(0xFF & value); - charValues[index].setText(Character.toString(ch)); - } catch(Exception e) { - charValues[index].setText(Character.toString((char)0)); - } - } - - @Override - public void keyTyped(KeyEvent arg0) { - Component comp = arg0.getComponent(); - JFormattedTextField fmtTxt = (JFormattedTextField)comp; - int index = comp.getParent().getComponentZOrder(comp); - try { - int value = Integer.parseInt(fmtTxt.getText().trim()); - char ch = (char)(0xFF & value); - charValues[index].setText(Character.toString(ch)); - } catch(Exception e) { - charValues[index].setText(Character.toString((char)0)); - } - } - - }; - - charValueFocusListener = new FocusListener() { - @Override - public void focusGained(FocusEvent arg0) { - JTextField jtxt = (JTextField)arg0.getComponent(); - jtxt.selectAll(); - } - @Override - public void focusLost(FocusEvent arg0) { - - } - }; - - - for (JTextField charValue: charValues) { - charValuePane.add(charValue); - } mainPane.add(valuePane); mainPane.add(Box.createRigidArea(new Dimension(0,5))); - charValuePane.setVisible(false); - mainPane.add(charValuePane); - mainPane.add(Box.createRigidArea(new Dimension(0,5))); debuglbl = new JLabel(); mainPane.add(new JPanel().add(debuglbl)); mainPane.add(Box.createRigidArea(new Dimension(0,5))); - // Read/write buttons smallPane = new JPanel(new BorderLayout()); - JButton button = new JButton("Read"); - button.addActionListener(new ActionListener() { + readPane = new JPanel(new BorderLayout()); + + /* Read button */ + readButton = new JButton("Read"); + readButton.addActionListener(new ActionListener() { + + @Override public void actionPerformed(ActionEvent e) { - if (varType.getSelectedIndex() == BYTE_INDEX) { - try { - byte val = moteMemory.getByteValueOf((String) varName.getSelectedItem()); - varValues[0].setValue(new Integer(0xFF & val)); - varName.setBackground(Color.WHITE); - writeButton.setEnabled(true); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - writeButton.setEnabled(false); - } - } else if (varType.getSelectedIndex() == INT_INDEX) { - try { - int val = moteMemory.getIntValueOf((String) varName.getSelectedItem()); - varValues[0].setValue(new Integer(val)); - varName.setBackground(Color.WHITE); - writeButton.setEnabled(true); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - writeButton.setEnabled(false); - } - } else if (varType.getSelectedIndex() == ARRAY_INDEX || - varType.getSelectedIndex() == CHAR_ARRAY_INDEX) { - try { - int length = ((Number) varLength.getValue()).intValue(); - byte[] vals = moteMemory.getByteArray((String) varName.getSelectedItem(), length); - for (int i=0; i < length; i++) { - varValues[i].setValue(new Integer(0xFF & vals[i])); - } - if(varType.getSelectedIndex() == CHAR_ARRAY_INDEX) { - for (int i=0; i < length; i++) { - char ch = (char)(0xFF & vals[i]); - charValues[i].setText(Character.toString(ch)); - varValues[i].addKeyListener(varValueKeyListener); - } - } - varName.setBackground(Color.WHITE); - writeButton.setEnabled(true); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - writeButton.setEnabled(false); - } + if (!moteMemory.variableExists((String) varNameCombo.getSelectedItem())) { + ((JTextField) varNameCombo.getEditor().getEditorComponent()).setForeground(Color.RED); + writeButton.setEnabled(false); + return; + } + + try { + writeButton.setEnabled(true); + bufferedBytes = moteMemory.getByteArray( + (long) varAddressField.getValue(), + Integer.decode(varSizeField.getText())); + refreshValues(); + } catch (MemoryInterface.MoteMemoryException ex) { + JOptionPane.showMessageDialog(varNameCombo, ex.getMessage(), "MoteMemoryException", JOptionPane.ERROR_MESSAGE); } } }); - smallPane.add(BorderLayout.WEST, button); - button = new JButton("Write"); - button.addActionListener(new ActionListener() { + readPane.add(BorderLayout.WEST, readButton); + + /* MemoryMonitor required for monitor button */ + + /* Monitor button */ + monitorButton = new JToggleButton("Monitor"); + monitorButton.addActionListener(new ActionListener() { + + @Override public void actionPerformed(ActionEvent e) { - if (varType.getSelectedIndex() == BYTE_INDEX) { - try { - byte val = (byte) ((Number) varValues[0].getValue()).intValue(); - moteMemory.setByteValueOf((String) varName.getSelectedItem(), val); - varName.setBackground(Color.WHITE); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - } - } else if (varType.getSelectedIndex() == INT_INDEX) { - try { - int val = ((Number) varValues[0].getValue()).intValue(); - moteMemory.setIntValueOf((String) varName.getSelectedItem(), val); - varName.setBackground(Color.WHITE); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - } - } else if (varType.getSelectedIndex() == ARRAY_INDEX || - varType.getSelectedIndex() == CHAR_ARRAY_INDEX) { - try { - int length = ((Number) varLength.getValue()).intValue(); - byte[] vals = new byte[length]; - for (int i=0; i < length; i++) { - vals[i] = (byte) ((Number) varValues[i].getValue()).intValue(); - } - moteMemory.setByteArray((String) varName.getSelectedItem(), vals); - varName.setBackground(Color.WHITE); - writeButton.setEnabled(true); - } catch (UnknownVariableException ex) { - varName.setBackground(Color.RED); - writeButton.setEnabled(false); + // deselect + if (!((JToggleButton) e.getSource()).isSelected()) { + //System.out.println("Removing monitor " + memMonitor + " for addr " + monitorAddr + ", size " + monitorSize + ""); + mote.getMemory().removeSegmentMonitor( + (long) varAddressField.getValue(), + Integer.decode(varSizeField.getText()), + memMonitor); + varAddrCheckBox.setEnabled(true); + readButton.setEnabled(true); + writeButton.setEnabled(true); + varAddressField.setEnabled(true); + varSizeField.setEnabled(true); + if (!varAddrCheckBox.isSelected()) { + varNameCombo.setEnabled(true); } + return; } + + /* initial readout so we have a value to display */ + try { + bufferedBytes = moteMemory.getByteArray( + (long) varAddressField.getValue(), + Integer.decode(varSizeField.getText())); + refreshValues(); + } catch (MemoryInterface.MoteMemoryException ex) { + JOptionPane.showMessageDialog(varNameCombo, ex.getMessage(), "MoteMemoryException", JOptionPane.ERROR_MESSAGE); + monitorButton.setSelected(false); + return; + } + + memMonitor = new MemoryInterface.SegmentMonitor() { + + @Override + public void memoryChanged(MemoryInterface memory, EventType type, long address) { + bufferedBytes = moteMemory.getByteArray( + (long) varAddressField.getValue(), + Integer.decode(varSizeField.getText())); + + refreshValues(); + } + }; + //System.out.println("Adding monitor " + memMonitor + " for addr " + monitorAddr + ", size " + monitorSize + ""); + mote.getMemory().addSegmentMonitor( + MemoryInterface.SegmentMonitor.EventType.WRITE, + (long) varAddressField.getValue(), + Integer.decode(varSizeField.getText()), + memMonitor); + + /* During monitoring we neither allow writes nor to change variable */ + varAddrCheckBox.setEnabled(false); + readButton.setEnabled(false); + writeButton.setEnabled(false); + varAddressField.setEnabled(false); + varSizeField.setEnabled(false); + varNameCombo.setEnabled(false); } }); - smallPane.add(BorderLayout.EAST, button); - button.setEnabled(false); - writeButton = button; + + readPane.add(BorderLayout.EAST, monitorButton); + smallPane.add(BorderLayout.WEST, readPane); + + /* Write button */ + writeButton = new JButton("Write"); + writeButton.setEnabled(false); + writeButton.addActionListener(new ActionListener() { + + @Override + public void actionPerformed(ActionEvent e) { + + /* Convert from input field to byte array */ + int bytes = ((VarTypes) varTypeCombo.getSelectedItem()).getBytes(); + for (int element = 0; element < varValues.length; element++) { + for (int b = 0; b < bytes; b++) { + if (element * bytes + b > bufferedBytes.length - 1) { + break; + } + bufferedBytes[element * bytes + b] = (byte) ((((int) varValues[element].getValue()) >> (b * 8)) & 0xFF); + } + } + /* Write to memory */ + moteMemory.setByteArray((long) varAddressField.getValue(), bufferedBytes); + } + }); + + smallPane.add(BorderLayout.EAST, writeButton); mainPane.add(smallPane); add(BorderLayout.NORTH, mainPane); pack(); } - private void setNumberOfValues(int nr) { + private void updateBySelectedVarname() { + try { + String currentItem = (String) varNameCombo.getSelectedItem(); + /* invalidate byte field */ + bufferedBytes = null; + /* calculate number of elements required to show the value in the given size */ + varAddressField.setValue(moteMemory.getVariableAddress(currentItem)); + int size = moteMemory.getVariableSize(currentItem); + /* Disable buttons if variable reported size < 1, activate otherwise */ + if (size < 1) { + varSizeField.setText("N/A"); + varSizeField.setEditable(true); + } else { + varSizeField.setText(String.valueOf(size)); + varSizeField.setEditable(false); + } + updateNumberOfValues(); + } catch (UnknownVariableException ex) { + ((JTextField) varNameCombo.getEditor().getEditorComponent()).setForeground(Color.RED); + writeButton.setEnabled(false); + } + } + + /** + * String to Value to String conversion for JFormattedTextField + * based on selected VarTypes and VarFormats. + */ + public class ValueFormatter extends JFormattedTextField.AbstractFormatter { + + final String TEXT_NOT_TO_TOUCH; + + private VarTypes mType; + private VarFormats mFormat; + + public ValueFormatter(VarTypes type, VarFormats format) { + mType = type; + mFormat = format; + if (mFormat == VarFormats.HEX) { + TEXT_NOT_TO_TOUCH = "0x"; + } + else { + TEXT_NOT_TO_TOUCH = ""; + } + } + + public void setType(VarTypes type) { + mType = type; + } + + public void setFormat(VarFormats format) { + mFormat = format; + } + + @Override + public Object stringToValue(String text) throws ParseException { + Object ret; + switch (mFormat) { + case CHAR: + ret = text.charAt(0); + break; + case DEC: + case HEX: + try { + switch (mType) { + case BYTE: + case SHORT: + ret = Integer.decode(text); + break; + case INT: + case LONG: + case ADDR: + ret = Long.decode(text); + break; + default: + ret = null; + } + } + catch (NumberFormatException ex) { + ret = 0; + } + break; + default: + ret = null; + } + return ret; + } + + @Override + public String valueToString(Object value) throws ParseException { + if (value == null) { + return "N/A"; + } + + switch (mFormat) { + case CHAR: + return String.format("%c", value); + case DEC: + return String.format("%d", value); + case HEX: + return String.format("0x%x", value); + default: + return ""; + } + } + + /* Do not override TEXT_NOT_TO_TOUCH */ + @Override + public DocumentFilter getDocumentFilter() { + /** @todo: There seem to be some remaining issues regarding input handling */ + return new DocumentFilter() { + + @Override + public void insertString(DocumentFilter.FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException { + if (offset < TEXT_NOT_TO_TOUCH.length()) { + return; + } + super.insertString(fb, offset, string, attr); + } + + @Override + public void replace(DocumentFilter.FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException { + if (offset < TEXT_NOT_TO_TOUCH.length()) { + length = Math.max(0, length - TEXT_NOT_TO_TOUCH.length()); + offset = TEXT_NOT_TO_TOUCH.length(); + } + super.replace(fb, offset, length, text, attrs); + } + + @Override + public void remove(DocumentFilter.FilterBypass fb, int offset, int length) throws BadLocationException { + if (offset < TEXT_NOT_TO_TOUCH.length()) { + length = Math.max(0, length + offset - TEXT_NOT_TO_TOUCH.length()); + offset = TEXT_NOT_TO_TOUCH.length(); + } + if (length > 0) { + super.remove(fb, offset, length); + } + } + }; + } + } + + + /** + * Updates all value fields based on buffered data. + * + * @note Does not read memory. Leaves number of fields unchanged. + */ + private void refreshValues() { + + int bytes = Integer.decode(varSizeField.getText()); + int typeSize = ((VarTypes) varTypeCombo.getSelectedItem()).getBytes(); + int elements = (int) Math.ceil((double) bytes / typeSize); + + /* Skip if we have no data to set */ + if ((bufferedBytes == null) || (bufferedBytes.length < bytes)) { + return; + } + + /* Set values based on buffered data */ + for (int i = 0; i < elements; i += 1) { + int val = 0; + for (int j = 0; j < typeSize; j++) { + /* skip if we do note have more bytes do consume. + This may happen e.g. if we display long (4 bytes) but have only 3 bytes */ + if (i * typeSize + j > bufferedBytes.length - 1) { + break; + } + val += ((bufferedBytes[i * typeSize + j] & 0xFF) << (j * 8)); + } + varValues[i].setValue(val); + try { + varValues[i].commitEdit(); + } + catch (ParseException ex) { + logger.error(ex); + } + } + + } + + /** + * Updates the number of value fields. + */ + private void updateNumberOfValues() { + valuePane.removeAll(); - if (nr > 0) { - varValues = new JFormattedTextField[nr]; - for (int i=0; i < nr; i++) { - varValues[i] = new JFormattedTextField(integerFormat); - varValues[i] .setValue(new Integer(0)); - varValues[i] .setColumns(3); - varValues[i] .setText("?"); - varValues[i].addFocusListener(jFormattedTextFocusAdapter); - valuePane.add(varValues[i]); + JPanel linePane = new JPanel(new FlowLayout(FlowLayout.LEFT, 0, 0)); + + DefaultFormatterFactory defac = new DefaultFormatterFactory(hf); + long address = (varAddressField.getValue() == null) ? 0 : (long) varAddressField.getValue(); + int bytes; + try { + //address = Integer.parseInt(varAddressField.getText()); + bytes = Integer.parseInt(varSizeField.getText()); + } catch (NumberFormatException ex) { + bytes = 0; + } + + int typeSize = ((VarTypes) varTypeCombo.getSelectedItem()).getBytes(); + int elements = (int) Math.ceil((double) bytes / typeSize); + + /* If no/unknown size: disable buttons and abort */ + if (elements == 0) { + readButton.setEnabled(false); + monitorButton.setEnabled(false); + writeButton.setEnabled(false); + return; + } + + varValues = new JFormattedTextField[elements]; + for (int i = 0; i < elements; i++) { + varValues[i] = new JFormattedTextField(defac); + varValues[i].setColumns(((VarTypes) varTypeCombo.getSelectedItem()).getBytes() * 2 + 2); + varValues[i].setToolTipText(String.format("0x%04x", address + i * typeSize)); + linePane.add(varValues[i]); + /* After 8 Elements, break line */ + if ((i + 1) % 8 == 0) { + valuePane.add(linePane); + linePane = new JPanel(new FlowLayout(FlowLayout.LEFT, 0, 0)); } } + valuePane.add(linePane); + + readButton.setEnabled(true); + monitorButton.setEnabled(true); + writeButton.setEnabled(true); + + refreshValues(); + pack(); - } - - private void setNumberOfCharValues(int nr) { - charValuePane.removeAll(); - - if (nr > 0) { - charValues = new JTextField[nr]; - for (int i=0; i < nr; i++) { - charValues[i] = new JTextField(); - charValues[i] .setColumns(1); - charValues[i] .setText("?"); - charValues[i].setDocument(new JTextFieldLimit(1, false)); - charValues[i].addKeyListener(charValueKeyListener); - charValues[i].addFocusListener(charValueFocusListener); - charValuePane.add(charValues[i]); - } + + /* Assure we do not loose the window due to placement outside desktop */ + if (getX() < 0) { + setLocation(0, getY()); } - pack(); } + @Override public void closePlugin() { + /* Make sure to release monitor */ + if (monitorButton.isSelected()) { + monitorButton.doClick(); + } } + @Override public Collection getConfigXML() { // Return currently watched variable and type - Vector config = new Vector(); + List config = new ArrayList<>(); Element element; // Selected variable name element = new Element("varname"); - element.setText((String) varName.getSelectedItem()); + element.setText((String) varNameCombo.getSelectedItem()); config.add(element); // Selected variable type - if (varType.getSelectedIndex() == BYTE_INDEX) { - element = new Element("vartype"); - element.setText("byte"); - config.add(element); - } else if (varType.getSelectedIndex() == INT_INDEX) { - element = new Element("vartype"); - element.setText("int"); - config.add(element); - } else if (varType.getSelectedIndex() == ARRAY_INDEX) { - element = new Element("vartype"); - element.setText("array"); - config.add(element); - element = new Element("array_length"); - element.setText(varLength.getValue().toString()); - config.add(element); - } else if (varType.getSelectedIndex() == CHAR_ARRAY_INDEX) { - element = new Element("vartype"); - element.setText("chararray"); - config.add(element); - element = new Element("array_length"); - element.setText(varLength.getValue().toString()); - config.add(element); - } - + element = new Element("vartype"); + element.setText(String.valueOf(varTypeCombo.getSelectedIndex())); + config.add(element); + + // Selected output format + element = new Element("varformat"); + element.setText(String.valueOf(varFormatCombo.getSelectedIndex())); + config.add(element); return config; } + @Override public boolean setConfigXML(Collection configXML, boolean visAvailable) { - lengthPane.setVisible(false); - setNumberOfValues(1); - varLength.setValue(1); - for (Element element : configXML) { - if (element.getName().equals("varname")) { - varName.setSelectedItem(element.getText()); - } else if (element.getName().equals("vartype")) { - if (element.getText().equals("byte")) { - varType.setSelectedIndex(BYTE_INDEX); - } else if (element.getText().equals("int")) { - varType.setSelectedIndex(INT_INDEX); - } else if (element.getText().equals("array")) { - varType.setSelectedIndex(ARRAY_INDEX); - lengthPane.setVisible(true); - } else if (element.getText().equals("chararray")) { - varType.setSelectedIndex(CHAR_ARRAY_INDEX); - lengthPane.setVisible(true); - } - } else if (element.getName().equals("array_length")) { - int nrValues = Integer.parseInt(element.getText()); - setNumberOfValues(nrValues); - varLength.setValue(nrValues); + switch (element.getName()) { + case "varname": + varNameCombo.setSelectedItem(element.getText()); + break; + case "vartype": + varTypeCombo.setSelectedIndex(Integer.parseInt(element.getText())); + break; + case "varformat": + varFormatCombo.setSelectedIndex(Integer.parseInt(element.getText())); + break; } } + updateNumberOfValues(); return true; } + @Override public Mote getMote() { return mote; } @@ -616,6 +891,7 @@ class JTextFieldLimit extends PlainDocument { toUppercase = upper; } + @Override public void insertString(int offset, String str, AttributeSet attr) throws BadLocationException { if (str == null) { diff --git a/tools/cooja/lib/SWINGX_LICENSE b/tools/cooja/lib/SWINGX_LICENSE new file mode 100644 index 000000000..168cea070 --- /dev/null +++ b/tools/cooja/lib/SWINGX_LICENSE @@ -0,0 +1,511 @@ +Copyright (c) 2005-2006 Sun Microsystems, Inc., 4150 Network Circle, Santa +Clara, California 95054, U.S.A. All rights reserved. Use is subject +to license terms below. Sun, Sun Microsystems and the Sun logo are +trademarks or registered trademarks of Sun Microsystems, Inc. in the +U.S. and other countries. + +Notice: This product is covered by U.S. export control laws and may be +subject to the export or import laws in other countries. These laws may +restrict the fields of use for this software and may require you to +secure government authorization. + + GNU LESSER GENERAL PUBLIC LICENSE + Version 2.1, February 1999 + + Copyright (C) 1991, 1999 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the Lesser GPL. It also counts + as the successor of the GNU Library Public License, version 2, hence + the version number 2.1.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Lesser General Public License, applies to some +specially designated software packages--typically libraries--of the +Free Software Foundation and other authors who decide to use it. You +can use it too, but we suggest you first think carefully about whether +this license or the ordinary General Public License is the better +strategy to use in any particular case, based on the explanations below. + + When we speak of free software, we are referring to freedom of use, +not price. Our General Public Licenses are designed to make sure that +you have the freedom to distribute copies of free software (and charge +for this service if you wish); that you receive source code or can get +it if you want it; that you can change the software and use pieces of +it in new free programs; and that you are informed that you can do +these things. + + To protect your rights, we need to make restrictions that forbid +distributors to deny you these rights or to ask you to surrender these +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the library or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link other code with the library, you must provide +complete object files to the recipients, so that they can relink them +with the library after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + We protect your rights with a two-step method: (1) we copyright the +library, and (2) we offer you this license, which gives you legal +permission to copy, distribute and/or modify the library. + + To protect each distributor, we want to make it very clear that +there is no warranty for the free library. Also, if the library is +modified by someone else and passed on, the recipients should know +that what they have is not the original version, so that the original +author's reputation will not be affected by problems that might be +introduced by others. + + Finally, software patents pose a constant threat to the existence of +any free program. We wish to make sure that a company cannot +effectively restrict the users of a free program by obtaining a +restrictive license from a patent holder. Therefore, we insist that +any patent license obtained for a version of the library must be +consistent with the full freedom of use specified in this license. + + Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License. This license, the GNU Lesser +General Public License, applies to certain designated libraries, and +is quite different from the ordinary General Public License. We use +this license for certain libraries in order to permit linking those +libraries into non-free programs. + + When a program is linked with a library, whether statically or using +a shared library, the combination of the two is legally speaking a +combined work, a derivative of the original library. The ordinary +General Public License therefore permits such linking only if the +entire combination fits its criteria of freedom. The Lesser General +Public License permits more lax criteria for linking other code with +the library. + + We call this license the "Lesser" General Public License because it +does Less to protect the user's freedom than the ordinary General +Public License. It also provides other free software developers Less +of an advantage over competing non-free programs. These disadvantages +are the reason we use the ordinary General Public License for many +libraries. However, the Lesser license provides advantages in certain +special circumstances. + + For example, on rare occasions, there may be a special need to +encourage the widest possible use of a certain library, so that it becomes +a de-facto standard. To achieve this, non-free programs must be +allowed to use the library. A more frequent case is that a free +library does the same job as widely used non-free libraries. In this +case, there is little to gain by limiting the free library to free +software only, so we use the Lesser General Public License. + + In other cases, permission to use a particular library in non-free +programs enables a greater number of people to use a large body of +free software. For example, permission to use the GNU C Library in +non-free programs enables many more people to use the whole GNU +operating system, as well as its variant, the GNU/Linux operating +system. + + Although the Lesser General Public License is Less protective of the +users' freedom, it does ensure that the user of a program that is +linked with the Library has the freedom and the wherewithal to run +that program using a modified version of the Library. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, whereas the latter must +be combined with the library in order to run. + + GNU LESSER GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library or other +program which contains a notice placed by the copyright holder or +other authorized party saying it may be distributed under the terms of +this Lesser General Public License (also called "this License"). +Each licensee is addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also combine or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (1) uses at run time a + copy of the library already present on the user's computer system, + rather than copying library functions into the executable, and (2) + will operate properly with a modified version of the library, if + the user installs one, as long as the modified version is + interface-compatible with the version that the work was made with. + + c) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + d) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + e) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the materials to be distributed need not include anything that is +normally distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties with +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Lesser General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice diff --git a/tools/cooja/lib/swingx-all-1.6.4.jar b/tools/cooja/lib/swingx-all-1.6.4.jar new file mode 100644 index 000000000..3078bb636 Binary files /dev/null and b/tools/cooja/lib/swingx-all-1.6.4.jar differ