passwordcontainer.java

这是一个以JAVA编写的程序,本人还没有试过,是一个简单的温度控制系统

    *                    owc41.hasWriteOnlyPassword() ); </code></p>
    * 
    * <p>For this to be successful, either write-protect passwords must be disabled,
    * or the write-protect password(s) for this container must be set and must match
    * the value of the write-protect password(s) in the device's register.</p>
    * 
    * @param enableAll if <code>true</code>, all passwords are enabled.  Otherwise,
    *        all passwords are disabled.
    */
   public void setDevicePasswordEnableAll(boolean enableAll)
      throws OneWireException, OneWireIOException;

   // -----------------------------------------------------------------

   /**
    * <p>Writes the given password to the device's Read-Only password register.  Note
    * that this function does not enable the password, just writes the value to
    * the appropriate memory location.</p>
    * 
    * <p>For this to be successful, either write-protect passwords must be disabled,
    * or the write-protect password(s) for this container must be set and must match
    * the value of the write-protect password(s) in the device's register.</p>
    * 
    * @param password the new password to be written to the device's Read-Only
    *        password register.  Length must be 
    *        <code>(offset + getReadOnlyPasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setDeviceReadOnlyPassword(byte[] password, int offset)
      throws OneWireException, OneWireIOException;

   /**
    * <p>Writes the given password to the device's Read/Write password register.  Note
    * that this function does not enable the password, just writes the value to
    * the appropriate memory location.</p>
    * 
    * <p>For this to be successful, either write-protect passwords must be disabled,
    * or the write-protect password(s) for this container must be set and must match
    * the value of the write-protect password(s) in the device's register.</p>
    * 
    * @param password the new password to be written to the device's Read-Write
    *        password register.  Length must be 
    *        <code>(offset + getReadWritePasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setDeviceReadWritePassword(byte[] password, int offset)
      throws OneWireException, OneWireIOException;

   /**
    * <p>Writes the given password to the device's Write-Only password register.  Note
    * that this function does not enable the password, just writes the value to
    * the appropriate memory location.</p>
    * 
    * <p>For this to be successful, either write-protect passwords must be disabled,
    * or the write-protect password(s) for this container must be set and must match
    * the value of the write-protect password(s) in the device's register.</p>
    * 
    * @param password the new password to be written to the device's Write-Only
    *        password register.  Length must be 
    *        <code>(offset + getWriteOnlyPasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setDeviceWriteOnlyPassword(byte[] password, int offset)
      throws OneWireException, OneWireIOException;

   // -----------------------------------------------------------------

   /**
    * Sets the Read-Only password used by the API when reading from the
    * device's memory.  This password is not written to the device's
    * Read-Only password register.  It is the password used by the
    * software for interacting with the device only.
    * 
    * @param password the new password to be used by the API when 
    *        reading from the device's memory.  Length must be 
    *        <code>(offset + getReadOnlyPasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setContainerReadOnlyPassword(byte[] password, int offset)
      throws OneWireException;

   /**
    * Sets the Read/Write password used by the API when reading from  or
    * writing to the device's memory.  This password is not written to 
    * the device's Read/Write password register.  It is the password used 
    * by the software for interacting with the device only.
    * 
    * @param password the new password to be used by the API when 
    *        reading from or writing to the device's memory.  Length must be 
    *        <code>(offset + getReadWritePasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setContainerReadWritePassword(byte[] password, int offset)
      throws OneWireException;

   /**
    * Sets the Write-Only password used by the API when writing to the
    * device's memory.  This password is not written to the device's
    * Write-Only password register.  It is the password used by the
    * software for interacting with the device only.
    * 
    * @param password the new password to be used by the API when 
    *        writing to the device's memory.  Length must be 
    *        <code>(offset + getWriteOnlyPasswordLength)</code>
    * @param offset the starting point for copying from the given password array
    */
   public void setContainerWriteOnlyPassword(byte[] password, int offset)
      throws OneWireException;

   // -----------------------------------------------------------------

   /**
    * Returns true if the password used by the API for reading from the
    * device's memory has been set.  The return value is not affected by 
    * whether or not the read password of the container actually matches 
    * the value in the device's password register.
    * 
    * @return <code>true</code> if the password used by the API for 
    * reading from the device's memory has been set.
    */
   public boolean isContainerReadOnlyPasswordSet()
      throws OneWireException;

   /**
    * Returns true if the password used by the API for reading from or
    * writing to the device's memory has been set.  The return value is 
    * not affected by whether or not the read/write password of the 
    * container actually matches the value in the device's password 
    * register.
    * 
    * @return <code>true</code> if the password used by the API for 
    * reading from or writing to the device's memory has been set.
    */
   public boolean isContainerReadWritePasswordSet()
      throws OneWireException;

   /**
    * Returns true if the password used by the API for writing to the
    * device's memory has been set.  The return value is not affected by 
    * whether or not the write password of the container actually matches 
    * the value in the device's password register.
    * 
    * @return <code>true</code> if the password used by the API for 
    * writing to the device's memory has been set.
    */
   public boolean isContainerWriteOnlyPasswordSet()
      throws OneWireException;

   // -----------------------------------------------------------------

   /**
    * Gets the Read-Only password used by the API when reading from the
    * device's memory.  This password is not read from the device's
    * Read-Only password register.  It is the password used by the
    * software for interacting with the device only and must have been
    * set using the <code>setContainerReadOnlyPassword</code> method.
    * 
    * @param password array for holding the password that is used by the 
    *        API when reading from the device's memory.  Length must be 
    *        <code>(offset + getWriteOnlyPasswordLength)</code>
    * @param offset the starting point for copying into the given password array
    */
   public void getContainerReadOnlyPassword(byte[] password, int offset)
      throws OneWireException;

   /**
    * Gets the Read/Write password used by the API when reading from or 
    * writing to the device's memory.  This password is not read from 
    * the device's Read/Write password register.  It is the password used 
    * by the software for interacting with the device only and must have 
    * been set using the <code>setContainerReadWritePassword</code> method.
    * 
    * @param password array for holding the password that is used by the 
    *        API when reading from or writing to the device's memory.  Length must be 
    *        <code>(offset + getReadWritePasswordLength)</code>
    * @param offset the starting point for copying into the given password array
    */
   public void getContainerReadWritePassword(byte[] password, int offset)
      throws OneWireException;

   /**
    * Gets the Write-Only password used by the API when writing to the
    * device's memory.  This password is not read from the device's
    * Write-Only password register.  It is the password used by the
    * software for interacting with the device only and must have been
    * set using the <code>setContainerWriteOnlyPassword</code> method.
    * 
    * @param password array for holding the password that is used by the 
    *        API when writing to the device's memory.  Length must be 
    *        <code>(offset + getWriteOnlyPasswordLength)</code>
    * @param offset the starting point for copying into the given password array
    */
   public void getContainerWriteOnlyPassword(byte[] password, int offset)
      throws OneWireException;

   // -----------------------------------------------------------------
}