nanoFramework.Iot.Device.Tlc1543 1.2.436

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
dotnet add package nanoFramework.Iot.Device.Tlc1543 --version 1.2.436
NuGet\Install-Package nanoFramework.Iot.Device.Tlc1543 -Version 1.2.436
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Iot.Device.Tlc1543" Version="1.2.436" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Tlc1543 --version 1.2.436
#r "nuget: nanoFramework.Iot.Device.Tlc1543, 1.2.436"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.Iot.Device.Tlc1543 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Tlc1543&version=1.2.436

// Install nanoFramework.Iot.Device.Tlc1543 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Tlc1543&version=1.2.436

TLC1543 - 10-bit ADC with 11 input channels

High-speed 10-bit switched-capacitor successive-approximation A/D Converter with 14 channels (11 inputs and 3 self-test channels)

Documentation

Usage

Simple Line finding algorithm with ADC usage

This sample shows how to calculate position of line under matrix of 5 IR sensors with the help of TLC1543 ADC. In this case it's AlphaBot2 Pi from WaveShare with ITR-20001 IR sensors.

Initialization

SpiDevice spi = SpiDevice.Create(new SpiConnectionSettings(1, 5) { DataBitLength = Tlc1543.SpiDataBitLength });

Changing Charge Channel

adc.ReadPreviousAndChargeChannel(channels[0]);

You can set ChargeChannel to one of the Self Test channels (if you really know what you're doing you can also set it to one of the normal channels - but remember that this may amplify noise going from one channel to the other) if you know exactly what range of values you're expecting on polled channels (less interference on channels with fast changing but weak signals). Default set for SelfTest512 as that's the middle of 10 bit range.

Getting data

int values = adc.ReadPreviousAndChargeChannel(channels[0]);

Simple way of reading values into just made list.

Calculating position

for (int i = 0; i < values.Count; i++)
{
    if (values[i] < 300)
    {
        lineAverage += (i - 2);
        onLine++;
    }
}

To find where under our matrix is line we need to check values given out from sensors depending on where they are pointing.

  • Pointing at sky gives us values ranging from 0 to 50
  • Keeping it close to white paper gives values bigger than 600
  • Placing it pointed at black tape - taped on white paper(for contrast) gives values ranging from 150 to 250 on sensor exactly above line

So to simplfy things we assume that when we run this program we won't be pointing our sensor matrix at the sky and we will keep it at a flat surface.

Next thing is to calculate average from sensors for when there are more than one sensors seeing line.

For example when first and second sensor sees line values will be

  • on first loop lineAverage = -2 and onLine = 1;
  • on second loop lineAverage = -3 and onLine = 2;

And now with this data we can calculate linePosition

double linePosition = ((double)lineAverage / (double)onLine);

linePosition = -1.5

and we now know that the line is somewhere between first and second sensor. By using (i - 2) in our loop we moved values that the third sensor now indicates middle of the matrix, values less than zero are left from the middle and values above are on the right side. If we would have seven sensor matrix we would move those values by 3. Nine sensors? Move it by 4 - simple as that.

Binding Notes

Only mode implemented is Fast Mode 1 (10 clocks and !ChipSelect high between conversion cycles). Respective timing diagram can be seen on figure 9 in datasheet.

It is possible to change ADC charge channel.

adc.ReadPreviousAndChargeChannel(channels[0]);

Using EndOfConversion mode is not yet supported.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.436 211 11/10/2023
1.2.416 95 11/8/2023
1.2.329 129 5/26/2023
1.2.313 113 5/12/2023
1.2.297 119 5/3/2023
1.2.208 260 1/3/2023
1.2.203 263 12/28/2022
1.2.159 329 11/14/2022
1.2.153 330 11/5/2022
1.2.141 357 10/25/2022
1.2.128 362 10/22/2022
1.2.122 399 10/12/2022
1.2.114 354 10/8/2022
1.2.95 389 9/22/2022
1.2.87 433 9/15/2022
1.2.73 374 9/8/2022
1.2.5 413 7/13/2022
1.1.141.41205 404 7/6/2022
1.1.118.19693 412 6/24/2022
1.1.116.8772 389 6/24/2022
1.1.113.2032 379 6/23/2022
1.1.27 407 4/26/2022
1.1.20 410 4/21/2022
1.1.3 414 4/15/2022
1.1.1 403 4/14/2022
1.0.7-preview.114 110 3/25/2022
1.0.7-preview.113 107 3/25/2022
1.0.7-preview.100 97 3/19/2022
1.0.7-preview.99 111 3/18/2022
1.0.7-preview.94 108 3/15/2022
1.0.7-preview.87 108 3/10/2022
1.0.7-preview.73 108 2/25/2022
1.0.7-preview.48 119 2/4/2022
1.0.7-preview.42 118 1/31/2022
1.0.7-preview.41 124 1/31/2022
1.0.7-preview.22 118 1/27/2022
1.0.7-preview.20 120 1/27/2022
1.0.7-preview.18 123 1/27/2022
1.0.1 433 1/17/2022