seqs

シーケンス

seqs一般にユーザー空間 IP 実装と呼ばれるものです。それは以下を処理します:

• イーサネットプロトコル
• サブプロトコルへの IP パケットのマーシャリング:
  • ARPリクエストとレスポンス
  • UDPパケットの処理
  • DHCP クライアント要求と DHCP サーバー
  • 同じポート上の複数のリスナーをサポートする IP 経由の TCP 接続。これらは net.Conn インターフェイスと net.Listener インターフェイスを実装します。 stacks/tcpconn.go参照してください。
  • HTTP: リクエスト間でヒープ メモリを再利用し、割り当てを回避するアルゴリズム。 httpxパッケージを参照
  • NTP サーバーへの時間オフセットを解決するための NTP クライアント

使用例

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

seqsの使い方

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

歴史 - seq の前身

seqsの前には次のものがありました。

• ether-swtch - 2021 年 6 月頃、組み込みシステム上で Go で (かろうじて) 動作している TCP/IP スタックの最初に確認されたインスタンス。HTTP 経由で Arduino UNO の LED を点滅させることができました (!)。デザイン、コード、パフォーマンス、読みやすさが悪いことで有名です。
• dgrams - Pico W の Wi-Fi チップ用に用意されたライブラリ。すでにseqsとの類似点が示されています。 2023 年 5 月頃。