Arduino networking API guide for networking library developers

[Juraj Andrássy]

Hello

I wrote a Arduino networking API guide for networking library developers. As part of the research I analyzed  dozen of significant networking libraries for Arduino.

Both documents are in a GitHub repository in md format so it is possible to use Issues, Pull Requests and Discussions to collaborate on the API documentation, clarifications and design decisions.

The repo is https://github.com/JAndrassy/Arduino-Networking-API

Juraj Andrassy

[Alessandro Ranellucci]

Juraj - that is fantastic work!

We very much need to work on aligning the networking API across different cores, and on the Arduino side we're open to support this as much as we can.

An idea we were considering lately was to add documentation for WiFi in the language reference website:

https://www.arduino.cc/reference/en/
but that requires of course that at least a subset of the API is standard.

Ideally, #include <WiFi.h> shall work out of the box on any platform (just like SPI or Wire) instead of having all the various WiFiNINA.h, ESP8266WiFi.h etc.

Also, a few months ago I generated this comparison of WiFi API which complements your work:

https://github.com/alranel/arduino-api-comparehttps://github.com/alranel/arduino-api-compare

Who's in? :)

 - Alessandro

--

You received this message because you are subscribed to the Google Groups "Developers" group.

To unsubscribe from this group and stop receiving emails from it, send an email to developers+...@arduino.cc.

To view this discussion on the web visit https://groups.google.com/a/arduino.cc/d/msgid/developers/39857876-d8e2-4081-abdf-15e10591a926n%40arduino.cc.

Privacy and Confidentiality Notice: This email and all attachments are confidential and for the designated recipient(s) only. They may also be privileged. If you are not the intended recipient or among the intended recipients, you may not use, read, retransmit, disseminate, store/copy the information in any medium or take any action in reliance upon it. Please notify the sender that you have received it in error and immediately delete the entire communication, including any attachments.

[kpe...@blinksoft.com]

Great work and I agree.

To view this discussion on the web visit https://groups.google.com/a/arduino.cc/d/msgid/developers/860FD893-7687-48C1-8B37-A97B4B51AD0E%40getmailspring.com.

[Juraj Andrássy]

Alessandro, Hello. 

your repository is private.

To unify the API I already made more than 25 PR and wrote some issues and opened some discussions in GitHub repositories . They are all linked in the library comparison tables in ArduinoNetAPILibs.md. A few are already merged or solved.

JA

To view this discussion on the web visit https://groups.google.com/a/arduino.cc/d/msgid/developers/860FD893-7687-48C1-8B37-A97B4B51AD0E%40getmailspring.com.

[Juraj Andrássy]

sorry the repository works. the link was wrong

[Juraj Andrássy]

Discussion about server.accept(): https://github.com/JAndrassy/Arduino-Networking-API/discussions/2

Dátum: utorok 17. októbra 2023, čas: 13:32:10 UTC+2, odosielateľ: Juraj Andrássy

[Tom Igoe]

Sorry to be so long in replying to this. 

This is a good analysis, thank you. In general it seems very faithful to the original Ethernet and WiFi cores, which I think is a good thing. I am particularly glad to see the inclusion of getTime(), which I think is one of the best additions to the WiFi core and very useful in many applications. Also, the use of Printable and Stream in these libraries can simplify a lot, so I'm glad to see those mentioned too. 

For what it's worth, I have a bunch of examples I've written on the WiFi101/WiFiNINA cores that I use as tests on new variations in this repo: https://tigoe.github.io/Wifi_examples/. I also have some MQTT examples here: https://tigoe.github.io/mqtt-examples/ Some of them may be useful as tests for a general core.

Tom

To view this discussion on the web visit https://groups.google.com/a/arduino.cc/d/msgid/developers/cfbb794c-57db-421f-9a73-4b43001932a6n%40arduino.cc.

[Juraj Andrássy]

Hello Mr. Igoe

sorry, I am only reading your message now. I guess I missed the notification.

I wrote my own tests last week and run them on many libraries, on versions with all my pull requests merged.

Here is the Report https://github.com/JAndrassy/Arduino-Networking-API/blob/main/ArduinoNetLibsTestReport.md

It is still work in progress as library maintainers merge my PR and I make new PR. We are slowly getting to compatible libraries.

Would it be possible for Arduino to allocate some time for developers in  Martino Facchin's team to look at my PR in Arduino networking libraries repositories. At least for the new libraries in the Renesas Core.  And the documentation for the new WiFi libraries would be good to have. (Unified WiFi documentation would be ideal.)

  

The big picture is here https://github.com/JAndrassy/Arduino-Networking-API/blob/main/ArduinoNetAPILibs.md

Juraj

Dátum: pondelok 30. októbra 2023, čas: 18:37:40 UTC+1, odosielateľ: t.igoe

[Tom Igoe]

I'll defer to Martino on the PRs (hi Martino), but looking over your latest report, the changes in WiFi101, WIFiNINA, and WIFiS3 all seem like useful changes to me, so I'd endorse them. The ordering of the addresses, in particular, seems like it should be standardized.  

I can't comment on the other libraries as knowledgeably, because I haven't used them as much as the three I mentioned. But I'd suspect that the ESP-based libraries are more of a challenge, if we want to maintain compatibility with ESP's libraries. It might be a question for the maintainers of those libraries. Martino and the Pro team can probably say more there. 

[Juraj Andrássy]

the esp8266 and esp32 maintainers a cooperative. I have already multiple PR merged or at least approved there this week.

In esp8266 the ordering of addresses in `config` is OK. Their detection of the ordering based on the location of the network mask works good. 

Later I want to try to forward that solution to esp32 WiFi library.

Dátum: piatok 10. novembra 2023, čas: 13:22:40 UTC+1, odosielateľ: t.igoe

[Juraj Andrássy]

you meant the reverse ordering of the bytes in `macAddress` and both `BSSID` in Arduino WiFi libraries?

yes, that is a problem.

if I had to say how to solve it, I would recommend to change it to normal ordering in all Arduino WiFi libraries and their examples. 

or at least as soon as possible in the very new libraries WiFiS3 and WiFiC3 in the Renesas core.

Dátum: piatok 10. novembra 2023, čas: 13:42:41 UTC+1, odosielateľ: Juraj Andrássy