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
+
+srPS0byte
+srPS1byte
+crENbyte
+crINTbyte
+crSTObyte
+crEAbyte
+crSTAbyte
 }
 ```
 
@@ -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
 
+spcrR0byte
+spcrR1byte
+spcrCPHAbyte
+spcrCPOLbyte
+spcrDORDbyte
+spcrSPEbyte
+spcrMSTRbyte
+
+spsrI2Xbyte
+spsrSPIFbyte
+
 // 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 {
 BaudRateuint32
 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
+
+srPS0byte
+srPS1byte
+crENbyte
+crINTbyte
+crSTObyte
+crEAbyte
+crSTAbyte
 }
 ```
 
@@ -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
 
+spcrR0byte
+spcrR1byte
+spcrCPHAbyte
+spcrCPOLbyte
+spcrDORDbyte
+spcrSPEbyte
+spcrMSTRbyte
+
+spsrI2Xbyte
+spsrSPIFbyte
+
 // 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 {
 BaudRateuint32
 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 {
 BaudRateuint32
 TX	Pin
 RX	Pin
+RTS	Pin
+CTS	Pin
 }
 ```