feat: filter boards by fqbn in connected list

Author: Luca Bianconi

commands/board/list.go

@@ -205,6 +205,15 @@ func List(req *rpc.BoardListRequest) (r []*rpc.DetectedPort, discoveryStartError
 	}
 	defer release()
 
+	var requestedFqbn *cores.FQBN
+	if f := req.GetFqbn(); f != "" {
+		var err error
+		requestedFqbn, err = cores.ParseFQBN(f)
+		if err != nil {
+			return nil, nil, &arduino.InvalidFQBNError{Cause: err}
+		}
+	}
+
 	dm := pme.DiscoveryManager()
 	discoveryStartErrors = dm.Start()
 	time.Sleep(time.Duration(req.GetTimeout()) * time.Millisecond)
@@ -222,11 +231,23 @@ func List(req *rpc.BoardListRequest) (r []*rpc.DetectedPort, discoveryStartError
 			Port:           port.ToRPC(),
 			MatchingBoards: boards,
 		}
-		retVal = append(retVal, b)
+
+		if requestedFqbn == nil || hasMatchingBoard(b, requestedFqbn) {
+			retVal = append(retVal, b)
+		}
 	}
 	return retVal, discoveryStartErrors, nil
 }
 
+func hasMatchingBoard(b *rpc.DetectedPort, requestedFqbn *cores.FQBN) bool {
+	for _, detectedBoard := range b.MatchingBoards {
+		if detectedBoard.Fqbn == requestedFqbn.String() {
+			return true
+		}
+	}
+	return false
+}
+
 // Watch returns a channel that receives boards connection and disconnection events.
 // It also returns a callback function that must be used to stop and dispose the watch.
 func Watch(req *rpc.BoardListWatchRequest) (<-chan *rpc.BoardListWatchResponse, func(), error) {

internal/cli/board/list.go

@@ -47,6 +47,7 @@ func initListCommand() *cobra.Command {
 	}
 
 	timeoutArg.AddToCommand(listCommand)
+	fqbn.AddToCommand(listCommand)
 	listCommand.Flags().BoolVarP(&watch, "watch", "w", false, tr("Command keeps running and prints list of connected boards whenever there is a change."))
 
 	return listCommand
@@ -66,6 +67,7 @@ func runListCommand(cmd *cobra.Command, args []string) {
 	ports, discvoeryErrors, err := board.List(&rpc.BoardListRequest{
 		Instance: inst,
 		Timeout:  timeoutArg.Get().Milliseconds(),
+		Fqbn:     fqbn.String(),
 	})
 	if err != nil {
 		feedback.Warning(tr("Error detecting boards: %v", err))

rpc/cc/arduino/cli/commands/v1/board.pb.go

@@ -152,6 +152,9 @@ message BoardListRequest {
   Instance instance = 1;
   // Search for boards for the given time (in milliseconds)
   int64 timeout = 2;
+  // The fully qualified board name of the board you want information about
+  // (e.g., `arduino:avr:uno`).
+  string fqbn = 3;
 }
 
 message BoardListResponse {