Package com.dalsemi.onewire.adapter

Class PDKAdapterUSB

    • Constructor Detail

      • PDKAdapterUSB

        public PDKAdapterUSB()

    • Method Detail

      • selectPort

        public boolean selectPort​(java.lang.String portName)
                   throws OneWireIOException,
                          OneWireException
        Description copied from class: DSPortAdapter
        Specifies a platform appropriate port name for this adapter. Note that even though the port has been selected, it's ownership may be relinquished if it is not currently held in a 'exclusive' block. This class will then try to re-acquire the port when needed. If the port cannot be re-acquired when the exception PortInUseException will be thrown.
        Specified by:
        selectPort in class DSPortAdapter
        Parameters:
        portName - name of the target port, retrieved from getPortNames()
        Returns:
        true if the port was acquired, false if the port is not available.
        Throws:
        OneWireIOException - If port does not exist, or unable to communicate with port.
        OneWireException - If port does not exist

      • freePort

        public void freePort()
              throws OneWireException
        Description copied from class: DSPortAdapter
        Frees ownership of the selected port, if it is currently owned, back to the system. This should only be called if the recently selected port does not have an adapter, or at the end of your application's use of the port.
        Specified by:
        freePort in class DSPortAdapter
        Throws:
        OneWireException - If port does not exist

      • getAdapterName

        public java.lang.String getAdapterName()
        Description copied from class: DSPortAdapter
        Retrieves the name of the port adapter as a string. The 'Adapter' is a device that connects to a 'port' that allows one to communicate with an iButton or other 1-Wire device. As example of this is 'DS9097U'.
        Specified by:
        getAdapterName in class DSPortAdapter
        Returns:
        String representation of the port adapter.

      • getPortTypeDescription

        public java.lang.String getPortTypeDescription()
        Description copied from class: DSPortAdapter
        Retrieves a description of the port required by this port adapter. An example of a 'Port' would 'serial communication port'.
        Specified by:
        getPortTypeDescription in class DSPortAdapter
        Returns:
        String description of the port type required.

      • getClassVersion

        public java.lang.String getClassVersion()
        Description copied from class: DSPortAdapter
        Retrieves a version string for this class.
        Specified by:
        getClassVersion in class DSPortAdapter
        Returns:
        version string

      • getPortNames

        public java.util.Enumeration<java.lang.String> getPortNames()
        Description copied from class: DSPortAdapter
        Retrieves a list of the platform appropriate port names for this adapter. A port must be selected with the method 'selectPort' before any other communication methods can be used. Using a communication method before 'selectPort' will result in a OneWireException exception.
        Specified by:
        getPortNames in class DSPortAdapter
        Returns:
        Enumeration of type String that contains the port names

      • getAddress

        public void getAddress​(byte[] address)
        Description copied from class: DSPortAdapter
        Copies the 'current' 1-Wire device address being used by the adapter into the array. This address is the last iButton or 1-Wire device found in a search (findNextDevice()...). This method copies into a user generated array to allow the reuse of the buffer. When searching many iButtons on the one wire network, this will reduce the memory burn rate.
        Specified by:
        getAddress in class DSPortAdapter
        Parameters:
        address - An array to be filled with the current iButton address.
        See Also:
        Address

      • findNextDevice

        public boolean findNextDevice()
                       throws OneWireIOException,
                              OneWireException
        Description copied from class: DSPortAdapter
        Returns true if the next iButton or 1-Wire device is found. The previous 1-Wire device found is used as a starting point in the search. If no more devices are found then false will be returned.
        Specified by:
        findNextDevice in class DSPortAdapter
        Returns:
        true if an iButton or 1-Wire device is found.
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • setSearchOnlyAlarmingDevices

        public void setSearchOnlyAlarmingDevices()
        Description copied from class: DSPortAdapter
        Sets the 1-Wire Network search to find only iButtons and 1-Wire devices that are in an 'Alarm' state that signals a need for attention. Not all iButton types have this feature. Some that do: DS1994, DS1920, DS2407. This selective searching can be canceled with the 'setSearchAllDevices()' method.
        Specified by:
        setSearchOnlyAlarmingDevices in class DSPortAdapter
        See Also:
        DSPortAdapter.setNoResetSearch()

      • setNoResetSearch

        public void setNoResetSearch()
        Description copied from class: DSPortAdapter
        Sets the 1-Wire Network search to not perform a 1-Wire reset before a search. This feature is chiefly used with the DS2409 1-Wire coupler. The normal reset before each search can be restored with the 'setSearchAllDevices()' method.
        Specified by:
        setNoResetSearch in class DSPortAdapter

      • setSearchAllDevices

        public void setSearchAllDevices()
        Description copied from class: DSPortAdapter
        Sets the 1-Wire Network search to find all iButtons and 1-Wire devices whether they are in an 'Alarm' state or not and restores the default setting of providing a 1-Wire reset command before each search. (see setNoResetSearch() method).
        Specified by:
        setSearchAllDevices in class DSPortAdapter
        See Also:
        DSPortAdapter.setNoResetSearch()

      • beginExclusive

        public boolean beginExclusive​(boolean blocking)
                       throws OneWireException
        Description copied from class: DSPortAdapter
        Gets exclusive use of the 1-Wire to communicate with an iButton or 1-Wire Device. This method should be used for critical sections of code where a sequence of commands must not be interrupted by communication of threads with other iButtons, and it is permissible to sustain a delay in the special case that another thread has already been granted exclusive access and this access has not yet been relinquished.

        It can be called through the OneWireContainer class by the end application if they want to ensure exclusive use. If it is not called around several methods then it will be called inside each method.

        Specified by:
        beginExclusive in class DSPortAdapter
        Parameters:
        blocking - true if want to block waiting for exclusive access to the adapter
        Returns:
        true if blocking was false and a exclusive session with the adapter was acquired
        Throws:
        OneWireException - on a setup error with the 1-Wire adapter

      • endExclusive

        public void endExclusive()
        Description copied from class: DSPortAdapter
        Relinquishes exclusive control of the 1-Wire Network. This command dynamically marks the end of a critical section and should be used when exclusive control is no longer needed.
        Specified by:
        endExclusive in class DSPortAdapter

      • getBlock

        public void getBlock​(byte[] buff,
                     int off,
                     int len)
              throws OneWireIOException,
                     OneWireException
        Description copied from class: DSPortAdapter
        Gets a block of data from the 1-Wire Network and write it into the provided array.
        Specified by:
        getBlock in class DSPortAdapter
        Parameters:
        buff - array in which to write the received bytes
        off - offset into the array to start
        len - length of data bytes to receive
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • dataBlock

        public void dataBlock​(byte[] buff,
                      int off,
                      int len)
               throws OneWireIOException,
                      OneWireException
        Description copied from class: DSPortAdapter
        Sends a block of data and returns the data received in the same array. This method is used when sending a block that contains reads and writes. The 'read' portions of the data block need to be pre-loaded with 0xFF's. It starts sending data from the index at offset 'off' for length 'len'.
        Specified by:
        dataBlock in class DSPortAdapter
        Parameters:
        buff - array of data to transfer to and from the 1-Wire Network.
        off - offset into the array of data to start
        len - length of data to send / receive starting at 'off'
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • reset

        public int reset()
          throws OneWireIOException,
                 OneWireException
        Description copied from class: DSPortAdapter
        Sends a Reset to the 1-Wire Network.
        Specified by:
        reset in class DSPortAdapter
        Returns:
        the result of the reset. Potential results are:
        • 0 (RESET_NOPRESENCE) no devices present on the 1-Wire Network.
        • 1 (RESET_PRESENCE) normal presence pulse detected on the 1-Wire Network indicating there is a device present.
        • 2 (RESET_ALARM) alarming presence pulse detected on the 1-Wire Network indicating there is a device present and it is in the alarm condition. This is only provided by the DS1994/DS2404 devices.
        • 3 (RESET_SHORT) indicates 1-Wire appears shorted. This can be transient conditions in a 1-Wire Network. Not all adapter types can detect this condition.
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • canDeliverSmartPower

        public boolean canDeliverSmartPower()
                             throws OneWireIOException,
                                    OneWireException
        Returns whether the adapter can physically support "smart" strong 5 volt power mode. "smart" power delivery is the ability to deliver power until it is no longer needed. The current drop it detected and power delivery is stopped.
        Overrides:
        canDeliverSmartPower in class DSPortAdapter
        Returns:
        true if this port adapter can do "smart" strong 5 volt mode, false otherwise.
        Throws:
        OneWireIOException - on a 1-Wire communication error with the adapter
        OneWireException - on a setup error with the 1-Wire adapter

      • setPowerDuration

        public void setPowerDuration​(int timeFactor)
                      throws OneWireIOException,
                             OneWireException
        Sets the duration to supply power to the 1-Wire Network. This method takes a time parameter that indicates the program pulse length when the method startPowerDelivery().

        Note: to avoid getting an exception, use the canDeliverPower() and canDeliverSmartPower() method to check it's availability.

        Overrides:
        setPowerDuration in class DSPortAdapter
        Parameters:
        timeFactor -
        • 0 (DELIVERY_HALF_SECOND) provide power for 1/2 second.
        • 1 (DELIVERY_ONE_SECOND) provide power for 1 second.
        • 2 (DELIVERY_TWO_SECONDS) provide power for 2 seconds.
        • 3 (DELIVERY_FOUR_SECONDS) provide power for 4 seconds.
        • 4 (DELIVERY_SMART_DONE) provide power until the the device is no longer drawing significant power.
        • 5 (DELIVERY_INFINITE) provide power until the setBusNormal() method is called.
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • startPowerDelivery

        public boolean startPowerDelivery​(int changeCondition)
                           throws OneWireIOException,
                                  OneWireException
        Sets the 1-Wire Network voltage to supply power to an iButton device. This method takes a time parameter that indicates whether the power delivery should be done immediately, or after certain conditions have been met.

        Note: to avoid getting an exception, use the canDeliverPower() and canDeliverSmartPower() method to check it's availability.

        Overrides:
        startPowerDelivery in class DSPortAdapter
        Parameters:
        changeCondition -
        • 0 (CONDITION_NOW) operation should occur immediately.
        • 1 (CONDITION_AFTER_BIT) operation should be pending execution immediately after the next bit is sent.
        • 2 (CONDITION_AFTER_BYTE) operation should be pending execution immediately after next byte is sent.
        Returns:
        true if the voltage change was successful, false otherwise.
        Throws:
        OneWireIOException - on a 1-Wire communication error
        OneWireException - on a setup error with the 1-Wire adapter

      • PowerLevel

        public int PowerLevel​(int portHandle,
                      int newLevel)

      • setPowerNormal

        public void setPowerNormal()
        Description copied from class: DSPortAdapter
        Sets the 1-Wire Network voltage to normal level. This method is used to disable 1-Wire conditions created by startPowerDelivery and startProgramPulse. This method will automatically be called if a communication method is called while an outstanding power command is taking place.
        Overrides:
        setPowerNormal in class DSPortAdapter