After placing an order through our website at www.saleae.com, you will be contacted via email with your order summary, which should include your order number with us. In addition, another email will be sent to you which will include your tracking information once your order is shipped.

If for some reason you did not receive the above email, please contact us and let us know your order number and we will be happy to share your order status with you. Your order number will be in the format of "XYZ-12345" (with XYZ representing the currency, and 12345 representing the number for your order).

If you don't have your order number handy, please share any other information on your order that might help us locate it. For example:

• Shipping and billing address

• Recipient name

• Email address of the order placer

• The date when the order was placed

Ready to purchase your own Saleae Logic? Place an order or request a quote below!

Do you have a preferred distributor? Check our list of official distributors below!

To place a direct online order with us, please follow the steps below.

• Navigate to our Home page here.

• Click either the Buy Logic Analyzers or Accessories button at the top of the page depending on the product of interest.

• Select the destination country in the dropdown selector box underneath the Add to cart button. This selection will determine the currency that you will be charged in. If your local currency is not supported by our website, we will charge your order in USD currency.

• Click Add to cart on the product you would like to purchase. This will open up a side panel cart which shows the current items in your cart.

• To add additional items, click anywhere outside of the side panel cart or the "x" button at the top right of the side panel to close the side panel. Afterwards, click either the Buy Logic Analyzers or Accessories button again at the top of the page depending on the product of interest.

• Repeat the above steps until all products of interest have been added to your cart.

• Once the final product has been added to your cart, click the Checkout button from within the side panel cart.

• Please note that, when ordering on our website, we accept payment by credit card or PayPal.

Welcome to our support site! Quickly find information using the search bar located at the top-right.

Whether you own the Saleae Logic or not, the best way to discover Saleae Logic would be to follow our Getting Started guide below.

Ready to purchase your own Saleae Logic? Place an order or request a quote below!

You can click on the link below to submit a quote request form. Once submitted, please allow some time (typically one business day) and we will reach out to you via email with your quote in PDF format.

• Get a Quote

Quote Request Form Not Working?

If the quote request form is somehow not working on your end, please contact support and send in the following information.

Information Required for Quote

• Email address

• How will you place your order? (select an option below)

  • Purchase Order (via wire transfer). Please see requirements here.

  • Online at www.saleae.com (via credit card or PayPal)

• Products and Quantity

• Shipping City and Country

• Shipping Option (select an option below)

  • Use Saleae's shipping account - shipping costs will be added to the quote

  • Use your own shipping account (only via PO)

Optional Information

• Shipping Carrier & Account Number (only if placing a PO)

• Full Name

• Company Name

• Shipping Address

• Billing Address

• Phone Number

What Products are available for Purchase?

For reference, you may refer to the list of products we sell below.

Placing a Purchase Order?

If you plan on placing a purchase order, please review the requirements and process below before submitting your quote:

Having mentioned the above note, and in case you are still interested in placing a direct purchase order with us, please ensure your PO meets the requirements below to avoid any processing delays.

Requirements and Payment Terms

• Placing a PO is only available for companies who cannot place an order through our website by credit/purchasing card or PayPal.

• Order total must be at least USD $999.

• The order must be paid in USD currency.

• We currently offer Net 30 Term to existing customers with a history of timely payments.

• If this is your first order with us, we will generate a Proforma Invoice for you to Prepay via Wire Transfer. We will ship your order on the first business day after payment is received.

• Orders placed via PO will be shipped from the US. If the order will be shipping to a country outside the US, there will likely be additional charges for duties and taxes, due on receipt.

Please Make Sure your PO Includes the Following:

• Billing Address

• Shipping Address

• PO Number

• Phone Number

• Product Name

• Quantities, and Prices in USD (Prices can be found in the support article linked below)

• Shipping Option: Please either include your FedEx/UPS/DHL Account Number, OR indicate "Saleae Prepay Shipping - Add to Invoice"

• Email address and contact information for your Accounts Payable Department

• Payment Term: Prepay via Wire Transfer or Net 30 Days from Date of Invoice

Two Methods for Processing a PO Payment

Method 1 – Prepayment

1. Get a Quote (optional step - please see instructions below this article)

2. Create a PO document and send it to us by writing to support​. You may also use the quote generated above as your PO

3. We will reply with a Proforma Invoice, including our bank information.

4. Send the payment to Saleae. Important: Please let us know via email once the payment is sent.

5. We will ship the order on the first business day after the payment is received.

Method 2 – NET30 Payment Terms (for existing customers only)

1. Get a Quote (optional step - please see instructions below this article)

2. Create a PO document and send it to us by writing to support. You may also use the quote generated above as your PO

3. We will reply with an Invoice, and the order will ship.

4. Send the payment to Saleae. Important: Please let us know via email once the payment is sent.

5. Payment must be received within 30 days of the invoice date.

Getting a Quote

Please follow the instructions in the support article below to request a quote.

Pricing

You can find the pricing and part numbers for all of our products in the support article below. The pricing in the support article is shown in USD currency. However, if we are shipping to a country outside of the United States, we recommend referring to the Availability section below to determine if you will be charged in your local currency, as well as the cost of shipping and taxes in your local currency.

Shipping and Taxes

To check the cost of shipping and taxes, follow the steps in the support article below to place an online order. When you reach the Checkout page, enter your contact information and shipping address and click "Continue to shipping method" to reach the "Shipping method" page. From there, you can select your preferred shipping method and can view the shipping cost and taxes.

Availability

For Logic analyzer products, click "Buy Logic Analyzers" at the top and select the product of interest. Afterwards, select the destination country at the bottom-right and you will find a note about its stock status and when it will ship.

For Accessories, click "Accessories" at the top and select the accessory of interest. Afterwards, select the destination country at the bottom-right and you will find a note about its stock status and when it will ship, similar to the image above.

Normally, all units are in stock. If you decide to purchase a unit when it is out of stock, there will be an additional required checkbox on the cart page to remind you that your order may be delayed.

Saleae Business Information

Saleae W9

Our W-9 Form can be downloaded below.

Saleae VAT Number Table

Is Saleae SAM Registered?

Yes, we are SAM registered as a small business.

This list contains authorized distributors selling Saleae devices. Please note that most listed distributors ship worldwide. The country shown refers to each company's main office.

Americas

Canada

US

Europe

Belgium

Finland

France

Germany

Hungary

Israel

Italy

Netherlands

Norway

Poland

Sweden

Switzerland

Turkey

United Kingdom

Asia

Australia

China

India

Japan

Malaysia

Singapore

South Africa

South Korea

Taiwan

Thailand

Tax Exemption Process for U.S. Orders

Process for Removing Tax Charges (US Orders)

We currently charge taxes on orders that ship to the following US states:

• Arizona, California, Colorado, Florida, Illinois, Maryland, Massachusetts, Michigan, Minnesota, Pennsylvania, Texas, Washington

Online orders that will ship to all other U.S. states will not be charged taxes by default. The process below can be followed to remove tax charges for tax-exempt orders that will be shipping to the above listed US states.

3. Wait for our support team's approval email (usually 1-2 business days after the tax exemption certificate is provided).

Refund of Tax Charges

VAT Exemption for EU Orders

For orders shipping to Europe, you may enter your VAT number by clicking on the "VAT exempt" checkbox on our product page and/or cart page below.

When requesting an invoice, please provide as much of the following information as possible to help us locate your order.

• Was the order placed with a PO, over the phone, or online at www.saleae.com?

• Any ID number(s) you can locate from the order

• The email address from the order

• The company name or purchaser name for the order

• The date the order was placed

Saleae Discounts

We offer various discount options for our Logic products. For more details and to check if you qualify, click here.

To apply for a discount code, please click here.

Quantity Discounts

Quantity discounts for all customers start at orders of 5 or more units. We offer the following:

• 5% off on orders of 5–9 units

• 10% off on orders of 10 or more units

If quantity discounts are needed, please contact support for more information.

Saleae does not offer a trade-in or upgrade plan. However, if you purchased a device within the last 180 days directly from us via purchase order or via our website at www.saleae.com, you can return it for a full refund (including shipping both ways). That will allow you to upgrade or downgrade your product at any time in the first 6 months after buying it.

Please note that this does not apply to purchases made via any of our distributors, or via any other means not mentioned above. Feel free to contact us for more information.

When an order is placed online, you should immediately receive an email confirmation. If you are missing that confirmation, contact us and we can help with that.

When your order ships, another email is sent containing the tracking number. If you have already received that email, you may use the tracking link included to monitor your shipment's progress.

If for some reason you did not receive any of the emails mentioned above, please contact us and include the order ID number, PO number, or any other identifying information so we can locate your order in our system.

Orders placed online at www.saleae.com usually ship within one business day, unless one or more of the items in the order are out of stock. If any items are out of stock, you should have been required to check a box on the cart page acknowledging this.

This list provides the Saleae part numbers, Export Classification Numbers (ECCN), Harmonized System (HS) Codes, and the price in USD for all our products.

The United States defines products using its Harmonized Tariff Schedule (HTS). An HS code, or HTS code, stands for Harmonized System or Harmonized Tariff Schedule. These codes are listed below.

Country of Origin (CoO) - for manufacture and test

• Unless otherwise specified, the CoO is Taiwan

Saleae Logic Analyzers

The Logic analyzer models listed below are referred to as our Gen 2 Logic analyzers.

Saleae Logic 8 Black

• Part Number: SAL-00111

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $499.00

Saleae Logic 8 Red

• Part Number: SAL-00112

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $499.00

Saleae Logic Pro 8 Black

• Part Number: SAL-00113

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $999.00

Saleae Logic Pro 8 Red

• Part Number: SAL-00114

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $999.00

Saleae Logic Pro 16 Black

• Part Number: SAL-00115

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $1499.00

Saleae Logic Pro 16 Red

• Part Number: SAL-00116

• ECCN: 3A992.a

• HS Code: 9030840000

• Price (USD): $1499.00

Saleae-Branded Accessories (for Gen 2 Logic analyzers)

The following Saleae-Branded accessories are compatible with our Gen 2 Logic analyzers (Logic Pro 16, Logic Pro 8, Logic 8, and Logic 4).

Wire Harness - 2x4 to Test Clips (Channels 0-3)

• Part Number: SAL-00097

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Wire Harness - 2x4 to Test Clips (Channels 4-7)

• Part Number: SAL-00098

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Wire Harness - 2x4 to Test Clips (Channels 8-11)

• Part Number: SAL-00099

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Wire Harness - 2x4 to Test Clips (Channels 12-15)

• Part Number: SAL-00100

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Wire Harness (2x4) for PCBite probes to Logic Analyzers

• Part Number: SAL-00187

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Logic-to-2x4 Header

• Part Number: SAL-00117

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $12.95

Logic-to-Wires

• Part Number: SAL-00118

• ECCN: EAR99

• HS Code: 8544420000

• Price (USD): $7.95

Test Clips 8-Pack

• Part Number: SAL-00093

• ECCN: EAR99

• HS Code: 8546.90.0000

• Price (USD): $23.95

Nano-size Test Clip

• Part Number: SAL-00165

• ECCN: EAR99

• HS Code: 8546.90.0000

• Price (USD): $15.99

Third-Party Accessories

Sensepeek PCBite Kit with 4x SQ10 probes and test wires

• Part Number: SAL-00185

• ECCN: EAR99

• HS Code: 820570

• Country of Origin: Sweden

• Price (USD): $149.95

Sensepeek PCBite SQ10: Hands-free probes (set of 4)

• Part Number: SAL-00186

• ECCN: EAR99

• HS Code: 903090

• Country of Origin: Sweden

• Price (USD): $84.95

Sensepeek PCBite Magnifier for PCBite Hands-Free Probes

• Part Number: SAL-00188

• HS Code: 903090

• Country of Origin: Sweden

• Price (USD): $64.95

Sensepeek Insulated XL Base Plate for PCBite Products & Accessories

• Part Number: SAL-00189

• HS Code: 903090

• Country of Origin: Sweden

• Price (USD): $64.95

Binho Nova Multi-Protocol USB Host Adapter

• Part Number: SAL-00173

• Price (USD): $229.00

Discontinued Products

Saleae Logic 4 Black

• SAL-00109

Saleae Logic 4 Red

• SAL-00110

Saleae Original Logic (Gen 1)

• SALEAE001

Saleae Logic16 (Gen 1)

• SALEAE009

Extra Test Lead Set (Gen 1) for Original Logic and Logic16

• Part Number: SAL-00094

• ECCN: EAR99

• HS Code: 8544.42.9000

• Price (USD): $12.95

For some countries, mainly EU member countries, Saleae offers the ability to pre-pay customs, which is usually VAT.

Due to the complexity of pre-paying duties and taxes for all other countries, we do not offer the ability to pre-pay duties and taxes, and they will be due on delivery. Duties and taxes are collected differently depending on the destination country for your shipment.

When shipping the package, Saleae includes a Saleae packing list and a FedEx-generated commercial invoice, along with the normal shipping labels.

The commercial invoice includes the description, declared value, country of origin, and harmonized tariff codes for each item, as well as the quantity. This document is used to determine the taxes and duties charged.

Multiple copies are included with the shipment.

If you have any questions about the duties and taxes charged, please contact your local customs office. If you have any questions about how the items were declared or have any other questions about shipping, please let us know.

Each Saleae logic analyzer comes complete with all the accessories needed to fully utilize it—wire harnesses, clips, a USB cable, and a carry case. The complete list of what's included can be found below.

However, if you would like to purchase additional accessories, you can find the complete listing here: https://www.saleae.com/accessories

Accessories marked as "Gen 2" are designed to be used with the following Saleae devices:

• Logic 8, Logic Pro 8, Logic Pro 16, and Logic 4 (discontinued)

Accessories marked "Gen 1" are for the following discontinued products

• Original Logic (discontinued) and Logic16 (discontinued)

Generally, extra accessories will make it easier to switch between different projects or integrate the logic analyzer into a custom design.

The Saleae software is not sold separately. The cost of the software is included in the cost of the product and can be downloaded directly from our website below:

https://www.saleae.com/downloads

Without our products, the software can run in demo mode, allowing users to open previously saved captures or simulate a logic analyzer and its features. More information on running the software in demo mode can be found below.

Shipping Options

To check the shipping options available in your country, simply add an item to the cart on www.saleae.com and select your country. Afterwards, click "Checkout" and enter your shipping information to view the available shipping options and shipping cost.

Adding a Shipping Account Number to an Existing Order

We unfortunately do not have the ability to add a shipping account number for online orders on our website at this time.

International Shipping - Duties and Taxes

Saleae regularly ships internationally.

If you are shipping to a country outside the US, there will likely be additional charges for duties and taxes, due on receipt.

In some locations (i.e., most of the EU), we offer the ability to pre-pay import taxes such as VAT. If this is the case, we can charge you the customs fees and it will be clearly indicated in the shopping cart. Afterwards, you will not get a customs bill. You will see what options are available on the cart page.

Order Emails and Tracking Numbers

As soon as your order is placed, you will receive an email from us confirming the details. If you need to make any changes, please contact us as soon as possible.

After your order ships, you will receive a second email with a tracking number and a link to check the tracking number. Please note that the tracking number may not appear in the system for up to 24 hours.

Where Will My Order Ship From?

For online orders placed at www.saleae.com, you can view the shipping origin at the bottom right of the cart page underneath the Checkout button, like shown in the example image below.

The origin of the shipment is determined by the shipping country destination that is selected. Please note that you cannot select the currency, as this is automatically determined based on the destination country for the shipment.

Additionally, direct purchase orders (POs) that are processed via email will always ship from Austin, TX, and will be paid in USD currency. This applies even for shipments that will be delivered outside of the US.

No Shipping Days

Saleae observes the typical United States holidays and does not ship on the following days:

• New Year's Day (January 1)

• Memorial Day (last Monday in May)

• Independence Day (July 4)

• Labor Day (first Monday in September)

• Thanksgiving Day (fourth Thursday in November)

• Christmas Day (December 25).

Can You Ship to a PO Box Address?

No, unfortunately we cannot ship to PO Boxes.

In-Stock Items

Normally, orders placed before 12 pm PST on weekdays are shipped the same day. The stocking status (in stock or out of stock) is displayed under each item in your cart.

Out-of-Stock Items

If an item is not in stock, an estimated time of shipment is displayed in your cart. This is our estimate, but sometimes it may take longer than indicated. If any of your items are out of stock, your entire order will be held until it can be shipped in full, but you may contact us to make other arrangements.

Each Saleae unit comes with all the necessary probes, wire harnesses, and a USB cable to use the unit. In addition, it comes in a custom zippered carrying case.

Logic 8

• Saleae Logic 8 USB Logic Analyzer

• 2x 4-Channel Wire Harnesses

• 16x Micro-Gripper Hooks

• Saleae Carrying Case

• USB 2.0 Micro Cable

• Getting Started Card

Logic Pro 8

• Saleae Logic Pro 8 USB Logic Analyzer

• 2x 4-Channel Wire Harnesses

• 16x Micro-Gripper Hooks

• Saleae Carrying Case

• USB 3.0 Cable

• Getting Started Card

Logic Pro 16

• Saleae Logic Pro 16 USB Logic Analyzer

• 4x 4-Channel Wire Harnesses

• 32x Micro-Gripper Hooks

• Saleae Carrying Case

• USB 3.0 Cable

• Getting Started Card

No additional accessories are required to get started. If you are interested in recommendations for additional accessories, please review this article:

Saleae does not offer an evaluation program for its products.

However, all purchases made directly from Saleae, either from our website at www.saleae.com or via PO, have a 180-day return policy. If at any time during that period you want to return the product, you can do so and receive a full refund, including shipping. For more information about returns, see this article:

"Unfortunately we are unable to ship to PO Boxes"

Solution

To quickly solve this, swap the “Address” and “Apartment, suite, etc” fields like shown below. If the address does not contain an apartment/suite number, then you can leave the "Address" field blank. This works because our cart system only checks for the word "Post" in the "Address" field.

Some Background on the Issue

Our website does not allow orders to be shipped to PO Boxes. Therefore, our cart system blocks the word "Post" in the "Address" field. We plan to fix this in the future, but in the meantime, you will need to use the workaround described above to place your order. Sorry for the trouble with this in the meantime!

The following information applies to orders placed directly on our website at www.saleae.com.

Direct Credit Card Payments

The first way to pay for orders is directly with your credit card. When you place an order with your credit card directly on our website, we process an authorization on your card using our credit card payment processor, stripe.com. At the time we ship your order, we charge against that authorization.

If your shipment does not ship within 7 days of the order placement, that authorization automatically expires. That does not mean your order is canceled, and in most cases, no further action is required. When your order does ship, if the authorization has expired, we still charge your card.

PayPal Express Checkout

When you place your order with PayPal express checkout, we only authorize your PayPal account. When your order ships, we charge against that authorization. Unlike direct payments, however, when that authorization expires, there is no way for us to charge your order without customer intervention. PayPal authorizations usually expire about 29 days after the original order was placed. There is no way for us to extend the authorization window, and reauthorizations do not change the original authorization expiration date.

In order for us to ship your order after the 29-day window, we will contact you with instructions. We will send you a link that will redirect you to PayPal's website where you can quickly make a new payment for the order. We will authorize and charge your account and then ship your order.

Payment Declined at the Time of Shipping

If we are unable to charge your order at the time of shipping due to a payment decline, we will hold your order and email you with instructions to fix the situation. If you paid directly with a credit card, we will provide you with a link where you can re-enter your payment information and verify that the charge was successfully processed.

If you paid with PayPal express and we were unable to charge your card due to payment decline, we will email you with instructions as well. The fastest way to solve this issue is to pay directly with a credit card, but alternatively, you can pay with PayPal again, although it will require you to cancel and placing a new order on our website.

Quickly get up and running with Saleae Logic and learn the basic features! You can follow along whether you own the Logic hardware or not. If you don't own a Saleae Logic, you may run the software in Demo mode.

We recommend getting started with the Setup guide below.

You may also want to check out our Tutorial Video Playlist to learn more about our software's features.

The Saleae Logic Analyzer is a powerful tool capable of capturing multiple signals from a digital circuit and displaying that information in the form of timing diagrams. Saleae’s Logic 2 software can help you decode a variety of digital protocols, including UART, SPI, I2C, 1-Wire, I2S, CAN, USB, and many more. These features can make debugging your embedded designs much simpler.

To begin, download and install the Logic 2 software from the Logic 2 download page.

Connect one or more cable harnesses to the Saleae Logic Analyzer. Note that each cable harness has an arrow on the top of the connector. This arrow should point up (same side as the Saleae logo) and to the left (the side with the ‘S’ in Saleae).

The unlabeled black wires are ground (GND), and the signal wires are labeled 0-7 (repeated if you have the Logic Pro 16). Looking straight at the ports of the analyzer, the top row of pins are labeled 0-7.

Build your test circuit, connect at least one ground wire to your circuit's ground node, and connect one or more signal wires to the nodes you wish to measure. Note that all ground pins are shorted internally. Therefore, only one ground pin needs to be connected to your test circuit at a minimum.

With the logic analyzer plugged into your computer, start the Logic 2 software. If this is the first time you are using your logic analyzer, the Logic 2 software will automatically download a calibration file for your particular analyzer. If you do not have access to the Internet, refer to the Device Calibration section of the User Guide.

Before you capture any data, click on the Capture Settings button to configure the logic analyzer. Select the sampling rate, capture duration, ports, voltage, and other settings relevant to your preferred capture parameters.

Note: only the Logic 8 Pro and Logic 16 Pro have the "Voltage" setting.

To learn more, see the Device Settings section of the User Guide.

Table Of Contents

Hover your mouse pointer over any signal data to get automatic measurements, such as pulse width, frequency, and analog voltage. You can right-click to hide & show interactive measurements. You can also add measurement windows and timing markers.

You can set the logic analyzer to begin recording only when it sees a particular edge or pulse by selecting Trigger from within the Capture Settings panel. Once the data has been collected, you can navigate directly to the trigger point by clicking on the small yellow tab above the recorded waveforms.

Once you have captured data, you can zoom in and out of your captured data by using your mouse wheel or up/down arrow keys. Click-and-drag in the viewport or use the left/right arrow keys to pan left and right.

Click the Start button to begin recording data from the logic analyzer.

Note that if you do not have a logic analyzer plugged into your computer, a popup window will appear at the bottom of the software, notifying that there is no connected device, and that demo data will be generated.

Electrical Isolation

The input channels on Saleae Logic analyzers are not electrically isolated from each other. The Saleae Logic is also not electrically isolated from the PC.

Suggestions for electrical isolation can be found in the link below:

High Voltage Safety

Ground Current Safety

Specifically, this is when a high current flows from the ground pin on the logic analyzer to the ground on the USB port of your computer, or vice versa. This current can easily damage the logic analyzer, your PC, and your DUT. All Saleae logic analyzers have fuses in their ground return paths, but these are not always fast enough to protect the unit from damage.

The user should be cautious of this when the logic analyzer is used in the presence of a ground loop. Specifically, this means that the logic analyzer is not the only ground path between your DUT and the host PC. Ground loops by themselves are not necessarily bad, but requires extra caution from the user.

Common Ways a Ground Loop Can Exist:

• Other USB devices (such as programmers) are connected to the DUT, or the DUT itself is plugged into the USB port on your computer. In addition to the logic analyzer's ground connection, the DUT's ground is also connected to the PC's ground through another USB port.

• Non-isolated power supplies Most AC power supplies with 3-prong plugs will short the MAINS earth ground pin to the power supply ground output. That includes your PC's ground. If your DUT is powered from a 3-prong wall power supply and your PC is also plugged in, that will form another ground path. Keep in mind that if you're using a laptop that's not plugged in, even an attached external monitor or printer will create a ground loop.

Common Ways Damage Can Occur:

• When connecting or disconnecting probes, one of the ground probes from the logic analyzer is accidentally brushed against a power supply pin on the DUT, such as +5V. If there are no other ground paths between the DUT and the PC, nothing will happen. However, if there is a ground path, then current will flow from that voltage supply through the logic analyzer's ground pin, through the USB cable and the host PC, and then through the secondary ground connection—either MAIN earth ground or another USB port, back to the ground on the DUT. Basically, that is the same as shorting out the voltage supply on your DUT, but it uses the logic analyzer and your host PC as the short circuit, which could damage all components in the loop.

• What if the DUT's ground reference isn't at the same voltage as the ground loop connection? For instance, if your circuit is powered by a bipolar power supply used to produce +10 volts and -10 volts, and then your circuit uses the -10 volt rail as its ground voltage, but there exists a ground loop through MAINS earth ground to the power supply's 0 volt output, then effectively the ground on your DUT is actually -10 volts relative to the host PC. Connecting Logic will immediately short out the DUT power supply and potentially damage all devices present in the loop.

Testing Multiple DUTs

In some cases, you need to record signals from multiple devices under test simultaneously with the same logic analyzer. This can be done safely, but it is important to review how both devices are powered before connecting the logic analyzer.

Since the channels in each Saleae logic analyzer are not electrically isolated from each other, all devices will need to share a common ground. If the devices under test already share a common ground, then you're all set. However, if they are floating relative each other (meaning their grounds are not directly or indirectly connected to each other), or if there is a common mode voltage setup between them, then the additional steps below are required:

• If one or both of the devices under test are floating, do they need to be floating? In order to record with a logic analyzer, they will need to be common grounded to each other AND to the PC to which the logic analyzer is connected. This also means MAINS earth ground in most cases.

• If one of the boards is powered from another with a ground difference such as a large negative voltage supply, then it is NOT safe to connect the logic analyzers to both devices. In addition, it is not sufficient to isolate the USB connection or the test PC from the devices. The inputs themselves need to be isolated between the device under test and the logic analyzer for at least one of the two devices under test. Please see the SI labs isolation development kit at the bottom of this article for input channel isolation.

• If the devices are already common grounded to each other, then there are no special steps to follow. Just review the general ground loop information above.

Identifying if a Ground Loop is Present

To identify a potential ground loop between the Logic device and the DUT, you could check the resistance between the DUT ground and the Saleae Logic ground. While the Saleae Logic is connected to the PC, if the resistance reads infinite on a multi-meter, then the grounds are isolated. Otherwise, they are connected, and a ground loop exists.

If you believe there is a ground loop between the DUT and the host PC but you are uncertain if the grounds on both sides you plan to use are at the same potential, there is a quick test you can perform with a multi-meter. If you happen to have a large resistor (> 10K ohm), there is an additional test you can perform.

1. Connect the logic analyzer to the PC but not the DUT.

2. Measure the voltage between the ground pin on the logic analyzer and the ground pin on the DUT.

3. If there is a ground loop and you measure a voltage greater than about +/- 100mV, then a common mode ground current may occur when they are connected, damaging your equipment.

4. If there is a ground loop and you measure a voltage smaller than about +/- 100mV, then it is safe to connect the ground pins.

5. If there is not a ground loop or you are not sure there is a ground loop, then the voltage may drift significantly. If you are SURE there is no ground loop, then it is safe to connect the grounds.

If you are not sure there is a ground loop or would like to perform another test anyway, connect the resistor (~10K) between the two grounds and then measure the voltage across the resistor.

• If you see a voltage that indicates a noticeable current, then there is a ground loop between devices and you should not connect the grounds together.

• If you see an insignificant voltage across the resistor, then either there is no ground loop or there is a ground loop, but both grounds are at the same reference. It is safe to connect the logic analyzer.

Identifying if the DUT is Isolated from the PC

The DUT's local ground is isolated from the host PC when one of the following is true:

• The DUT is battery-powered and has no other electrical connections to the host PC or devices powered from MAINS power.

• The DUT is powered from an isolated power supply that does NOT short MAINS earth ground to the output ground. Bench top supplies with a separate green earth ground terminal do this. USB wall adapters also do this. Common AC power adapters (chargers, "wall warts") with 2-prong plugs are also isolated. Most power supplies do have transformers that can provide isolation if implemented properly.

• The Host PC is a laptop running from a battery or is plugged into an instrumentation isolation transformer. Note that normal isolation transformers connect earth ground for human safety reasons.

Using an Isolated Wall Adapter to Power the DUT

Using isolated wall adapters such as USB wall adapters to power the DUT will isolate its ground from MAINS ground, although that does not always eliminate ground loops. For example, if the DUT was connected to the same computer that the Logic device is connected to, then a ground loop is formed.

Is the Logic Device Safe to Use in the Presence of Ground Loops?

Yes, it is completely safe to use the Logic device as long as both grounds are at the same voltage level and as long as you only connect the Logic ground to the ground of the DUT.

Isolation: There Is a Ground Loop and a Difference in Potential Between Grounds

What do you do if the grounds are related but not at the same potential? You will need to fully isolate the DUT from the PC. You can do this on either side of the logic analyzer.

To isolate the digital input side of the logic analyzer, you can consider using the SI84XXISO Evaluation Kit

To isolate the USB 2.0 high-speed connection, you can consider using the Intona High Speed USB Isolator. We recently purchased this isolator and will be performing an evaluation soon. This is the first true high-speed USB 2.0 isolator on the market. All other USB 2.0 isolators are only full speed and low speed, which is insufficient for our products to operate.

Warranty Coverage

Saleae products are covered by a 3-year warranty, regardless of where you purchased the product. For more information, see the article below.

If you believe your Logic hardware is broken, please follow the troubleshooting steps in the article below.

The Logic 2 software consists of the following sections:

1. Logic Analyzer Connection Status

This button allows you to check your logic analyzer's connection status with the software. Clicking it will allow you to view device information such as the device type, serial number, and calibration status.

2. Configuring Input Channels & Setting the Sampling Rate

Use the Capture Settings panel to enable or disable channels, and to configure the sample rate for the configured channels.

3. Adding & Renaming Session Tabs

Click the "+" button to create new capture sessions tabs. This can be useful to manage multiple captures. To rename a tab, click the text within the tab.

4. The Start Button

Click the green "Start" button to begin a data capture.

• If a logic analyzer is not connected, this button will generate simulation data as if a logic analyzer was collecting real world data.

• If a logic analyzer was connected, then this would begin capturing data from its enabled input channels. After the capture has started, you can stop it before it finishes, which will retain the data to that point.

5. Side Panel Buttons

The side panel buttons offer various ways to configure your logic analyzer settings. More information on these settings can be found in the articles below.

6. Time Scale Adjustment

The time scale for the displayed waveforms can be adjusted to an exact time value per 100 pixels as shown below. This gives the ability to set an exact zoom level, as opposed to using the mouse scroll wheel or using keyboard shortcuts to zoom in and out.

Other Useful Features

Several more useful tasks can be performed from the main software view, such as...

• Renaming Channels

• Reordering, Resizing, & Scaling Channels

• Editing Colors

These features are described in our tutorial video below about organizing your workspace.

There are two important specifications to keep in mind when determining what signals can be recorded with the Saleae products and what signals could potentially damage the device.

The first is the supported IO thresholds. These define the voltage thresholds that determine what is recorded as a digital 0 and a digital 1.

The second is the over-voltage protection. It determines the maximum input voltage that can be applied without risking damage to the device.

For all Saleae products, all inputs share the same IO threshold. For products with selectable thresholds, there is no way to assign different IO thresholds to different pins at the same time. All pins share the same threshold setting.

A Note on Input Threshold Variation

There might be some small variation in the precise threshold voltage channel to channel. That is most notable in the Saleae Logic Pro devices because comparators with low hysteresis are used.

Logic 8

Logic 8 has a fixed input voltage threshold for its digital channels.

• Voltage input low: 0.6V

• Voltage input high: 1.2V

• Over-voltage protection provides safety to +/- 25V

Notes:

• The 1.2V input voltage high spec allows Logic 8 to be used directly with the CAN low channel of 3.3V CAN.

• Recommended IO standards: 5.0V, 3.3V, 2.5V, 1.8V

• For Logic 8's digital channels, the range between 0.6V and 1.2V results in undefined behavior. For signals that might cross this range slowly (e.g. I2C signals due to its relatively slow rise/fall times caused by its open drain topology), you may want to ensure that the software glitch filter is enabled to filter out any potential glitches that might cause decoding errors.

Logic Pro 8 and Logic Pro 16

Logic Pro devices have three selectable voltage threshold options. This setting applies to all the input channels simultaneously.

The inputs are also implemented with comparators instead of standard CMOS buffers found on Logic 4 and Logic 8. This makes the input-low and input-high voltages very close to each other. The exact behavior of these comparators is not defined here.

• 1.2V Voltage Option

  • Voltage threshold: 0.6V

• 1.8V Voltage Option

  • Voltage threshold: 0.9V

• +3.3V Voltage Option

  • Voltage threshold: 1.65V

  • Use this option for all IO standards 3.3 volts or above.

• Over-voltage protection provides safety to +/- 25V

Notes:

• Recommended IO standards: 5.0V, 3.3V, 2.5V, 1.8V, 1.2V

• The precise threshold voltage is not calibrated and may vary as much as +/- 15%. That is more than accurate enough to record standard IO families.

Logic 4

Logic 4 has a simple, fixed input voltage threshold.

• Voltage input low: 0.8V

• Voltage input high: 2.0V

• Over-voltage protection provides safety to +/- 25V

Notes:

• Over-voltage protection is sufficient to use this product safely with RS-232, RS-485, 12V TTL, and other larger swing signals inside the +/- 25 V range. No adapter or additional protection is required.

• Because of the voltage input high threshold of 2.0 volts, this device cannot be used with 1.8V or 1.2V logic. It also cannot be directly connected to 3.3V CAN signals. Please see our article about recording CAN for more details.

• Recommended IO standards: 5.0V, 3.3V, 2.5V

First-Generation Logic

The original Logic also has a fixed input voltage threshold.

• Voltage input low: 0.8V

• Voltage input high: 2.0V

• Over-voltage protection provides safety to +/- 15V

Note: Over-voltage protection is not meant for continuous operation outside of -0.5V to 5.25V. That makes the device unsuitable for safe, direct recording of RS-232 and similar standards.

The original Logic is the only Saleae device to have internally pulled up inputs. All other Saleae devices had an internal resistance to ground. The original Logic's inputs float at about 2.4 volts, with over 100 K ohms of pull-up resistance, producing a very small pull-up effect.

First-Generation Logic16

The original Logic16 had two selectable threshold settings. There is approximately a 5 second delay when setting this threshold for Logic16.

• 1.8V to 3.6V Setting

  • Voltage input low: 0.7V

  • Voltage input high: 1.5V

• 3.6V to 5.0V Setting

  • Voltage input low: 1.4V

  • Voltage input high: 3.6V

• Over-voltage protection provides safety to +/- 50V

  • Note: Over-voltage protection not meant for continuous operation outside of -0.9V to 6V. That makes the device unsuitable for safe, direct recording of RS-232 and similar standards.

When connected to the internet, the Logic software will automatically handle downloading the calibration file. In rare cases, users may need to download the calibration file manually if the software is not able to download it on its own (typically due to network security measures).

The 2nd Generation of Saleae products (Logic 4, Logic 8, Logic Pro 8, & Logic Pro 16) use calibration data generated at Saleae to display accurate AC and DC values. The 1st Generation (Original Logic and Logic16) do not require any form of calibration.

This calibration data is not stored on the device. Instead, it is stored on our servers, and the software automatically downloads this calibration data as well as checks for updates when a device is connected.

Checking Calibration Status & Device Serial Number

Our support team may request you to send your serial number to us to further investigate your device's calibration status. We may also have you check your device's calibration status as reported by your software below.

1. Click the Device Settings Panel Button on the right

2. Click the three dots next to your device name on the top-right

3. Click Device Info to view the device's calibration status and serial number

Install Calibration via Logic 2 App

1. If the auto-download for calibration fails, a popup will appear. 2. Click "Download" to download the calibration file 3. Click "Load File" to load the calibration file 4. Check calibration status to ensure it is successful

Install Calibration to an Offline PC

In cases when you are not able to download the calibration file from within the Logic 2 app (for instance, if you are using an offline PC), you may download the calibration file using another PC that has internet access by using its browser. This file will need to be brought over to the offline PC. The steps are shown below:

1. On the PC that has the Logic 2 app installed (which may be offline), connect your Logic analyzer via USB.

2. Navigate to the Device Information window as we show in the Checking Calibration Status & Device Serial Number section above.

3. Take note of the serial number listed there.

4. On another PC that has internet access, enter the link below in your browser and add your Serial Number. This will prompt you to download a calibration file in .cal file format.

   • downloads.saleae.com/calibration/{Insert Serial Number here}.cal

   • Note: Device ID must be entered in lowercase.

   • For example: downloads.saleae.com/calibration/3b2e3a21ca4ad130.cal

5. Take this newly downloaded .cal file to your other offline PC and paste it to a convenient and temporary location, such as your Dekstop.

6. Open the Logic 2 app and connect your logic analyzer. You should be greeted by a Device Calibration Error popup below. Click Load File and navigate to the .cal file you recently downloaded. Your device should now be calibrated on this PC once the file is loaded.

Where are my Calibration Files stored?

OSX: /Users/YourUserName/Library/Application Support/logic/calibrations Windows: %APPDATA%\Logic\calibrations Linux: ~/.config/Logic/calibrations

My Browser Opens the Following Page

When manually downloading the calibration file in Logic 2.x, in rare cases, your browser may open a page that looks like the image below.

In this case, please submit a Warranty Request form and we will be happy to help. This may be indicative of hardware failure and we'll most likely want to process a warranty for you.

Transferring the Calibration File from One PC to Another

1. Install the latest Logic software on a machine with Internet access.

2. Open the software and connect the Logic device.

3. Wait for the device to fully connect to the software.

4. Check preferences dialog to be sure the calibration data is loaded.

5. Close the software.

6. Copy all *.cal files from the calibration folder of that computer to the computer without Internet access.

Each .cal file is specific to a single device, but the .cal files are saved with the device ID in decimal and not hex, making it hard to tell which is which. If only one device has ever been connected, there will only be one .cal file.

Do I Have the Latest Calibration File?

If there is a newer calibration file available for your device, our software should automatically download it as long as it is connected to the internet. Note that we usually do not make updates to the calibration files.

In case you want to check if there is an updated calibration file available, please manually download the calibration file using the instructions above and check for the calibration status.

Can I Manually Adjust Calibration Values for my Logic Device?

This is one of our top requested features for which we would love to work on at some point. However, a proper implementation is a long way off. In the meantime, we have a workaround which will allow users to adjust their calibration file's analog gain & offset manually by a Python script. More information about this can be found below:

• Discuss Forum - Quick calibration hack to adjust channel gain and offset

Do you Provide Calibration Certificates?

Our devices do not require periodic recalibration. You can download our statement of calibration below.

Specifically, there is no calibration certificate. The devices do undergo a one-time factory calibration process.

Having Trouble?

If you are having trouble manually downloading the calibration file, we can send it to you. Please contact support, and we can make sure your calibration data gets updated.

The following accessories and instructions apply to the following Saleae Logic products - Logic 4, Logic 8, Logic Pro 8, and Logic Pro 16.

Wire Harness (Gen 2 Version)

A 2x4 wire harness is used by Logic 4, Logic 8, Logic Pro 8, and Logic Pro 16, which are our 2nd-generation logic analyzers.

Connecting the Wire Harness

If you have Logic 4, Logic 8, or Logic Pro 8/16, then you have one or more 2x4 wire harnesses. The four black leads are ground and should be on the bottom. The four colored leads are the signal inputs and should be on the top. There is an indication of this orientation on the back of the device.

Note that the test lead color matches the channels in the software. The colors reflect the resistor color code for numbers 0–7. The numerical channel number is on the white heat shrink at the ends of the leads. The lead ends are made up of the following parts:

• Molex 0016020086 crimp connectors (for typical .100-inch spaced headers/pins)

• Molex 0022552081 plastic housing (2x4 - 2.54mm/.100in pitch)

Connecting the Ground Pins

The 2x4 harness has a ground lead for each channel. When signal integrity is a concern (e.g., working with high-speed digital or analog in the presence of cross-talk sources), connect a ground for each channel. Connect noisy digital inputs to leads as far as possible from leads connected to sensitive analog measurements.

Note that the ground leads are shorted internally. Therefore, when signal integrity is not crucial, only one ground lead needs to be connected to your device under test at a minimum, while the rest of the ground leads can be left floating.

Test Clips

All Logic products come with enough test clips for every test lead. These test clips have two metal pins that can be inserted into the connector at the end of each test lead. Only one of the metal pins needs to be connected to a single test lead connector.

Connecting to Headers

If your PCB has .100-inch headers that break out signals you need to examine, you can connect the test leads directly to these pins.

Ultra-Fine Pitch and Other Difficulties

In many situations, it may be difficult to connect Logic directly to your signal. Generally, in these situations, you'll want to solder a wire (typically wire-wrap wire) to an exposed pin, trace, or via, and then use Logic's test clip to connect to that wire. Alternately, you can invest in some extremely small pitch test clips such as these: Test clips - Grabbers, Hooks

Gen 1 Logic Accessories

The following accessories and instructions apply to our Gen 1 products - Original Logic and Logic16.

Wire Harness (Gen 1 Version)

A 1x9 wire harness is used by the Original Logic and Logic16, which are our 1st-generation products.

Connecting the Wire Harness

If you have the original Logic or Logic 16, then you have one or more 1x9 wire harnesses. These harnesses are colored according to the resistor color code for 0–7. The colors match the channel colors in the software. The ground wire is grey and has a GROUND label on the white heat shrink. Turn the device over for a ground symbol, and make sure the grey test lead aligns with this symbol.

Signal Integrity with the Gen 1 Harness

When using Logic16 with more than 8 inputs, we recommend connecting the second ground line, especially if using higher voltages (5V). That will help reduce cross-talk during any simultaneous switching events.

Community Created Accessories

Several Logic accessories have been made available by our community of users. These are listed in the support article below.

The Device Settings Panel can be opened up by clicking on the Device Settings icon located on the software's side panel on the right.

From this panel, several settings can be configured, such as:

• Digital Channels

• Digital Sampling Rate

• Digital Voltage Setting

• Analog Channels

• Analog Sampling Rate

• Preset Saving/Loading

• Capture Modes (Looping, Timer, & Trigger)

• Capture Mode Specific Settings

• Trim

• Glitch Filter

• Memory Buffer Size

Our tutorial video below demonstrates setting some basic settings such as enabling/disabling channels, settings the sampling rate and voltage, and specific settings related to the Timer capture type.

Channels & Sampling Rate

Individual digital and analog channels can be enabled and disabled as needed. In addition, the sampling rate for digital and analog channels respectively can also be adjusted.

Please note that changing these settings may affect the available sampling rates for other channels. This is due to the total amount of available bandwidth that our logic analyzers can support. When this happens, you will receive a popup about the sampling rate change like shown below.

When both digital and analog channels are enabled, changing the sampling rate for a certain type of channel (digital or analog), may also change the sampling rate for the other type (digital or analog). This is because certain digital sampling rate selections cannot be combined with certain analog sampling rates (and vice versa) due to architectural limitations.

In the example image below, selecting Digital 125 MS/s will increase (↑) the Analog sampling rate to 6.25 MS/s from its current setting. In addition, selecting Digital 6.25 MS/s will decrease (↓) the Analog sampling rate to 1.5625 MS/s from its current setting.

Digital Voltage Setting

Logic Pro 8, Logic Pro 16, and our Original Logic16 all feature adjustable voltage thresholds, which can be set via the voltage dropdown setting next to the digital sampling rate setting. The 3.3+ Volts setting, for example, will set the voltage threshold to half that value, or 1.65 V. Our other logic analyzer models have a fixed voltage threshold, and therefore do not have this setting. For more information on the voltage setting options and thresholds, see our support article on this below.

Capture Settings Presets

Capture settings presets can be saved and loaded locally as needed. You can navigate to the support article below for more information on this.

Capture Modes - Looping, Timer, & Trigger

For more information on the available capture modes and their specific settings, see the support article below.

LED Settings and Color

Timer Mode

The timer mode is the simplest mode of data capture. A pre-defined duration is set by the user and the capture will end once the duration is reached. In the example video below, we set the capture duration to 5s. The recording will stop once 5s is reached.

Looping Mode

The looping mode allows for a continuous recording into a RAM buffer, the size of which can be set by the user. Once the RAM buffer is filled, old data is deleted while new data arrives, and the capture can continue indefinitely in a continuous loop. When the capture ends, the data can be trimmed down to a certain length via the Trim data after stopping setting, keeping the most recent data.

In the example video below, we set the Memory buffer size to 500 MB. Notice that, during the capture, the memory usage does not go above the set Memory value of 500 MB during the continuous recording.

Trigger Mode

Edge & Pulse Triggering

The trigger mode will continuously record data until a digital trigger is found on a single channel. The four available types of digital triggers are Rising Edge, Falling Edge, High Pulse, and Low Pulse.

Additional Channel State Triggering

In addition to the edge/pulse trigger which is set on a single digital channel, you can require other digital channels to be either HIGH or LOW to trigger a capture.

Memory Buffer Setting

In Trigger mode, while waiting for the trigger during a capture, Logic will continue using the PC's RAM in a continuous loop. The Memory buffer size setting limits the amount of RAM usage for this process. Similar to Looping mode, once the RAM buffer is filled, old data is deleted while new data arrives, and the capture will continue indefinitely until the trigger condition is met.

Please make sure to size the "Memory buffer size" appropriately from within the capture settings panel, such that your PC does not run out of memory while waiting for a trigger.

Capture Duration Before and After Trigger

The data that was captured before the trigger can be trimmed down in length. This allows you to specify how much of the data before the trigger is kept when the capture ends.

You can also specify the duration at which the software will continue recording data once the trigger condition is met.

Jumping to the Trigger Point

Two options exist for jumping to a trigger point after your capture is complete:

• Via a keyboard shortcut (On Windows it is Ctrl+J)

• Via clicking on the trigger icon above your capture (shown below)

At the moment, we don't have a way of automatically jumping to trigger point after a capture. If this is a feature you would like added, please vote for it in the idea post here!

Trigger View - Triggering on a Protocol Result

Navigate to the "Analyzers" panel and enable "Trigger View." From there, select the protocol analyzer you would like to trigger on, as well as the query value and holdoff time. HLA results can also be triggered on via this method.

1. Open the Logic 2 software

2. Connect one end of the included USB cable to the Logic analyzer

3. Connect the other end of the USB cable to the PC's USB port. Ensure that the proper USB port is used for the specific device. Due to the amount of bandwidth required, it is recommended to directly connect to the PC's USB port rather than through a docking station or a USB hub.

   • Logic Pro 8 and Logic Pro 16 require a USB 3.0 port.

   • Logic 8 requires at least a USB 2.0 port.

   • Our discontinued products (Original Logic, Logic16, and Logic 4) require at least a USB 2.0 port.

4. Once connected to the PC, the software will begin configuring the device and the LED on Logic should turn on.

Saleae Logic Analyzers consists of the products listed in this section. The products below have the capability of recording both digital and analog signals.

• SAL-00111 Logic 8 Black

• SAL-00112 Logic 8 Red

• SAL-00113 Logic Pro 8 Black

• SAL-00114 Logic Pro 8 Red

• SAL-00115 Logic Pro 16 Black

• SAL-00116 Logic Pro 16 Red

Datasheets & Specifications:

What's In the Box?

• Logic 8 includes: Saleae Logic 8 USB Logic Analyzer, 2x 4-Channel Wire Harnesses, 16x Micro-Gripper Hooks, Saleae Carrying Case, USB 2.0 Micro Cable, & the Getting Started Card

• Logic Pro 8 includes: Saleae Logic Pro 8 USB Logic Analyzer, 2x 4-Channel Wire Harnesses, 16x Micro-Gripper Hooks, Saleae Carrying Case, USB 3.0 Cable, & the Getting Started Card

• Logic Pro 16 includes: Saleae Logic Pro 16 USB Logic Analyzer, 4x 4-Channel Wire Harnesses, 32x Micro-Gripper Hooks, Saleae Carrying Case, USB 3.0 Cable, & the Getting Started Card

Additional Accessories

Accessories which are not included in the box can be purchased via the Saleae Accessories store.

Trim your Capture

Parts of your captured data can be deleted as needed. In previous versions of the software, we referred to this action as a trim or crop of the data. This can be useful if only a portion of the data capture is needed. A few methods are described below.

Right-Click in the Waveform

Right-clicking any point in your capture will show the option to "Delete Data." You can delete the data before this point, after this point, or all the data off-screen.

Right-Click a Timing Marker

Right-clicking a timing marker will also show the option to "Delete Data." You can delete the data before the selected marker or after the marker. If your timing marker is part of a pair, you can also choose to delete data outside the pair.

Our tutorial video below demonstrates the basics of decoding data using protocol analyzers. The video covers the following topics:

• The basics of protocol analyzers

• Capturing and decoding SPI data

• Configuring the SPI analyzer

• Changing the display radix

• Navigating using the Data Table

Protocol Bubble Merging

When zooming out, we've implemented a feature that merges seperate protocol bubble results into a single protocol bubble. The decoded data in the newly merged bubble will be displayed in sequential order. A number will also appear on the left side of the bubble. This number indicates how many protocol bubbles were merged together.

Troubleshooting Analyzer Issues

1. Restart Analyzers

2. Filtering Glitches from your Capture Data

The glitch filter is designed to help remove noise picked up in the digital recording. This can be especially useful when using protocol analyzers, since present noise may prevent proper decoding of digital data. More information on enabling the glitch filter can be found below.

Saving & Opening Captures

To save your current capture tab, click File > Save Capture. To open an existing capture file (.sal file format), click File > Open Capture.

Saving & Opening Presets

The most recently used capture settings should be automatically loaded in the Logic 2 software upon opening the app. You can also save and load capture settings presets as needed.

To open the Presets window, click File > Presets from the top menu.

This will open the Presets window below. From here, you can manage capture setting presets for the software. To share your presets with others, you can export your preset and import it into a new PC. Click on the 3 dots to the right of your preset to open up the options menu for that preset. This will allow you to load, rename, export, or delete you preset. To import a preset, click the Import button at the bottom of the Presets window.

Backing Up your Presets or Bulk Transferring Presets

Your Logic software's settings, including Logic Preset configurations, are stored in a config.json file. This config file can be found in the location described in the support article below.

You may want to backup your config file in case you wanted to backup all of the Logic Presets that you have created. This will also allow you to transfer all of your Logic Presets to another PC.

Legacy Capture Files (.logicdata files)

For now, please refer to the support article below for more information on this topic.

The color theme for the Logic 2 software can be adjusted from within the Preferences window, which can be reached by clicking the Options button (3 lines) at the bottom-right of the software.

Light Theme

Dark Theme

Exporting the Data Table

The Logic 2 software allows exporting of the entire Data Table, which can include entries from all of your added analyzers. To export the Data Table, click the 3 dots to the right of "Data," then click "Export Table."

Exporting Raw Data

To export raw data from your capture, click the Options button at the bottom right of the software, then click "Export Raw Data."

You will be greeted with an "Export Raw Data" window. From here, you can select the channels you would like to include in your export, the analog downsample ratio (if analog channels are included), and the time range.

Scrolling down the "Export Raw Data" window reveals more options, including the desired Export Format, as well as the Export Location. An "Always Replace" option is also available to continuously overwrite your previous exported files in the specified Export Location.

Format of the Raw Data Export

Digital channel entries are only recorded in the export file when data changes. Therefore, the number of entries in the resulting export file are dependent on the number of transitions that occur and not on the number of digital samples in the capture. This helps reduce the file size of the export file.

Having said that, we always create a new entry on the final digital sample, meaning that the last 2 entries in your raw data export file will not include any data changes on the digital channels. This is because we want to help the user determine how much data was captured and exported down the last sample, even though there were no data changes.

Exporting Analyzer Results

To export your individual analyzer results, click the 3 dots next to the particular analyzer you'd like to export data for. Then click "Export to TXT/CSV." You will be greeted with an OS prompt to save your export file.

This Analyzer's Native Export is Not Supported in Logic 2 - Warning Popup

For some analyzers (namely MDIO, CAN, and LIN), you will run into an error popup that prevents you from exporting the analyzer from the analyzer's drop down menu. In this case, we recommend exporting via the data table instead. More information on this behavior can be found below.

Community Shared Export File Parser

The Logic 2 app has the ability to keep itself updated via automatic updates. This happens in the background, and a popup notification within the app will notify the user when an update has completed downloading and is ready to install.

The update can also be installed from within the app by clicking the Options button at the bottom-right, then clicking About. From there, you can click on the "Update Available!" link to re-open the pop-up window above.

Disabe Automatic Updates

In some cases, users may prefer to manually update their software. Automatic downloads of updates can be disabled by clicking the Options button at the bottom-right, then clicking Preferences. Scroll to the bottom of the Preferences window to reveal the option to disable automatic updates.

The list of keyboard shortcuts for the Logic 2 software can be viewed by clicking Help > Keyboard Shortcuts. You can also use the "?" key on your keyboard to quickly open the list of keyboard shortcuts in the software.

You may contact us directly through the Logic 2 software via the messaging icon at the bottom right.

From here you can...

• Ask a question on our forum

• Suggest a feature

• Report a bug

Suggesting a feature and reporting bugs will open up a support ticket with us via email. We review all suggestions and bug reports! We may also contact you back for more information, or for any updates we have regarding your submission.

In the Logic 2 software, several methods exist for navigating your data. Here are some of the most common methods.

Marquee Zoom: Zooming by Drag Select

Marquee zoom (i.e. zooming in by drag-selecting a region of the waveform) is available on analog channels.

• Use Alt-Drag for XY Range Zoom

• Ctrl-Drag Up/Down for Y (Voltage) Range Zoom

• Ctrl-Drag Left/Right for X (Time) Range Zoom

Zooming, Panning, & Jumping to Edges

X-Axis Discrete Zoom Level

In addition to using the keyboard shortcuts described above for zooming in and zooming out, the Logic 2 software allows you to set a discrete zoom level. The setting for this is located at the bottom-right of the software as shown in the image below.

Y-Axis Zoom for Analog Channels

The Y-axis zoom level for analog channels can be adjusted by hovering over the icon shown in the image below. It will appear at the top-right of an analog channel when hovering over that channel.

While hovering over the icon, several Y-axis zoom adjustment options become available as shown in the image below. These include:

• Y zoom-out / zoom-in / Y fit

• XY zoom-out / zoom-in / XY fit

More Ways of Navigating your Data

To view many more ways to navigate your data, you may open the Keyboard Shortcuts menu from within the Logic 2 software. More information on this can be found below.

The Logic software includes a feature to suppress short digital pulses in the recorded data. It is designed to help remove noise picked up in the digital recording. This can be especially useful when using protocol analyzers, since present noise may prevent proper decoding of digital data.

There are several sources of noise in digital captures. You can learn more about them below.

Enabling the Glitch Filter

You can find the glitch filter settings via the 'Device Settings' panel button to the right of the software. You will need to click the slider and add the appropriate channels to enable it.

When editing the glitch filter value, you may select a unit of time, such as ns (nanosecond), us (microsecond), and ms (millisecond). You may also use non-integer values.

What is a Glitch Filter?

The glitch filter is purely a software filter on top of the recorded data. Using the glitch filter does not actually change the data that is recorded. Instead, it sits between the recorded data set and all software components that access it.

Please note that the Logic Pro devices have narrow hysteresis thresholds, which can cause noise around transitions in some cases. When using lower voltage thresholds with larger swing signals, noise on the signal when it is in the low state can easily be picked up by the Saleae devices, even when the normal receiver of the signal rejects it. More information on our devices' voltage thresholds can be found in the support article below.

The glitch filter can be set for any individual digital channel. We recommend only adding the filter to channels where noise is a problem. The glitch filter will reject all pulses narrower than the specified width.

When a Saleae Logic device is not connected to the PC while the Logic 2 software is running, an option is provided to run the software in Demo Mode. This allows users to test the capabilities of the software without having to own our logic analyzer.

In this mode, when a data capture is run, randomly generated simulation data will populate the recording as shown below.

Generating Analyzer Simulation Data

When an analyzer is added to digital channels while in Demo mode, the simulation data on those digital channels will generate analyzer-specific simulation data as shown in the image below.

Logic 2 Software

The Logic 2 Software is supported in the following operating systems and can be downloaded via the link below.

• Windows 10, & 11 (x64)

• MacOS 10.14+ (Intel / ARM Apple silicon)

• Ubuntu 20.04+ (64-bit)

About Windows 8 Support

Starting with Logic 2.4.14, we no longer support Windows 8. In particular, you will likely run into the following error message when attempting to launch the software.

The procedure entry point DiscardVirtualMemory could not be located in the dynamic link library C:\Program Files\Logic\Logic.exe.

Logic 2 Software

Download & Installation

The latest version of the Logic 2 software can be downloaded below. This is the version we recommend using.

All previous versions of the Logic 2 software can be found below, including a history of the major updates that were implemented in each version.

Instructions for installation and solutions for commonly found errors can be found in the support article below.

Do you Provide a Standalone Version for Logic 2?

There are a few reasons we don't want to publish a standalone version of the Logic 2 app:

1. We would either need to implement another auto-updater feature, or simply not support auto-update (this is not desired).

2. We can't automate installing pre-requisites, and when we change pre-requisites (it may happen from time to time), it creates trouble for anyone trying to update their standalone version.

3. Driver install will still require admin permissions and must be performed manually as mentioned above.

Normally, when the Logic software is installed, the product should simply work when connected to the PC. In case you run into any issues with this, the drivers may need to be installed manually.

Device Shows up as WestBridge or unidentified device

A common issue in Windows is that the Saleae Logic may show up as a WestBridge or unidentified device in device manager. If this is the case, then there is a problem with the Saleae driver. Please install the driver per the methods listed in this support article.

If the drivers are installed properly, you should see Saleae Logic X USB Logic Analyzer in Device Manager, where "X" is the specific product version (4, 8, Pro 8, Pro 16).

Manual Driver Installation (Windows)

Location of Driver Files

To manually install your drivers on Windows, in case you're running into the issue above, or if you are using the standalone version of our software which doesn't install drivers automatically, you will need access to the driver files. There are several ways of obtaining them mentioned below.

• For the Logic 2 software, the Drivers folder is located below:

  • C:\Program Files\Logic\Drivers

• For the legacy Logic 1.x software (standalone), the Drivers folder is located below:

  • <Logic standalone folder>\Drivers\Windows

• For the legacy Logic 1.x software (installed), the Drivers folder is located below:

  • C:\Program Files\Saleae LLC\Drivers

• In case you don't have a previous installation of the Logic software, we provide the Drivers folder via the download link below.

Method 1: New Hardware Wizard Installation

We want to get to the new-hardware wizard for Logic. Please connect Logic to the PC and open Device Manager. In Windows 10 and 8.1, you can right-click on the Windows logo in the lower left and select Device Manager.

In Device Manager, Logic might show up right away as an unknown device with a warning icon next to it. Right-click this and select Update Driver.

Select the second option for "Browse my computer for driver software."

Use the Browse button to direct the driver wizard to the Drivers folder, which is detailed above under the section titled Location of Driver Files.

Click Next. If this fails, continue below.

Method 2: "Have-Disk" Manual Installation

Open the Device Manager. Right-click the Logic device and select Update Driver. Click "Browse my computer for driver software."

Click "Let me pick from a list of device drivers on my computer."

Next, it will ask you for the device type. Select "Universal Serial Bus Controllers."

This option is only present if no existing driver is installed. If a driver is already installed, this step will be skipped.

Now you will be presented with a window like shown below. Click the "Have Disk..." button.

This will open the install from the disk window, which will assume that you have inserted an installation disk into drive A with the drivers. Click browse, navigate to the drivers folder, which is detailed above under the section titled Location of Driver Files, and select Saleae.inf.

At this point, you should see either just the device you have connected or both Logic and Logic16. See below for details before selecting the device you are using.

If the checkbox for "Show compatible hardware" is checked, only 1 device should be shown. If it is not the correct device, then uncheck it to see all available Saleae drivers, as shown below.

These are all of the drivers that are included with the latest beta software, which you should see in the list when the checkbox for "Show compatible hardware" is not selected.

Saleae Logic 4 USB Logic Analyzer Saleae Logic 8 USB Logic Analyzer Saleae Logic Pro 16 USB Logic Analyzer Saleae Logic Pro 8 USB Logic Analyzer Saleae Logic Start USB Logic Analyzer Saleae Logic USB Logic Analyzer Saleae Logic 16 USB Logic Analyzer

There is some naming confusion here that I would like to clear up.

If you purchased the Logic 4, the Logic Pro 8, or the Logic Pro 16, please select the driver that matches the product name.

If you purchased the new Logic 8, our logic 8 channel logic analyzer with digital and analog, released in September 2014, please use the driver "Saleae Logic 8 USB Logic Analyzer" and NOT the driver "Saleae Logic USB Logic Analyzer." If you have the original Logic unit, 8 channel, digital only, discontinued in mid-2014, please select "Saleae Logic USB Logic Analyzer" and not the one with the number 8.

The original Logic 16, also discontinued in 2014, uses the "Saleae Logic 16 USB Logic Analyzer" driver and NOT the pro version.

Method 3: Uninstall and Reinstall Existing Logic Driver

When connecting Logic to the USB port and starting the Logic software, the Device Manager may show the device as "Logic Pro." This is incorrect, and may cause issues with operation. The solution is to uninstall and reinstall the Logic driver on the PC.

Solution steps if the device incorrectly appears as "Logic Pro" under Device Manager:

1. Close Logic software, but keep the Logic device connected to the PC

2. Open Device Manager

3. Right click "Logic Pro" in the Device Manager

4. Click "Uninstall device"

5. A window will popup indicating that you are about the uninstall the device from your system

6. Select the checkbox that says "Delete the driver software for this device"

7. Click "Uninstall"

8. Unplug and replug the Logic analyzer

9. Open the Logic Software. The Logic device should now connect to the Logic software.

Contacting Us for Further Support

• What OS and OS version you are using and if it is 32-bit or 64-bit.

• If the device has worked on this PC before.

• If the device has worked on other PCs before.

• Any information that may have been displayed when the drivers failed to install.

• How does the device show up under Device Manager?

• The driver install logs locations are described below.

  • On Windows, it should be located below:

    • C:\WINDOWS\INF\setupapi.dev.log

Linux Ubuntu Instructions

When the Logic 2 software is opened, a udev rule file is checked. If the udev rule is missing, then an error message will popup to prompt you to install the proper udev rule file. The good news is that, if you see this popup, then our software was able to detect the device. Follow the instructions to open the terminal and run the command to install the udev file.

Instructions:

1. Ensure the Logic app is running and your Logic analyzer is connected

2. Open terminal

3. Run the command below (replace "xxxxxx" with the characters shown in your "Install a udev rules" popup window)

4. Close the Logic app

5. Log out & log back in to your PC

6. Disconnect and reconnect your Logic analyzer

7. Open the Logic app

cat /tmp/.mount_Logic-xxxxxx/resources/linux/99-SaleaeLogic.rules | sudo tee /etc/udev/rules.d/99-SaleaeLogic.rules > /dev/null && echo "finished installing /etc/udev/rules.d/99-SaleaeLogic.rules"

Installing the udev Rule Manually

In case you run into any issues with installing the udev rule file using the command mentioned above, you can attempt to install it manually.

1. Download the udev rule file below.

1. Copy the file into the rules directory with the following command: sudo cp 99-SaleaeLogic.rules /etc/udev/rules.d

2. Verify that the rule file was installed with the following command: cat /etc/udev/rules.d/99-SaleaeLogic.rules

3. Close the Logic app

4. Log out & log back in to your PC

5. If your Logic analyzer was connected to your PC during this process, disconnect and reconnect your Logic analyzer

6. Open the Logic app

7. If at this point, the udev rule has still not installed properly, please disconnect your Logic device and restart your PC and test again afterwards.

There is no need to manage downloading firmware updates to Saleae Logic products. As long as the latest Logic software is used, your Logic hardware will continue to run on the latest firmware. You will only need to ensure you are running the latest version of the software, which can be downloaded below.

The Logic software downloads the firmware to the device every time it is connected to the PC as shown in the image below. Before this point, the Logic device is acting as a simple bootloader.

Before installing the software, please review the supported operating systems in the link below.

Ubuntu Instructions

The Logic 2 software is provided in an AppImage format, which contains all the files needed for the software to run. In Linux, you may need to allow executing the file as a program. To do this:

1. Right-click the AppImage file and click Properties 2. Check the box that says "Allow executing file as program" as shown in the image below.

3. Alternatively, you can run the following command to allow exectuing the file as a program.

chmod +x Logic-2.x.xx-master.AppImage

4. Once the file is allowed to execute as a program, simply double-click the AppImage file to launch the software, or run it from the command line.

./Logic-2.x.xx-master.AppImage

Issues with Running the AppImage File

Starting Ubuntu 24.04, you may need to run our app with the --no-sandbox argument like so. Otherwise, the app may fail to launch.

./Logic-2.x.xx-master.AppImage --no-sandbox

In other error cases (not common), you can attempt to extract the Logic binary from the AppImage file with the following command.

./Logic-2.x.xx-master.AppImage --appimage-extract

This will dump the contents to a new directory called squashfs. You can then try to run the Logic binary directly from there.

MacOS Instructions

Alternatively, you can also drag the Logic2 app file into your Applications folder in case you would like to have the app appear in Launchpad.

Windows Instructions

Install Errors

In case you run into any installation issues, please refer to the support article below.

The Saleae Logic software includes the following protocol analyzers:

• 1-Wire

• Asynchronous Serial

• Atmel SWI (Single Wire Interface)

• BISS-C

• CAN (Controller Area Network)

• DMX512

• HD44780 Parallel LCD

• HDLC (High-Level Data Link Control)

• HDMI-CEC

• I2C

• I2S Audio / PCM

• I3C (see section below)

• JTAG

• LIN (Local Interconnect Network)

• MDIO (Management Data Input/Output)

• MIDI

• Manchester (Differential, Bi-Phase Space, and Bi-Phase Mark)

• Modbus RTU & ASCII

• PS2 Keyboard & Mouse

• SMBus (includes PMBus and Smart Battery)

• SPI (Serial Peripheral Interface)

• SWD (ARM Serial Wire Debug)

• Synchronous Parallel

• USB Low Speed and Full Speed

• +50 More Commmunity Shared Protocols

I3C Protocol Analyzer (3rd Party)

We've worked closely with the team at Binho LLC to develop a 3rd party I3C Protocol Analyzer plugin for our Saleae Logic software! This plugin is developed by Binho LLC and will require a paid license to use it within our software. If you're interested in more details, please contact us here!

Analyzer User Guides

We provide user guides for a handful of our protocol analyzers, which we have listed in the link below.

More Protocol Analyzers

Some Logic users have created their own protocol analyzers. The following list of analyzers are available but not officially supported by Saleae.

Do all Saleae logic analyzer models support these protocols?

Yes. However, you will need to use a device with sufficient bandwidth to record the original signal. For instance, Logic 4 simply does not have the bandwidth required to capture and decode USB full speed. Logic 4 has a maximum digital bandwidth of 3 MHz, and USB full speed requires a digital bandwidth of at least 12.5 MHz.

What Happened to the UNI/O Analyzer?

Unfortunately, we have not yet ported the UNI/O analyzer from Logic v1 into the newer Logic v2 software. Specifically, it requires separate API functions that we simply haven't had the chance to implement yet. It's not on the roadmap at the moment, though we would like to gauge user interest in this before we commit to it, as porting this analyzer into Logic v2 would require quite a bit of work as compared to porting our other analyzers.

You can vote for this idea here.

Data Table

Overview

The analyzer data table shows all decoded protocol data in a table format. In general, the search functionality allows you to search for content in any column, except for the 'Start' and 'Duration' columns.

To learn more about the different columns that are used for Saleae's built-in analyzers, please refer to the support article below.

Excluding Analyzers and Columns

By clicking the 3 dots to the right of the search bar, a few options become available.

• Analyzers can be added or removed to exclude certain analyzers from search results and from appearing in the Data Table.

• The ability to exclude columns from search become available (while keeping them visible in the Data Table). This is useful for excluding columns that may otherwise pollute your search results, such as the 'Type' column, or boolean columns like 'ack' or 'read'.

Show/Hide Columns

The ability to hide columns altogether is available by right clicking the column label in the Data Table.

This also excludes them from the search results and is useful when there are too many columns to comfortably display.

Jumping to a Waveform Bubble from the Data Table

You can jump to a specific decoded bubble above the waveform from the data table by hovering your mouse over the data table row of interest. An "arrow" icon will appear to the right of the data table row while hovering over it. Click on the "arrow" icon to have the waveform view jump to the appropriate waveform bubble of interest.

Jumping to a Data Table Row from the Waveform

You can jump to a specific row in the data table by hovering your mouse over a decoded bubble above the waveform as shown in the image below. A keyboard shortcut (OS-specific) will appear to allow you to perform this action.

Display Radix Information

The new data table has a few different column types:

• Integer

• Double precision floating point

• Boolean

• String

• Byte array

Once an analyzer has been added, the user can change the display radix for that analyzer by right-clicking it in the analyzers panel in the sidebar.

The data table respects the users selected display radix. The display radix options are hexadecimal, ASCII, decimal, and binary. However, not all data types support each radix.

This list explains the supported radix of each data type.

Other Notes about the Data Table

• The data table respects your display radix selection for each analyzer, including high-level analyzers.

• When searching, matching cells will be highlighted, and the matching section of the contents will also be highlighted.

Limitations of the Data Table

Scrollbar Limitations

Currently, the contents of the data table are loaded dynamically depending on which section of the data table is currently in view. This approach has some drawbacks which are especially noticeable when navigating the data table with the scrollbar.

For example, dragging the scrollbar to the bottom will not immediately jump you to the end of the data table. Instead, new data table rows will be loaded dynamically, and the scrollbar position and size will adjust accordingly. Therefore, the scrollbar will not be scaled correctly with reference to the total count of data table rows.

Workarounds:

• The End and Home keys can be used to instantly jump to the end or beginning of the data table respectively.

• You can jump directly to a data table row from the waveform. Details on this are described in a section of this support article above.

In case this is something you'd like us to improve, please vote for this feature request!

Search Limitations

In most cases, you should be able to search for what you see in the table, just as you would search any other document, spreadsheet, or website. However, in order to improve performance of the search functionality, the search function has a few limitations.

In general, the search system is case-insensitive. If you would like to use case-sensitive search, please support this feature request.

Limitations:

• The 'Start' and 'Duration' columns can't be searched.

• when searching data shown in hexadecimal or binary, searching for a hex or binary number starting with '0x' or '0b' will force the search to match the beginning of the number. However, searching for '0', 'x', or '0x' by itself will not match the hex or binary prefix. This is a departure from the normal "search for what you see" functionality, but will eliminate accidental searches which may match with all rows of an analyzer.

• when searching a byte array data type (like MISO, MOSI, and many other analyzer result types) that are displayed in the ASCII display radix, you may see dot characters ('.') in positions where the data isn't a displayable ASCII character. These characters cannot be searched for. Only ASCII characters can be searched. For example, if a cell displays 'ab...yz' you can search for 'a', 'b', 'ab', 'y', 'z', and 'yz' to match it, but you can't search for 'ab...yz' because the dot ('.') characters are unmatchable.

The Data Table May Show Incorrect Values

When using low level analyzers (LLAs) such as our Async Serial or SPI analyzer, you may notice issues with how values appear in the data table, specifically while viewing results in decimal format. More information on this can be found in the support article below.

Terminal View

A terminal view is available by clicking the "Terminal" button at the top-right of the data table. This allows you to view your data in a terminal-like display format.

Limitations of Terminal View

Terminal Output is not in Time Order

Currently, our terminal view does not output results in time order if more than one analyzer is outputting data to the terminal. Instead, our terminal view will group the output results by analyzer. We've received requests for adding support for ensuring time order when using multple analyzers. Please feel free to share your feedback on this in the feature request post here: Feature Request - Terminal Messages to be Timeline Ordered

Scroll-back Limit

Our in-app terminal view has a scroll-back limit of 10,000 rows. Once the 10,000 row limit is reached, the oldest rows are deleted. However, starting version 2.4.4, we added an experimental environment variable override to specify longer terminal scrollback limits.

• set SALEAE_SCROLLBACK_LIMIT=1000000 for Windows

• export SALEAE_SCROLLBACK_LIMIT=1000000 for MacOS and Linux

Radix Display within the Terminal

• Async Serial & Manchester - will always attempt to display in ASCII format. If the ASCII opcode doesn't exist, then it will be displayed in hex, separated by backslashes (\) as shown below. Notice that the first set of opcodes (0 to 0x1F) do not exist and are therefore displayed as hex. As the opcode increments and become valid, ASCII characters are displayed.

• I2C - will display addresses and data, as well as read/write status, as shown below.

• SPI - will display in hex in the format MOSI / MISO .

• For all other analyzers - content will be displayed as shown in the data table.

Terminal RefIow issue when Panel is Resized

This only affects the last line in the terminal, and is noticeable when resizing the side panel.

For Async Serial - The last line will not text wrap properly. The last line is considered as the final stretch of data preceded by a new line or carraige return. For I2C or SPI - the last line is considered after the end of a previous transaction, and will not properly reflow when the side panel is resized. SPI data looks like it completely disappears.

We use xtermjs for our in-app terminal. According to the xtermjs GitHub issue link below, this seems to be a bug that only affects the last line of text.

If you're running into this issue, please vote/comment on our idea post here, which we are using to track this bug.

Terminal Text Seems to be Missing

Our intention was for the terminal to respond appropriately to '\r' (CR, carriage return) and '\n' (LF, line feed) when encountered in the serial analyzer data, to help make the terminal work like a serial terminal. Having said that, serial data that only outputs '\r', but not '\n', will cause terminal text to get deleted since the missing '\n' is not moving the cursor one line forward.

To work around this in the meantime, we have released an extension via our Extensions Marketplace called "Carriage Return to Line Feed Converter."

Logic 1.x User Guide (PDF Format)

A PDF version of the Legacy Logic 1.x User Guide is available to download below.

Changes in 1.2.40:

1. Adds support for revision 3.0.0 Logic hardware. More information on hardware revisions can be found in the link below.

2. Remove support for Decoded Protocols panel / table due to technical issues. You will notice that the checkbox for it is grayed out under Preferences > Capture.

Changes in 1.2.29 Beta:

1. New calibration filter implementation, should speed up analog processing by about 2.5x

2. Fixed bug in auto-update system

3. Fixed bug in the analyzer minimum sample rate warning systeAbout Real-Time Display (versions 1.2.23 - 1.2.29)

Changes in 1.2.28 Beta:

1. Increased USB failure logging

2. Minor changes

Changes in 1.2.27 Beta:

Bug Fixes:

1. rolled out auto-update for MacOS and Linux

2. JTAG analyzer no longer crashes the software for extremely long Shift IR/DR sequences, usually from FPGA bitstreams.

Changes in 1.2.26 Beta:

New Features:

1. Improved software update process for Windows. (Mac and Linux coming soon)

2. Internal - finished test coverage of features in last release.

Bug Fixes:

1. Fixed crash bug caused by starting the software with a Logic Pro 8 or Pro 16 connected over USB 2.0.

Changes in 1.2.25 Beta:

New Features:

1. Added Async RGB Led Analyzer. (supports single-wire LED protocols - WS2811, WS2812B, WS2813, TM1809, TM1804, UCS1903, LPD1886. Feedback welcome!)

2. made it easier to drag analog channels

3. made vertical scrollbars more visible in 4 areas

Bug Fixes:

1. fixed issue with editing units for the trigger pulse width and for the glitch filter.

Changes in 1.2.24 Beta:

New features:

1. The UI is now responsive during the capture. However, analyzers cannot be edited during a capture, and the options menu is disabled.

2. Protocol search now works during the capture (if a trigger is used, protocol processing starts when the trigger is found)

Changes in 1.2.23 Beta:

New Features:

1. Data is now displayed live pre-trigger

2. Added "Skip Trigger" feature, which lets the user manually trigger a capture.

3. Changed software defaults to be more useful

Bug Fixes:

1. dialogs and popovers should now work with tiling window managers on Linux.

2. Modbus analyzer issue would cause garbage strings, fixed.

3. Fixed bug in data_export2 socket command regarding binary exports.

Known Issues:

1. After a capture is complete, the annotations sidebar is inconveniently scrolled

2. stop_capture socket command not working in the beta branch currently.

3. If a Pro 16 is connected over USB 2.0, the software can crash under certain circumstances. This is fixed internally and should be fixed in 1.2.25.

Changes in 1.2.22 Beta:

Bug Fixes:

1. Fixed crash introduced in last version when the device 'could not keep up'.

2. Fixed crash where pressing Ctrl+R during the capture would crash the software.

Changes in 1.2.21 Beta:

New Features:

1. Converted the capture progress dialog from a modal dialog into a sidebar panel.

2. During captures, the start button now becomes a cancel/stop button.

3. During captures, the live stripchat view now supports zooming in and out. Pan position is fixed to the latest data.

Bug Fixes:

1. Fixed trigger crash caused by setting the pre-trigger buffer to zero samples.

2. Fixed crash bug in graph rendering that held up stripchart zoom.

Changes in 1.2.20 Beta:

Bug Fixes:

1. Analog values in CSV exports have the correct display precision.

2. Analog values exported as ADC samples (integers) no longer have decimal points.

3. Crash bug fixed in MATLAB export, the software would crash if the starting sample index was larger than an unsigned 32 bit integer. Affected captures where considerable time passed before the trigger was detected.

4. -disablepopups command line argument now works properly on Linux and MacOS.

5. Crash bug fixed in pulse width trigger, which could crash pulses that spanned multiple USB data transfers. Bonus, the trigger is now covered with unit tests! This was a long time coming.

Changes in 1.2.19 Beta:

New Features:

1. First release of basic stripchart display. This keeps the latest 5 seconds of capture on the display during the recording. This is a minimal version of the new feature, and does not yet support changing the zoom level.

Changes in 1.2.18:

Bug Fixes:

1. Fixed crash issue when simulating the parallel analyzer with Logic 4.

2. Fixed clock reset problem with Logic 8, introduced in 1.2.15. For some customers, the Logic 8 was unable to record digital data under specific situation.

New Features:

1. Added ability to cancel a save capture operation in progress by pressing escape.

2. Added 3 new socket API functions: GET_CAPTURE_RANGE, GET_VIEWSTATE, SET_VIEWSTATE

Changes in 1.2.17:

Bug Fixes:

1. Fixed crash bug affecting the capture settings. Software would crash if only Analog channels are enabled and the capture duration was specified in samples, not in seconds or milliseconds.

Changes in 1.2.16:

Improvements:

1. Increased device throughput for all Logic Pro devices via Firmware & FPGA update. All Pro 8s and Pro 16s ever shipped support the higher throughout.

2. Added new Sample rates via FPGA update. Pro devices now support sampling at 250 MS/s and 125 MS/s. All Pro devices ever shipped support this.

   This supports:

3. 6 channels @ 500 MS/s. (previously 4 channels)

4. 12 channels @ 250 MS/s. (250 MS/s was not previously available)

5. All 16 channels @ 125 MS/s (previously limited to 100 MS/s)

6. The Logic Pro 8 can run all 8 channels at 250 MS/s, previously limited to 100 MS/s.

Bug Fixes:

1. Fixed issue with memory usage estimator - when specifying the duration of the capture in samples, instead of time, when both analog and digital channels were enabled, the estimated memory usage was considerably higher than reality.

Known Issues:

1. The higher throughput of the Pro devices changes the available sample rates for each given performance level. This may cause issues with saved setup files, and users of the socket automation API who have hardcoded the selected sample rate and performance option. This only affects captures with both analog and digital channels enabled at the same time. This should result in saved setup files failing to apply the saved sample rate settings, but other applicable settings will still load. The socket command set_sample_rate will NAK for sample rates that are not listed in get_all_sample_rates.

Changes in 1.2.15:

Improvements:

1. Support for Logic 8, Logic Pro 8 and Logic Pro 16 Revision 2 PCBs (incremental component change, no new capabilities)

2. Modbus Analyzer - added support for no parity bit and one stop bit

3. LIN Analyzer - raised max bitrate for special applications to 1 mbps

4. Added the full path to calibration files to the preferences dialog

Bug Fixes:

1. 1-Wire Analyzer did not return to normal speed from overdrive after a full length reset

2. Analyzer core - fixed bug in ConvertToSignedNumber that broke down for 32 bit or wider sgined words (I2S analyzer was affected)

3. Instantaneous measurement settings were not completely saved due to serialization issue

4. HDLC Analyzer - issue with CRCs and escape bytes fixed

5. Export bugs fixed when exporting digital data from a mixed-mode capture, when the LCM of the analog and digital sample rates was larger than the digital sample rate. CSV and binary export modes affected, timestamps and sample numbers.