Author Topic: C# API Plus  (Read 9414 times)

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
C# API Plus
« on: April 23, 2017, 18:12:07 »
Hallo zusammen,

ich bin ein großer Fan des Tinkerforge Baukastensystems. Außerdem programmiere ich fast ausschließlich in C#. Leider finde ich die C# API nicht besonders komfortabel, was wie ich denke auf die vielen Methoden mit „out“-Parametren zurückzuführen ist. Microsoft bzw. das C# Team haben das erkannt und mit .net 4.7 und C# Version 7 (Windows 10 Creators Update) das Problem behoben.
 
Daher möchte ich nun hier meine C# Plugin für .net 4.7 vorstellen. Diese Erweiterung fügt für alle Methoden aus der Tinkerfoge API für .net eine Methoden-Überschreibung hinzu. Es handelt sich um keine neue API sondern um eine API-Erweiterung. Es wird weiterhin die Basis-DLL benötigt.

Beispiel für C#:

Code: [Select]
var ipcon = new IPConnection(); // Create IP connection
var io = new BrickletIO4("h2R", ipcon); // Create device object
ipcon.Connect("localhost", 4223); // Connect to brickd

//Old Style
io.GetMonoflop(0, out byte value, out long time, out long timeRemaining);
Console.WriteLine("Remaining time: " + timeRemaining);

//New Style           
Console.WriteLine("Remaining time: " + io.GetMonoflop(0).TimeRemaining);
           
ipcon.Disconnect();
Console.WriteLine("Press enter to exit...");
Console.ReadKey();

Beispiel VB.net:

Code: [Select]
Dim ipcon = New IPConnection
Dim io = New BrickletIO4("h2R", ipcon) ' Create device object
ipcon.Connect("localhost", 4223) ' Connect to brickd

'Old Style
Dim value As Byte
Dim time As Long
Dim timeRemaining As Long
io.GetMonoflop(0, value:=value, time:=time, timeRemaining:=timeRemaining)
Console.WriteLine("Remaining time: " + timeRemaining.ToString())

'New Style           
Console.WriteLine("Remaining time: " + io.GetMonoflop(0).TimeRemaining.ToString())


ipcon.Disconnect()
Console.WriteLine("Press enter to exit...")
Console.ReadKey()

Ich kenne mich leider mit Mono nicht aus, daher kann ich nicht sagen, ob das kompatibel ist.

Fragen und Kommentare sind willkommen! :)

borg

  • Tinkerforge Staff
  • Administrator
  • Hero Member
  • *****
  • Posts: 3.142
    • View Profile
Re: C# API Plus
« Reply #1 on: April 26, 2017, 11:18:30 »
Sieht sehr gut aus!

Wir brechen nur sehr ungern die API, deswegen ist es für uns immer schwer solche Sprachverbesserungen im Nachhinein umzusetzen.
Wir sind die Borg, Widerstand ist Spannung durch Stromstärke!

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
Re: C# API Plus
« Reply #2 on: April 30, 2017, 17:33:41 »
Ist nun auch auf NuGet verfügbar: https://www.nuget.org/packages/Tinkerforge.Tuple/

Regelmäßige Updates, wenn es API Erweiterungen gibt, sind geplant.

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
Re: C# API Plus
« Reply #3 on: May 14, 2017, 19:44:25 »
Version 1.1 veröffentlicht für GPS Bricklet 2.0.

https://www.nuget.org/packages/Tinkerforge.Tuple/

Grimsey

  • Newbie
  • *
  • Posts: 4
    • View Profile
Re: C# API Plus
« Reply #4 on: May 23, 2017, 15:11:41 »
Gehe ich richtig in der Annahme, dass man dafür jetzt zwingend Visual Studio 2017 benötigt?
Ich habe die 2015er Community-Version, habe auch das .net-Framework 4.7 installiert (Betriebssystem ist Windows 7) aber ich kann das Zielframework nicht auf die Version 4.7 ändern. Es wird in der Dropdownliste nicht angezeigt.

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
Re: C# API Plus
« Reply #5 on: May 23, 2017, 18:43:16 »
Also bei mir funktioniert das auch mit VS2015 allerdings unter Windows 10.

Ansonsten ist .NET 4.7 zum Download hier erhältlich: https://blogs.msdn.microsoft.com/dotnet/2017/05/02/announcing-the-net-framework-4-7-general-availability/

Grimsey

  • Newbie
  • *
  • Posts: 4
    • View Profile
Re: C# API Plus
« Reply #6 on: May 24, 2017, 08:19:19 »
Hallo Fabio,

danke für Deine Antwort.
Ich habe das .Net-Framework 4.7 ja bereits installiert, aber es steht mir für eine Auswahl dennoch nicht zur Verfügung.

Danke Dir dennoch!

Grimsey

  • Newbie
  • *
  • Posts: 4
    • View Profile
Re: C# API Plus
« Reply #7 on: May 24, 2017, 09:44:29 »
Habs auch endlich hinbekommen. Gibt für den Download nochmal eine Auswahl für welche VisualStudio Version man es herunterladen will. Da hatte ich offensichtlich nicht das richtige.

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
Re: C# API Plus
« Reply #8 on: August 08, 2017, 19:48:30 »
Version 1.2 veröffentlicht:
  • Unterstützung für RS485 Bricklet
NuGet: https://www.nuget.org/packages/Tinkerforge.Tuple/
« Last Edit: August 08, 2017, 19:50:54 by Fabio »

tatzemax

  • Jr. Member
  • **
  • Posts: 69
  • Gelernter Elektroniker [C#]
    • View Profile
Re: C# API Plus
« Reply #9 on: March 07, 2018, 02:07:50 »
Vielleicht kann TF einen hinweis in der Doku zu dieser Erweiterung hinterlegen

Fabio

  • Newbie
  • *
  • Posts: 11
    • View Profile
Re: C# API Plus
« Reply #10 on: March 23, 2018, 18:10:33 »
Update 1.3
Unterstützung für folgende Bricklet´s wurde ergänzt:

-Remote Switch Bricklet 2.0
-Motion Detector Bricklet 2.0
-Analog In Bricklet 3.0
-NFC Bricklet
-Temperature IR Bricklet 2.0
-Rotary Encoder Bricklet 2.0
-Solid State Relay Bricklet 2.0
-Outdoor Weather Bricklet
-DMX Bricklet, Humidity Bricklet 2.0
-Motorized Linear Poti Bricklet
-RGB LED Button Bricklet
-RGB LED Matrix Bricklet
-Thermal Imaging Bricklet
« Last Edit: March 23, 2018, 18:20:35 by Fabio »

stevehayles

  • Newbie
  • *
  • Posts: 14
    • View Profile
Re: C# API Plus
« Reply #11 on: January 29, 2019, 18:04:20 »
Hi,

Not sure if this package is being maintained.  Please see https://www.tinkerunity.org/forum/index.php/topic,4748.0.html for another option with Async/Await support and other additional features