seqs

sequências

seqs é o que é comumente chamado de implementação de IP do espaço do usuário. Ele lida com:

• Protocolo Ethernet
• Organização de pacotes IP para subprotocolos:
  • Solicitações e respostas ARP
  • Manipulação de pacotes UDP
  • Solicitações de cliente DHCP e servidor DHCP
  • Conexões TCP sobre IP com suporte para vários ouvintes na mesma porta. Eles implementam interfaces net.Conn e net.Listener. Veja stacks/tcpconn.go
  • HTTP: Algoritmo para reutilizar memória heap entre solicitações e evitar alocações. Veja o pacote httpx
  • Cliente NTP para resolver o deslocamento de tempo para um servidor NTP

Exemplo de uso

 // 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 )

Como usar seqs

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

História - Precursores de seqs

Antes seqs havia:

• ether-swtch - Primeira instância conhecida de uma pilha TCP/IP (quase) funcional em Go trabalhando em sistemas embarcados, por volta de junho de 2021. Poderia piscar o LED de um Arduino UNO via HTTP (!). Design, código, desempenho e legibilidade notoriamente ruins.
• dgrams - Biblioteca preparada para o chip wifi do Pico W. Já mostra semelhanças com seqs . Por volta de maio de 2023.