microcontrollers: run doc-gen to update documentation

This required a few hacks to get it to run on version 0.28, this is
something we should fix some time.

Author: aykevl

content/docs/reference/microcontrollers/lorae5.md

@@ -24,6 +24,8 @@ It has onboard LoRa®, (G)FSK, (G)MSK, and BPSK as well as 1 user LED, 1 user bu
 | Pin               | Hardware pin | Alternative names |
 | ----------------- | ------------ | ----------------- |
 | `LED`             | `PB5`        |                   |
+| `POWER_EN3V3`     | `PA9`        |                   |
+| `POWER_EN5V`      | `PB10`       |                   |
 | `SPI0_NSS_PIN`    | `PA4`        |                   |
 | `SPI0_SCK_PIN`    | `PA5`        |                   |
 | `SPI0_SDO_PIN`    | `PA6`        |                   |
@@ -32,8 +34,8 @@ It has onboard LoRa®, (G)FSK, (G)MSK, and BPSK as well as 1 user LED, 1 user bu
 | `UART1_RX_PIN`    | `PB7`        | `UART_RX_PIN`     |
 | `UART2_TX_PIN`    | `PA2`        |                   |
 | `UART2_RX_PIN`    | `PA3`        |                   |
-| `I2C1_SCL_PIN`    | `PA9`        | `I2C0_SCL_PIN`    |
-| `I2C1_SDA_PIN`    | `PA10`       | `I2C0_SDA_PIN`    |
+| `I2C2_SCL_PIN`    | `PB15`       | `I2C0_SCL_PIN`    |
+| `I2C2_SDA_PIN`    | `PA15`       | `I2C0_SDA_PIN`    |
 
 ## Machine Package Docs
 

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

@@ -118,6 +118,37 @@ TWI_FREQ is the I2C bus speed. Normally either 100 kHz, or 400 kHz for high-spee
 Deprecated: use 100 * machine.KHz or 400 * machine.KHz instead.
 
 
+```go
+const (
+	// I2CReceive indicates target has received a message from the controller.
+	I2CReceive	I2CTargetEvent	= iota
+
+	// I2CRequest indicates the controller is expecting a message from the target.
+	I2CRequest
+
+	// I2CFinish indicates the controller has ended the transaction.
+	//
+	// I2C controllers can chain multiple receive/request messages without
+	// relinquishing the bus by doing 'restarts'.  I2CFinish indicates the
+	// bus has been relinquished by an I2C 'stop'.
+	I2CFinish
+)
+```
+
+
+
+```go
+const (
+	// I2CModeController represents an I2C peripheral in controller mode.
+	I2CModeController	I2CMode	= iota
+
+	// I2CModeTarget represents an I2C peripheral in target mode.
+	I2CModeTarget
+)
+```
+
+
+
 ```go
 const Device = deviceName
 ```
@@ -450,6 +481,7 @@ type ADCConfig struct {
 	Reference	uint32	// analog reference voltage (AREF) in millivolts
 	Resolution	uint32	// number of bits for a single conversion (e.g., 8, 10, 12)
 	Samples		uint32	// number of samples for a single conversion (e.g., 4, 8, 16, 32)
+	SampleTime	uint32	// sample time, in microseconds (µs)
 }
 ```
 
@@ -535,6 +567,30 @@ I2CConfig is used to store config info for I2C.
 
 
 
+## type I2CMode
+
+```go
+type I2CMode int
+```
+
+I2CMode determines if an I2C peripheral is in Controller or Target mode.
+
+
+
+
+
+## type I2CTargetEvent
+
+```go
+type I2CTargetEvent uint8
+```
+
+I2CTargetEvent reflects events on the I2C bus
+
+
+
+
+
 ## type NullSerial
 
 ```go

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

@@ -136,6 +136,37 @@ TWI_FREQ is the I2C bus speed. Normally either 100 kHz, or 400 kHz for high-spee
 Deprecated: use 100 * machine.KHz or 400 * machine.KHz instead.
 
 
+```go
+const (
+	// I2CReceive indicates target has received a message from the controller.
+	I2CReceive	I2CTargetEvent	= iota
+
+	// I2CRequest indicates the controller is expecting a message from the target.
+	I2CRequest
+
+	// I2CFinish indicates the controller has ended the transaction.
+	//
+	// I2C controllers can chain multiple receive/request messages without
+	// relinquishing the bus by doing 'restarts'.  I2CFinish indicates the
+	// bus has been relinquished by an I2C 'stop'.
+	I2CFinish
+)
+```
+
+
+
+```go
+const (
+	// I2CModeController represents an I2C peripheral in controller mode.
+	I2CModeController	I2CMode	= iota
+
+	// I2CModeTarget represents an I2C peripheral in target mode.
+	I2CModeTarget
+)
+```
+
+
+
 ```go
 const Device = deviceName
 ```
@@ -495,6 +526,7 @@ type ADCConfig struct {
 	Reference	uint32	// analog reference voltage (AREF) in millivolts
 	Resolution	uint32	// number of bits for a single conversion (e.g., 8, 10, 12)
 	Samples		uint32	// number of samples for a single conversion (e.g., 4, 8, 16, 32)
+	SampleTime	uint32	// sample time, in microseconds (µs)
 }
 ```
 
@@ -580,6 +612,30 @@ I2CConfig is used to store config info for I2C.
 
 
 
+## type I2CMode
+
+```go
+type I2CMode int
+```
+
+I2CMode determines if an I2C peripheral is in Controller or Target mode.
+
+
+
+
+
+## type I2CTargetEvent
+
+```go
+type I2CTargetEvent uint8
+```
+
+I2CTargetEvent reflects events on the I2C bus
+
+
+
+
+
 ## type NullSerial
 
 ```go

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

@@ -192,6 +192,37 @@ TWI_FREQ is the I2C bus speed. Normally either 100 kHz, or 400 kHz for high-spee
 Deprecated: use 100 * machine.KHz or 400 * machine.KHz instead.
 
 
+```go
+const (
+	// I2CReceive indicates target has received a message from the controller.
+	I2CReceive	I2CTargetEvent	= iota
+
+	// I2CRequest indicates the controller is expecting a message from the target.
+	I2CRequest
+
+	// I2CFinish indicates the controller has ended the transaction.
+	//
+	// I2C controllers can chain multiple receive/request messages without
+	// relinquishing the bus by doing 'restarts'.  I2CFinish indicates the
+	// bus has been relinquished by an I2C 'stop'.
+	I2CFinish
+)
+```
+
+
+
+```go
+const (
+	// I2CModeController represents an I2C peripheral in controller mode.
+	I2CModeController	I2CMode	= iota
+
+	// I2CModeTarget represents an I2C peripheral in target mode.
+	I2CModeTarget
+)
+```
+
+
+
 ```go
 const (
 	I2SModeSource	I2SMode	= iota
@@ -370,6 +401,12 @@ var (
 
 
 
+```go
+var Flash flashBlockDevice
+```
+
+
+
 ```go
 var (
 	ErrPWMPeriodTooLong = errors.New("pwm: period too long")
@@ -424,6 +461,15 @@ func CPUFrequency() uint32
 Return the current CPU frequency in hertz.
 
 
+### func CPUReset
+
+```go
+func CPUReset()
+```
+
+CPUReset performs a hard system reset.
+
+
 ### func EnableCDC
 
 ```go
@@ -469,6 +515,26 @@ EnterBootloader should perform a system reset in preperation
 to switch to the bootloader to flash new firmware.
 
 
+### func FlashDataEnd
+
+```go
+func FlashDataEnd() uintptr
+```
+
+Return the end of the writable flash area. Usually this is the address one
+past the end of the on-chip flash.
+
+
+### func FlashDataStart
+
+```go
+func FlashDataStart() uintptr
+```
+
+Return the start of the writable flash area, aligned on a page boundary. This
+is usually just after the program and static data.
+
+
 ### func InitADC
 
 ```go
@@ -560,6 +626,7 @@ type ADCConfig struct {
 	Reference	uint32	// analog reference voltage (AREF) in millivolts
 	Resolution	uint32	// number of bits for a single conversion (e.g., 8, 10, 12)
 	Samples		uint32	// number of samples for a single conversion (e.g., 4, 8, 16, 32)
+	SampleTime	uint32	// sample time, in microseconds (µs)
 }
 ```
 
@@ -570,6 +637,43 @@ value of each parameter will use the peripheral's default settings.
 
 
 
+## type BlockDevice
+
+```go
+type BlockDevice interface {
+	// ReadAt reads the given number of bytes from the block device.
+	io.ReaderAt
+
+	// WriteAt writes the given number of bytes to the block device.
+	io.WriterAt
+
+	// Size returns the number of bytes in this block device.
+	Size() int64
+
+	// WriteBlockSize returns the block size in which data can be written to
+	// memory. It can be used by a client to optimize writes, non-aligned writes
+	// should always work correctly.
+	WriteBlockSize() int64
+
+	// EraseBlockSize returns the smallest erasable area on this particular chip
+	// in bytes. This is used for the block size in EraseBlocks.
+	// It must be a power of two, and may be as small as 1. A typical size is 4096.
+	EraseBlockSize() int64
+
+	// EraseBlocks erases the given number of blocks. An implementation may
+	// transparently coalesce ranges of blocks into larger bundles if the chip
+	// supports this. The start and len parameters are in block numbers, use
+	// EraseBlockSize to map addresses to blocks.
+	EraseBlocks(start, len int64) error
+}
+```
+
+BlockDevice is the raw device that is meant to store flash data.
+
+
+
+
+
 ## type DAC
 
 ```go
@@ -713,6 +817,30 @@ I2CConfig is used to store config info for I2C.
 
 
 
+## type I2CMode
+
+```go
+type I2CMode int
+```
+
+I2CMode determines if an I2C peripheral is in Controller or Target mode.
+
+
+
+
+
+## type I2CTargetEvent
+
+```go
+type I2CTargetEvent uint8
+```
+
+I2CTargetEvent reflects events on the I2C bus
+
+
+
+
+
 ## type I2S
 
 ```go