Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

sdwire

package module

Go to main page

Versions in this module

v0

v0.3.0

Sep 2, 2026

Changes in this version

type DeviceInfo

+ func Revive(selector string, opts ...Option) (DeviceInfo, error)

+ type DeviceState struct

+ Attached bool

+ Info DeviceInfo

+ Mode SwitchMode

+ func ListDeviceStates(opts ...Option) ([]DeviceState, error)

type FlashOption

+ func WithWriteRetries(n int) FlashOption

+ func WithWriteTiming(fn func(offset int64, size int, took time.Duration)) FlashOption

v0.2.0

Aug 12, 2026

v0.1.1

Aug 8, 2026

Changes in this version

+ const DefaultMinDarkTime

+ const SDWire3PID

+ const SDWire3VID

+ const SDWireCPID

+ const SDWireCProductName

+ const SDWireCVID

+ var ErrNoDeviceFound = errors.New("no matching SDWire device found")

+ type DeviceController interface

+ Close func() error

+ Mode func() (SwitchMode, error)

+ SetMode func(mode SwitchMode) error

+ type DeviceGeneration int

+ const GenerationSDWire3

+ const GenerationSDWireC

+ func (g DeviceGeneration) String() string

+ type DeviceInfo struct

+ Bus int

+ Generation DeviceGeneration

+ Manufacturer string

+ PortPath []int

+ Product string

+ Serial string

+ func ListDevices() ([]*DeviceInfo, error)

+ func (d DeviceInfo) Identity() string

+ func (d DeviceInfo) Location() string

+ type FlashOption func(*flashOptions)

+ func WithBlockDevTimeout(d time.Duration) FlashOption

+ func WithFlashMinDarkTime(d time.Duration) FlashOption

+ func WithFlashProgress(fn func(written, total int64)) FlashOption

+ func WithMaxDeviceSize(bytes int64) FlashOption

+ type ModeOption func(*modeOptions)

+ func WithoutUnmount() ModeOption

+ type Option func(*options)

+ func WithHostWaitTimeout(d time.Duration) Option

+ func WithHubCachePath(path string) Option

+ func WithLegacySDWire3Switching() Option

+ func WithTargetPower(fn PowerFunc) Option

+ func WithWarningHandler(fn func(msg string)) Option

+ func WithoutRevive() Option

+ type PowerFunc func(shouldBeOn bool) error

+ type SDWire struct

+ func New(opts ...Option) (*SDWire, error)

+ func NewWithIdentity(id string, opts ...Option) (*SDWire, error)

+ func NewWithSerial(serial string, opts ...Option) (*SDWire, error)

+ func (s *SDWire) Close() error

+ func (s *SDWire) FlashAndBoot(ctx context.Context, imagePath string, opts ...FlashOption) error

+ func (s *SDWire) GetManufacturer() string

+ func (s *SDWire) GetProduct() string

+ func (s *SDWire) GetSerial() string

+ func (s *SDWire) HasTargetPower() bool

+ func (s *SDWire) Info() DeviceInfo

+ func (s *SDWire) Mode() (SwitchMode, error)

+ func (s *SDWire) PowerCycle(minOff time.Duration) error

+ func (s *SDWire) SetMode(mode SwitchMode, opts ...ModeOption) error

+ func (s *SDWire) SetTargetPower(fn PowerFunc)

+ func (s *SDWire) String() string

+ func (s *SDWire) TargetPower(on bool) error

+ type SwitchMode int

+ const ModeHost

+ const ModeTarget

+ const ModeUnknown

+ func CachedPortState(selector string, opts ...Option) (SwitchMode, string, error)

+ func (m SwitchMode) String() string