USBmicro

Your source for USB electrical device interface products.

  • Home
  • Services
    • Design
    • Contact USBmicro
  • Where to buy…
You are here: Home / Documentation / Device Commands / Read1WireBit

Read1WireBit

Read a bit from a 1-wire bus⁄device


VERSION 1.46+ of the firmware, VERSION 58+ of the DLL

Description:

This is a function to send a 1-wire (MicroLAN) bit read on the previously selected port pin.

Command Syntax: (USBm.dll)

USBm_Reset1WireBit( device, dataarray )

The USBm_Reset1WireBit function syntax has these parts:

Part Description
device A zero-based index to address the appropriate USB device.
dataarray The function causes this variable to be changed to the value read from the bus (00h for a bit value of 0, and a value that is not 00h for a bit value of 1). Minimum array size of 8 bytes.

Remarks:

This command does not set the port direction pins or select the pin to use as the 1-wire bus – it is the Reset1Wire command that does this.


VB Declaration

Public Declare Function USBm_Read1WireBit _
    Lib “USBm.dll” _
        (ByVal device As Byte, _
               ByRef dataarray As Byte)_
   As Integer

VB Example

Dim dataarray(8) As Byte
    USBm_Read1WireBit 3, dataarray(0)

This code fragment addresses U4x1 device #3, and reads a bit from the 1-wire device. The read value is in “dataarray(0)”. 00h for a bit value of 0, and a value that is not 00h for a bit value of 1


C Prototype

int USBm_Read1WireBit ( unsigned char device, unsigned char * data );

C Example

USBm_Read1WireBit ( 3, dataarray );

This code fragment addresses U4x1 device #3, and reads a bit from the 1-wire device. The read value is in “dataarray[0]”. 00h for a bit value of 0, and a value that is not 00h for a bit value of 1


RobotBASIC

usbm_Read1WireBit(ne_DeviceNumber)

Returns a bit value that is read from the 1wire device.


Raw Command  Format:

Byte Number Description
0 1Fh: Read1WireCmd
1 <not used>
2 Byte⁄bit – 0 = write byte, 1 = write bit. Bit feature for VERSION 1.30+ of the firmware
3 <not used>
4 <not used>
5 <not used>
6 <not used>
7 <not used>

Raw Command  Format Details:

Byte 0 contains the command. Byte 1 is not used.

Byte 2 selects reading either a byte or a bit.

This command does not set the port direction pins or select the pin to use as the 1-wire bus – it is the Reset1Wire command that does this.

Raw Command Response Format:

Byte Number Description
0 1Fh: Read1WireCmd
1 Data – Byte⁄bit read.
2 <not used>
3 <not used>
4 <not used>
5 <not used>
6 <not used>
7 <not used>

Raw Command Response Format Details:

Byte 0 contains the command. Byte 1 is the byte⁄bit data that was read. Byte 2 through byte 7 are unused.

If a 0 bit is read, data = 0. If a 1 bit is read, data is not 0.

Documentation

Open all | Close all