Fix doc-gen and update docs

With a few simple tweaks I got doc-gen working again (though finding
these issues took some time). The doc-gen script now works with Go 1.22.

Author: aykevl

content/docs/reference/microcontrollers/arduino-nano33.md

@@ -49,12 +49,12 @@ Peripherals:
 | `A7`              | `PB03`       |                   |                      |
 | `USBCDC_DM_PIN`   | `PA24`       |                   | `TCC1` (channel 2)   |
 | `USBCDC_DP_PIN`   | `PA25`       |                   | `TCC1` (channel 3)   |
-| `UART_TX_PIN`     | `PA22`       | `NINA_TX`         | `TCC0` (channel 0)   |
-| `UART_RX_PIN`     | `PA23`       | `NINA_RX`         | `TCC0` (channel 1)   |
-| `NINA_SDO`        | `PA12`       |                   | `TCC2` (channel 0), `TCC0` (channel 2) |
-| `NINA_SDI`        | `PA13`       |                   | `TCC2` (channel 1), `TCC0` (channel 3) |
-| `NINA_CS`         | `PA14`       |                   | `TCC0` (channel 0)   |
-| `NINA_SCK`        | `PA15`       |                   | `TCC0` (channel 1)   |
+| `UART_TX_PIN`     | `PA22`       |                   | `TCC0` (channel 0)   |
+| `UART_RX_PIN`     | `PA23`       |                   | `TCC0` (channel 1)   |
+| `NINA_SDO`        | `PA12`       | `NINA_TX`         | `TCC2` (channel 0), `TCC0` (channel 2) |
+| `NINA_SDI`        | `PA13`       | `NINA_RX`         | `TCC2` (channel 1), `TCC0` (channel 3) |
+| `NINA_CS`         | `PA14`       | `NINA_RTS`        | `TCC0` (channel 0)   |
+| `NINA_SCK`        | `PA15`       | `NINA_CTS`        | `TCC0` (channel 1)   |
 | `NINA_GPIO0`      | `PA27`       |                   |                      |
 | `NINA_RESETN`     | `PA08`       | `I2S_SD_PIN`      | `TCC0` (channel 0), `TCC1` (channel 2) |
 | `NINA_ACK`        | `PA28`       |                   |                      |

content/docs/reference/microcontrollers/machine/arduino-mega1280.md

@@ -317,13 +317,6 @@ var (
 
 
 
-```go
-var I2C0 *I2C = nil
-```
-
-I2C0 is the only I2C interface on most AVRs.
-
-
 ```go
 var DefaultUART = UART0
 ```
@@ -496,6 +489,18 @@ value of each parameter will use the peripheral's default settings.
 
 ```go
 type I2C struct {
+	srReg	*volatile.Register8
+	brReg	*volatile.Register8
+	crReg	*volatile.Register8
+	drReg	*volatile.Register8
+
+	srPS0	byte
+	srPS1	byte
+	crEN	byte
+	crINT	byte
+	crSTO	byte
+	crEA	byte
+	crSTA	byte
 }
 ```
 
@@ -526,6 +531,15 @@ is a shortcut to easily read such registers. Also, it only works for devices
 with 7-bit addresses, which is the vast majority.
 
 
+### func (*I2C) SetBaudRate
+
+```go
+func (i2c *I2C) SetBaudRate(br uint32) error
+```
+
+SetBaudRate sets the communication speed for I2C.
+
+
 ### func (*I2C) Tx
 
 ```go
@@ -1003,6 +1017,17 @@ type SPI struct {
 	spdr	*volatile.Register8
 	spsr	*volatile.Register8
 
+	spcrR0		byte
+	spcrR1		byte
+	spcrCPHA	byte
+	spcrCPOL	byte
+	spcrDORD	byte
+	spcrSPE		byte
+	spcrMSTR	byte
+
+	spsrI2X		byte
+	spsrSPIF	byte
+
 	// The io pins for the SPIx port set by the chip
 	sck	Pin
 	sdi	Pin
@@ -1150,7 +1175,8 @@ Usually called by the IRQ handler for a machine.
 func (uart *UART) Write(data []byte) (n int, err error)
 ```
 
-Write data to the UART.
+Write data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 ### func (*UART) WriteByte
@@ -1159,7 +1185,8 @@ Write data to the UART.
 func (uart *UART) WriteByte(c byte) error
 ```
 
-WriteByte writes a byte of data to the UART.
+WriteByte writes a byte of data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 
@@ -1171,6 +1198,8 @@ type UARTConfig struct {
 	BaudRate	uint32
 	TX		Pin
 	RX		Pin
+	RTS		Pin
+	CTS		Pin
 }
 ```
 

content/docs/reference/microcontrollers/machine/arduino-mega2560.md

@@ -375,13 +375,6 @@ var (
 
 
 
-```go
-var I2C0 *I2C = nil
-```
-
-I2C0 is the only I2C interface on most AVRs.
-
-
 ```go
 var DefaultUART = UART0
 ```
@@ -541,6 +534,18 @@ value of each parameter will use the peripheral's default settings.
 
 ```go
 type I2C struct {
+	srReg	*volatile.Register8
+	brReg	*volatile.Register8
+	crReg	*volatile.Register8
+	drReg	*volatile.Register8
+
+	srPS0	byte
+	srPS1	byte
+	crEN	byte
+	crINT	byte
+	crSTO	byte
+	crEA	byte
+	crSTA	byte
 }
 ```
 
@@ -571,6 +576,15 @@ is a shortcut to easily read such registers. Also, it only works for devices
 with 7-bit addresses, which is the vast majority.
 
 
+### func (*I2C) SetBaudRate
+
+```go
+func (i2c *I2C) SetBaudRate(br uint32) error
+```
+
+SetBaudRate sets the communication speed for I2C.
+
+
 ### func (*I2C) Tx
 
 ```go
@@ -918,6 +932,17 @@ type SPI struct {
 	spdr	*volatile.Register8
 	spsr	*volatile.Register8
 
+	spcrR0		byte
+	spcrR1		byte
+	spcrCPHA	byte
+	spcrCPOL	byte
+	spcrDORD	byte
+	spcrSPE		byte
+	spcrMSTR	byte
+
+	spsrI2X		byte
+	spsrSPIF	byte
+
 	// The io pins for the SPIx port set by the chip
 	sck	Pin
 	sdi	Pin
@@ -1065,7 +1090,8 @@ Usually called by the IRQ handler for a machine.
 func (uart *UART) Write(data []byte) (n int, err error)
 ```
 
-Write data to the UART.
+Write data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 ### func (*UART) WriteByte
@@ -1074,7 +1100,8 @@ Write data to the UART.
 func (uart *UART) WriteByte(c byte) error
 ```
 
-WriteByte writes a byte of data to the UART.
+WriteByte writes a byte of data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 
@@ -1086,6 +1113,8 @@ type UARTConfig struct {
 	BaudRate	uint32
 	TX		Pin
 	RX		Pin
+	RTS		Pin
+	CTS		Pin
 }
 ```
 

content/docs/reference/microcontrollers/machine/arduino-mkr1000.md

@@ -444,6 +444,7 @@ var (
 var (
 	ErrUSBReadTimeout	= errors.New("USB read timeout")
 	ErrUSBBytesRead		= errors.New("USB invalid number of bytes read")
+	ErrUSBBytesWritten	= errors.New("USB invalid number of bytes written")
 )
 ```
 
@@ -470,39 +471,40 @@ func CPUReset()
 CPUReset performs a hard system reset.
 
 
-### func EnableCDC
+### func ConfigureUSBEndpoint
 
 ```go
-func EnableCDC(txHandler func(), rxHandler func([]byte), setupHandler func(usb.Setup) bool)
+func ConfigureUSBEndpoint(desc descriptor.Descriptor, epSettings []usb.EndpointConfig, setup []usb.SetupConfig)
 ```
 
 
 
-### func EnableHID
+### func DeviceID
 
 ```go
-func EnableHID(txHandler func(), rxHandler func([]byte), setupHandler func(usb.Setup) bool)
+func DeviceID() []byte
 ```
 
-EnableHID enables HID. This function must be executed from the init().
+DeviceID returns an identifier that is unique within
+a particular chipset.
 
+The identity is one burnt into the MCU itself, or the
+flash chip at time of manufacture.
 
-### func EnableJoystick
+It's possible that two different vendors may allocate
+the same DeviceID, so callers should take this into
+account if needing to generate a globally unique id.
 
-```go
-func EnableJoystick(txHandler func(), rxHandler func([]byte), setupHandler func(usb.Setup) bool, hidDesc []byte)
-```
+The length of the hardware ID is vendor-specific, but
+8 bytes (64 bits) and 16 bytes (128 bits) are common.
 
-EnableJoystick enables HID. This function must be executed from the init().
 
-
-### func EnableMIDI
+### func EnableCDC
 
 ```go
-func EnableMIDI(txHandler func(), rxHandler func([]byte), setupHandler func(usb.Setup) bool)
+func EnableCDC(txHandler func(), rxHandler func([]byte), setupHandler func(usb.Setup) bool)
 ```
 
-EnableMIDI enables MIDI. This function must be executed from the init().
 
 
 ### func EnterBootloader
@@ -759,10 +761,10 @@ with 7-bit addresses, which is the vast majority.
 ### func (*I2C) SetBaudRate
 
 ```go
-func (i2c *I2C) SetBaudRate(br uint32)
+func (i2c *I2C) SetBaudRate(br uint32) error
 ```
 
-SetBaudRate sets the communication speed for the I2C.
+SetBaudRate sets the communication speed for I2C.
 
 
 ### func (*I2C) Tx
@@ -1539,7 +1541,8 @@ SetBaudRate sets the communication speed for the UART.
 func (uart *UART) Write(data []byte) (n int, err error)
 ```
 
-Write data to the UART.
+Write data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 ### func (*UART) WriteByte
@@ -1548,7 +1551,8 @@ Write data to the UART.
 func (uart *UART) WriteByte(c byte) error
 ```
 
-WriteByte writes a byte of data to the UART.
+WriteByte writes a byte of data over the UART's Tx.
+This function blocks until the data is finished being sent.
 
 
 
@@ -1560,6 +1564,8 @@ type UARTConfig struct {
 	BaudRate	uint32
 	TX		Pin
 	RX		Pin
+	RTS		Pin
+	CTS		Pin
 }
 ```