PineCone - Revision history

Ngp: Removes lupyuens reverse engineering blog post, as it contains tainted code.

2023-05-11T00:59:22Z

Removes lupyuens reverse engineering blog post, as it contains tainted code.

← Older revision		Revision as of 00:59, 11 May 2023
Line 192:		Line 192:
	* [https://lupyuen.github.io/articles/boot BL602 Bootloader by Lup Yuen]		* [https://lupyuen.github.io/articles/boot BL602 Bootloader by Lup Yuen]
	* [https://lupyuen.github.io/articles/tflite Machine Learning on RISC-V BL602 with TensorFlow Lite by Lup Yuen]		* [https://lupyuen.github.io/articles/tflite Machine Learning on RISC-V BL602 with TensorFlow Lite by Lup Yuen]
	* [https://lupyuen.github.io/articles/wifi Reverse Engineering WiFi on RISC-V BL602 by Lup Yuen]
	* [https://lupyuen.github.io/articles/adc Rust on RISC-V BL602: Is It Sunny? by Lup Yuen]		* [https://lupyuen.github.io/articles/adc Rust on RISC-V BL602: Is It Sunny? by Lup Yuen]
	* [https://lupyuen.github.io/articles/rustsim Rust on RISC-V BL602: Simulated with WebAssembly by Lup Yuen]		* [https://lupyuen.github.io/articles/rustsim Rust on RISC-V BL602: Simulated with WebAssembly by Lup Yuen]

Fxc: Added goal details

2023-03-30T10:02:50Z

Added goal details

← Older revision		Revision as of 10:02, 30 March 2023
Line 2:		Line 2:

	The '''PineCone''' is a BL602 evaluation board, which was developed with the goal to challenge the open source community to achieve blob-free and free and open source WiFi and Bluetooth, see the [https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/ Nutcracker Challenge].		The '''PineCone''' is a BL602 evaluation board, which was developed with the goal to challenge the open source community to achieve blob-free and free and open source WiFi and Bluetooth, see the [https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/ Nutcracker Challenge].

			== Challenge ==

			The goal of the challenge is to achieve a blob-free BL602 for the open source community to achieve a blob-free FOSS Bluetooth and WiFi on PINE64 devices, see [https://www.pine64.org/2020/10/28/nutcracker-challenge-blob-free-wifi-ble/ Nutcracker Challenge: Blob-Free WiFi & BLE].

	== BL602 Specifications ==		== BL602 Specifications ==

Fxc: /* Pinenut-01S Module information and schematics */ fix

2023-03-30T09:59:20Z

Pinenut-01S Module information and schematics: fix

← Older revision		Revision as of 09:59, 30 March 2023
Line 96:		Line 96:
	File:Pinenut-01S_PCB-Back.png\|200px\|The PCB back		File:Pinenut-01S_PCB-Back.png\|200px\|The PCB back
	</gallery>		</gallery>

			Schematics and GPIO definitions:

	* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]		* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]

Fxc: /* PineCone BL602 EVB information and schematics */ fix

2023-03-30T09:58:59Z

PineCone BL602 EVB information and schematics: fix

← Older revision		Revision as of 09:58, 30 March 2023
Line 82:		Line 82:
	The approximate dimensions are 26mm x 43mm.		The approximate dimensions are 26mm x 43mm.

	[https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]		Schematics: [https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]

	Note: In the PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.		Note: In the PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.

Fxc: /* Pinenut-12S Module information */ style

2023-03-30T09:58:21Z

Pinenut-12S Module information: style

← Older revision		Revision as of 09:58, 30 March 2023
Line 109:		Line 109:
	== Pinenut-12S Module information ==		== Pinenut-12S Module information ==

	[[File:NUT-12S_module-front.jpg\|200px~~]][[~~File:NUT-12S_module-back.jpg\|200px]]		<gallery>
			File:NUT-12S_module-front.jpg\|200px\|The Pinenut-12S Module front
			File:NUT-12S_module-back.jpg\|200px\|The Pinenut-12S Module back
			</gallery>

	* [https://files.pine64.org/doc/Pinenut/NUT-12S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-12S GPIO Definition ver 1.0]		GPIO definition: [https://files.pine64.org/doc/Pinenut/NUT-12S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-12S GPIO Definition ver 1.0]
	* Onboard LED is connected to IO0
			The onboard LED is connected to IO0

	== Datasheets for components and peripherals ==		== Datasheets for components and peripherals ==

Fxc: /* Loading code */ Removed

2023-03-30T09:56:42Z

Loading code: Removed

← Older revision		Revision as of 09:56, 30 March 2023
Line 142:		Line 142:
	* [https://github.com/bouffalolab/BLOpenFlasher BLOpenFlasher] is a WIP, written in go, by Bouffalo Labs to provide source for a flash utility.		* [https://github.com/bouffalolab/BLOpenFlasher BLOpenFlasher] is a WIP, written in go, by Bouffalo Labs to provide source for a flash utility.
	* [https://github.com/renzenicolai/bl602tool bl602tool] is a Python utility in development.		* [https://github.com/renzenicolai/bl602tool bl602tool] is a Python utility in development.
	* <del>[https://pypi.org/project/bflb-eflash-loader/ Bouffalo's Python Flash Loader] is a new (Dec 20) flash loader by the makers of the chip.</del>
	* <del>[https://pypi.org/project/bflb-image-build/ Bouffalo's image build] smooshes code and adds headers for downloads.</del>
	* [https://pypi.org/project/bflb-mcu-tool/ Bouffalo's MCU tool] (Mar 2021) Python image tool replaced both of the above. Now combined with eflash loader, deals with partitions, DTS, signing, fuses etc.		* [https://pypi.org/project/bflb-mcu-tool/ Bouffalo's MCU tool] (Mar 2021) Python image tool replaced both of the above. Now combined with eflash loader, deals with partitions, DTS, signing, fuses etc.
	* [https://github.com/spacemeowx2/blflash blflash serial flasher] BL602 serial flasher, inspired by BLOpenFlasher		* [https://github.com/spacemeowx2/blflash blflash serial flasher] BL602 serial flasher, inspired by BLOpenFlasher

Fxc: /* PineCone BL602 EVB information and schematics */ style

2023-03-30T09:56:09Z

PineCone BL602 EVB information and schematics: style

← Older revision		Revision as of 09:56, 30 March 2023
Line 78:		Line 78:
	== PineCone BL602 EVB information and schematics ==		== PineCone BL602 EVB information and schematics ==

	* Approximate dimensions: ~~26mm x 43mm~~		[[File:PADI-II_EVB.png\|thumb\|right\|120px\|The board layout]]
	* Board layout:

	~~[[File:PADI-II_EVB~~.~~png]]~~		The approximate dimensions are 26mm x 43mm.

	* [https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]		[https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]
	** Note: In PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.
	* The board uses a CH340 Serial/USB adapter. This chip is commonly used in Arduino-class development boards. It is a full speed (12Mbps) USB interface and has vendor ID 0x1a86 with product ID 0x7523.		Note: In the PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.
	* The GPIO pins (11, 12, 14, 17) plus the nearby RESET, POWER, and GND pins are all located on one side of the board, on J1 to provide JTAG connection.
			The board uses a CH340 Serial/USB adapter. This chip is commonly used in Arduino-class development boards. It is a full speed (12Mbps) USB interface and has vendor ID 0x1a86 with product ID 0x7523.

			The GPIO pins (11, 12, 14, 17) plus the nearby RESET, POWER, and GND pins are all located on one side of the board, on J1 to provide JTAG connection.

	== Pinenut-01S Module information and schematics ==		== Pinenut-01S Module information and schematics ==

Fxc: /* Pinenut-01S Module information and schematics */ Style

2023-03-30T09:53:15Z

Pinenut-01S Module information and schematics: Style

← Older revision		Revision as of 09:53, 30 March 2023
Line 90:		Line 90:
	== Pinenut-01S Module information and schematics ==		== Pinenut-01S Module information and schematics ==

	[[File:Pinenut-01S_PCB-Front.png\|~~thumb~~\|~~right]]~~		<gallery>
			File:Pinenut-01S_PCB-Front.png\|200px\|The PCB front
	[[File:Pinenut-01S_PCB-Back.png\|~~thumb~~\|~~right]]~~		File:Pinenut-01S_PCB-Back.png\|200px\|The PCB back
			</gallery>

	* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]		* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]

Fxc: /* Datasheets for components and peripherals */ Style fix

2023-03-30T09:51:32Z

Datasheets for components and peripherals: Style fix

← Older revision		Revision as of 09:51, 30 March 2023
Line 113:		Line 113:
	== Datasheets for components and peripherals ==		== Datasheets for components and peripherals ==

	* Bouffalo BL-602 SoC information:		Bouffalo BL-602 SoC information:
	** [https://github.com/bouffalolab/bl_docs Bouffalo Lab's official bl_docs repository]: should always contain the latest SoC documentation available, in PDF, HTML, and reStructuredText source forms.
	** [https://github.com/pine64/bl602-docs/tree/main/mirrored PINE64's bl602-docs repository]: contains an archive of all historical datasheets and reference manual PDFs but may lag behind Bouffalo's official repository. If you notice that it is, please submit a pull request!		* [https://github.com/bouffalolab/bl_docs Bouffalo Lab's official bl_docs repository]: should always contain the latest SoC documentation available, in PDF, HTML, and reStructuredText source forms.
	* USB/Serial adapter:		* [https://github.com/pine64/bl602-docs/tree/main/mirrored PINE64's bl602-docs repository]: contains an archive of all historical datasheets and reference manual PDFs but may lag behind Bouffalo's official repository. If you notice that it is, please submit a pull request!
	** [https://cdn.sparkfun.com/datasheets/Dev/Arduino/Other/CH340DS1.PDF CH340 serial converter]
			USB/Serial adapter:

			* [https://cdn.sparkfun.com/datasheets/Dev/Arduino/Other/CH340DS1.PDF CH340 serial converter]

	== Misc notes ==		== Misc notes ==

Fxc: /* Pinenut-01S Module information and schematics */ style

2023-03-30T09:50:42Z

Pinenut-01S Module information and schematics: style

← Older revision		Revision as of 09:50, 30 March 2023
Line 90:		Line 90:
	== Pinenut-01S Module information and schematics ==		== Pinenut-01S Module information and schematics ==

	[[File:Pinenut-01S_PCB-Front.png\|~~225px~~]][[File:Pinenut-01S_PCB-Back.png\|~~225px~~]]		[[File:Pinenut-01S_PCB-Front.png\|thumb\|right]]

			[[File:Pinenut-01S_PCB-Back.png\|thumb\|right]]

	* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]		* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]
Line 96:		Line 98:
	* [https://files.pine64.org/doc/Pinenut/NUT-01S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-01S GPIO Definition ver 1.0]		* [https://files.pine64.org/doc/Pinenut/NUT-01S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-01S GPIO Definition ver 1.0]
	* [https://files.pine64.org/doc/Pinenut/USB%20Adapter%20for%20Pinenut-01S%20Schematic%20V1.0.pdf USB Programmer adapter for Pinenut-01S schematic ver 1.0]		* [https://files.pine64.org/doc/Pinenut/USB%20Adapter%20for%20Pinenut-01S%20Schematic%20V1.0.pdf USB Programmer adapter for Pinenut-01S schematic ver 1.0]
	* The default firmware runs the UART at 2000000 bps. It will accept input whilst regularly outputting:~~<code><br/>~~proc_hellow_entry: RISC-V rv32imafc~~<br/>~~cur key status:1~~</code>~~
			The default firmware runs the UART at 2000000 bps. It will accept input whilst regularly outputting:

			proc_hellow_entry: RISC-V rv32imafc
			cur key status:1

	== Pinenut-12S Module information ==		== Pinenut-12S Module information ==