seqs

séquences

seqs est ce que l'on appelle communément une implémentation IP en espace utilisateur. Il gère :

• Protocole Ethernet
• Marshaling de paquets IP vers des sous-protocoles :
  • Requêtes et réponses ARP
  • Gestion des paquets UDP
  • Requêtes client DHCP et serveur DHCP
  • Connexions TCP sur IP avec prise en charge de plusieurs écouteurs sur le même port. Ceux-ci implémentent les interfaces net.Conn et net.Listener. Voir stacks/tcpconn.go
  • HTTP : algorithme pour réutiliser la mémoire tas entre les requêtes et éviter les allocations. Voir le package httpx
  • Client NTP pour résoudre le décalage horaire vers un serveur NTP

Exemple d'utilisation

 // stack works by having access to Ethernet packet sending
// and processing. NIC is our physical link to the internet.
var NIC NetworkInterfaceCard = getNIC ()

stack := stacks . NewPortStack (stacks. PortStackConfig {
    MAC :             MAC ,
    MaxOpenPortsTCP : 1 ,
    MaxOpenPortsUDP : 1 ,
    MTU :             2048 ,
})
// stack.RecvEth should be called on receiving an ethernet packet. It should NOT block.
NIC . SetRecvEthHandle ( stack . RecvEth )

// Static IP setting.
ip := netip . AddrFrom4 ([ 4 ] byte { 192 , 168 , 1 , 45 }) 
stack . SetAddr ( ip )

// Or can request an address via DHCP.
dhcpClient := stacks . NewDHCPClient ( stack , dhcp . DefaultClientPort )
err = dhcpClient . BeginRequest (stacks. DHCPRequestConfig {
    RequestedAddr : netip . AddrFrom4 ([ 4 ] byte { 192 , 168 , 1 , 69 }),
    Xid :           0x12345678 ,
    Hostname :      "tinygo-pico" ,
})
if err != nil {
    panic ( err )
}

fmt . Println ( "Start DHCP..." )
for ! dhcpClient . Done () {
    doNICPoll ( NIC )
    time . Sleep ( time . Second / 10 )
}

offeredIP := dhcpClient . Offer ()
fmt . Println ( "got offer:" , offeredIP )
stack . SetAddr ( offeredIP )

Comment utiliser seqs

go mod download github.com/soypat/seqs@latest

Histoire - Précurseurs des séquences

Avant seqs il y avait :

• ether-swtch - Première instance connue d'une pile TCP/IP (à peine) fonctionnelle dans Go fonctionnant sur des systèmes embarqués, vers juin 2021. Pourrait faire clignoter la LED d'un Arduino UNO via HTTP (!). Conception, code, performances et lisibilité notoirement mauvais.
• dgrams - Bibliothèque préparée pour la puce wifi de Pico W. Montre déjà des similitudes avec seqs . Vers mai 2023.