Method and apparatus for implementing an application programming interface for a communications bus

• US 5,815,678 A
• Filed: 07/14/1995
• Issued: 09/29/1998
• Est. Priority Date: 07/14/1995
• Status: Expired due to Term

• Current Assignee: PMC-Sierra Incorporated (Microchip Technology Incorporated)
• Original Assignee: Adaptec Incorporated (Steel Partners Holdings LP)
• Inventors: Datta, Rajat, Moore, Daniel Joseph, Shalkey, Eric Thomas, Hoffman, Gary Alan, Mitchell, Oscar Reid
• Primary Examiner(s): Sheikh, Ayaz R.
• Assistant Examiner(s): WILEY, DAVID ARMAND
• Application Number:
  US08/503,078
• Time in Patent Office: 1,173 Days
• Field of Search: 395/285, 395/682, 395/821, 395/309, 395/828-834
• US Class Current: 710/305
• CPC Class Codes: G06F 13/102 where the programme performs an interfacing function, e.g. device driver G06F13/105 takes precedence; scheduling within device drivers G06F9/52; contention policies within device drivers G06F9/4881
• CPC Class Codes: G06F 9/544 Buffers; Shared memory; Pipes
• CPC Class Codes: H04L 12/40058 Isochronous transmission
• CPC Class Codes: H04L 12/40065 Bandwidth and channel allocation home automation networks H04L12/2803; flow control H04L47/10

Abstract

A system and method for creating a high-level application programming interface allows simplified control and usage of digital data being transported over an IEEE 1394 serial bus under a variety of operational environments. The system and method of controlling communications on a communications bus includes determining a number of adapters attached to the communications bus, establishing a link between an application program and one or more of the adapters; allocating buffers for data transfer; mapping a memory buffer to a space in storage associated with the communications bus; and executing the applications program.

Claims

1. An application programming interface for interfacing an application program to a 1394 communications bus comprising:

means for initializing and configuring the 1394 bus;

means, responsive to the application program, for allocating space in a storage means associated with the application program to receive or transmit data from or to the 1394 bus;

means for controlling transmission and reception of data on the 1394 bus; and

means for resetting and reconfiguring the 1394 bus when a change in device attachment occurs, wherein said means for resetting and reconfiguring includes one or more API commands callable by the application program.

2. The application programming interface according to claim 1, wherein said controlling means further comprises:

means, responsive to the application program, for translating information between a plurality of protocols to facilitate transmission and reception of data on the 1394 bus.

3. An application programming interface for controlling communications on a 1394 communications bus comprising:

means for determining a number of adapters attached to the 1394 bus;

means for establishing a link between an application program and one or more of said number of adapters;

means for allocating buffers to receive or transmit data from or to the 1394 bus;

means for mapping a memory buffer to a space in a storage means associated with the 1394 bus; and

means for executing said application program by making API command calls to the application programming interface.

4. The application programming interface according to claim 3, further comprising:

means for releasing said space in said storage means;

means for releasing said allocated buffer; and

means for closing each of said linked adapters.

5. The application programming interface according to claim 3, further comprising:

means for allocating a channel on the 1394 bus having a predetermined bandwidth;

means for transmitting data on said channel under control of a predetermined command;

means for testing completion status; and

means for ending if said completion status indicates completion.

6. The application programming interface according to claim 5, further comprising:

means for testing to determine if data in all buffers have been transmitted; and

means for transmitting data and testing completion if data in all buffers have not been transmitted.

7. The application programming interface according to claim 3, further comprising:

means for testing for transmission errors;

means for processing any error detected in said testing step;

means for retrying said transmission; and

means for flushing and pending transmission on said channel.

8. A method of controlling communications on a 1394 bus comprising the steps of:

determining a number of adapters attached to the 1394 bus;

establishing a link between an application program and one or more of said number of adapters;

allocating buffers to receive or transmit data from or to the 1394 bus;

mapping a memory buffer to a space in a storage means associated with the 1394 bus; and

executing said application program.

9. The method according to claim 8, further comprising the steps of:

releasing said space in said storage means;

releasing said allocated buffers; and

closing each of said linked adapters.

10. The method, as recited in claim 8, further comprising the steps of:

allocating a channel on the 1394 bus having a predetermined bandwidth;

transmitting data on said channel under control of a predetermined command;

testing completion status; and

ending if said completion status indicates completion.

11. The method, as recited in claim 10, further comprising the steps of:

testing to determine if data in all buffers have been transmitted; and

repeating said steps of transmitting data and testing completion if data in all buffers have not been transmitted.

12. The method, as recited in claim 8, further comprising the steps of:

testing for transmission errors;

processing any error detected in said testing step;

retrying said transmission; and

if said retrying is not successful, flushing and pending transmission on said channel.

13. A system for controlling communications on a communications bus comprising:

an application program;

a 1394 communications bus;

an application programming interface for interfacing the application program to the 1394 bus, the application programming interface controlling communications on the 1394 bus in response to the application program; and

wherein the application programming interface comprises;

means for initializing and configuring the 1394 bus;

means, responsive to the application program, for allocating space in a storage means associated with the application program to receive or transmit data from or to the 1394 bus;

means for controlling transmission and reception of data on the 1394 bus; and

means for resetting and reconfiguring the 1394 bus when a change in device attachment occurs, wherein said means for resetting and reconfiguring includes one or more API commands callable by the application program.

14. A system for controlling communications on a communications bus comprising:

an application program;

a 1394 communications bus;

an application programming interface for interfacing the application program to the 1394 bus, the application programming interface controlling communications on the 1394 bus in response to the application program; and

wherein the application programming interface comprises;

means for determining a number of adapters attached to the 1394 bus;

means for establishing a link between the application program and one or more of the number of adapters;

means for allocating buffers for data storage and transmission;

means for mapping a memory buffer to a space in a storage means associated with the 1394 bus; and

means for executing said application program by making API command calls to the application programming interface.