Using the tscircuit TI Library

Overview

The @tsci/tscircuit.ti package exports Texas Instruments chip components from the package root. These are the most direct way to place and wire TI devices in your own board designs.

Many chips are available under a family-level name such as BQ24074 or INA237. The package also exports exact manufacturer-part-number variants when you need them, such as BQ24074RGTR or INA237AQDGSRQ1.

The package root also includes higher-level reference circuits such as BatteryManagement_BQ24074, but this guide focuses on chip-level usage.

Install the library in a local tscircuit project:

bun add @tsci/tscircuit.ti

Import a TI Chip

For most cases, import the chip from the package root:

import { BQ24074 } from "@tsci/tscircuit.ti"

The chip component already includes the manufacturer part number, footprint, supplier part numbers, and pin labels from the TI library source.

If you need to target an exact package variant, you can also import the manufacturer-part-number component directly from the same package root:

import { BQ24074RGTR } from "@tsci/tscircuit.ti"

Place a TI Chip

This example imports the BQ24074 charger IC and places it directly on a board.

import { BQ24074 } from "@tsci/tscircuit.ti"

  export default () => (
    <board width="18mm" height="14mm">
      <BQ24074
        name="U1"
        schWidth={3.1}
        schHeight={4.3}
        schPinArrangement={{
          leftSide: {
            direction: "top-to-bottom",
            pins: ["IN", "VSS", "TS", "BAT"],
          },
          topSide: {
            direction: "left-to-right",
            pins: ["N_PGOOD", "N_CHG"],
          },
          rightSide: {
            direction: "top-to-bottom",
            pins: ["OUT", "EN2", "EN1", "TMR", "N_CE"],
          },
          bottomSide: {
            direction: "left-to-right",
            pins: ["ITERM", "ILIM", "ISET"],
          },
        }}
        schPinStyle={{
          TS: { topMargin: 1.2 },
          N_CHG: { leftMargin: 0.7 },
          EN2: { topMargin: 0.9 },
          ILIM: { leftMargin: 0.45 },
          ISET: { leftMargin: 0.45 },
        }}
      />
    </board>
  )

BQ24074 currently uses the BQ24074RGTR package variant by default, so you can start with the family-level export and only switch to the exact part-number component when you need a specific package.

Because BQ24074 is a chip component, it accepts the same props as a regular <chip />, including name, connections, schPinArrangement, schPinStyle, pcbX, and pcbY.

Wire the Chip Pins

Use the connections prop with the chip's labeled pins, just like any other custom chip component.

import { BQ24074 } from "@tsci/tscircuit.ti"

  export default () => (
    <board width="26mm" height="20mm">
      <BQ24074
        name="U1"
        schWidth={3.1}
        schHeight={4.3}
        schPinArrangement={{
          leftSide: {
            direction: "top-to-bottom",
            pins: ["IN", "VSS", "TS", "BAT"],
          },
          topSide: {
            direction: "left-to-right",
            pins: ["N_PGOOD", "N_CHG"],
          },
          rightSide: {
            direction: "top-to-bottom",
            pins: ["OUT", "EN2", "EN1", "TMR", "N_CE"],
          },
          bottomSide: {
            direction: "left-to-right",
            pins: ["ITERM", "ILIM", "ISET"],
          },
        }}
        noConnect={["TS", "N_PGOOD", "N_CHG"]}
        connections={{
          IN: "net.VBUS",
          VSS: "net.GND",
          BAT: "net.BAT",
          BAT2: "net.BAT",
          OUT: "net.VSYS",
          OUT2: "net.VSYS",
          EN2: "net.VSYS",
          EN1: "net.GND",
          TMR: "net.GND",
          N_CE: "net.GND",
          ITERM: ".R_ITERM > .pin1",
          ILIM: ".R_ILIM > .pin1",
          ISET: ".R_ISET > .pin1",
          EP: "net.GND",
        }}
      />

      <resistor
        name="R_ITERM"
        resistance="4.12k"
        footprint="0603"
        connections={{ pin2: "net.GND" }}
      />
      <resistor
        name="R_ILIM"
        resistance="1.18k"
        footprint="0603"
        connections={{ pin2: "net.GND" }}
      />
      <resistor
        name="R_ISET"
        resistance="1.13k"
        footprint="0603"
        connections={{ pin2: "net.GND" }}
      />

      <capacitor
        name="C_IN"
        capacitance="1uF"
        footprint="0603"
        connections={{ pin1: "net.VBUS", pin2: "net.GND" }}
      />
      <capacitor
        name="C_BAT"
        capacitance="4.7uF"
        footprint="0603"
        connections={{ pin1: "net.BAT", pin2: "net.GND" }}
      />
      <capacitor
        name="C_OUT"
        capacitance="4.7uF"
        footprint="0603"
        connections={{ pin1: "net.VSYS", pin2: "net.GND" }}
      />
    </board>
  )

In this example:

• IN, BAT, and OUT connect directly to named nets.
• ITERM, ILIM, and ISET connect to resistor pins using selectors.
• noConnect marks the pins that are intentionally unused in this simplified example.

For more on chip props, see Configuring Chips. For more on selector syntax, see Port and Net Selectors.

Finding More TI Chips

The package root exports chip components such as BQ24074, BQ25895, BQ27441G1, CC2340R5, INA237, TPS22919, TPS63802, and TMP1075.

It also exports exact manufacturer-part-number variants such as BQ24074RGTR, BQ25895RTWR, and INA237AQDGSRQ1 when you need a specific package option.

For dynamic lookup, the package exports TiChipComponents, TiChipName, and TiChipComponent.

You can browse the lib/chips directory in tscircuit/ti to see the available chip families and their exact package variants.