Pinedio - Revision history

Fxc: /* Operating systems */ wording, link. Removed problematic section due to the license

2023-04-05T15:38:14Z

Operating systems: wording, link. Removed problematic section due to the license

@@ Line 46: / Line 46: @@
 === Operating systems ===
-Note: Pinedio Gateway carries the A64-LTS board. Based on ram specifications SOPINE images are also compatible.
+The Pinedio Gateway carries the A64-LTS board. The [[SOPINE Software Releases|SOPINE releases]] are also compatible based on the RAM specifications.
 == USB adapter ==

Fxc: /* Kernel 5.15 and newer */ typo

2023-04-02T15:43:27Z

Kernel 5.15 and newer: typo

← Older revision		Revision as of 15:43, 2 April 2023
Line 376:		Line 376:
	{{Warning\|It is not sure if these are the correct pins to use!}}		{{Warning\|It is not sure if these are the correct pins to use!}}

	{\| class="wikitable		{\| class="wikitable"
	\| CH341 Pin \|\| CH341A Name \|\| Function \|\| GPIO Name \|\| GPIO Configuration \|\| SX1262 connection		\| CH341 Pin \|\| CH341A Name \|\| Function \|\| GPIO Name \|\| GPIO Configuration \|\| SX1262 connection
	\|-		\|-

Fxc: /* Kernel 5.15 and newer */ Fixes

2023-04-02T15:38:11Z

Kernel 5.15 and newer: Fixes

← Older revision		Revision as of 15:38, 2 April 2023
Line 321:		Line 321:

	The driver creates these interfaces:		The driver creates these interfaces:
	{\| class="wikitable"
	\|Pin \|\|SPI Function \|\|GPIO function \|\|GPIO name \|\|IRQ		{\| class="wikitable"
	\|-		! Pin !! SPI Function !! GPIO function !! GPIO name !! IRQ
	\|15\|\|CS0\|\|-\|\|-\|\|-		\|-
	\|-		\| 15 \|\| CS0 \|\| - \|\| - \|\| -
	\|16\|\|CS1\|\|-\|\|-\|\|-		\|-
	\|-		\| 16 \|\| CS1 \|\| - \|\| - \|\| -
	\|17\|\|CS2\|\|-\|\|-\|\|-		\|-
	\|-		\| 17 \|\| CS2 \|\| - \|\| - \|\| -
	\|19\|\|-\|\|Input\|\|gpio4\|\|hardware		\|-
	\|-		\| 19 \|\| - \|\| Input \|\| gpio4 \|\| hardware
	\|21\|\|-\|\|Input\|\|gpio5\|\|software		\|-
	\|}		\| 21 \|\| - \|\| Input \|\| gpio5 \|\| software
			\|}

	The dimich-dmb fork of spi-ch341-usb works with 5.15+ kernels, but as you can see above it is not configured for the needs of the Pinedio-USB by default. I have started a branch in my fork to work on getting the driver pre-configured for our needs. The branch can be [https://github.com/UncleGrumpy/spi-ch341-usb/tree/pinedio found here.] Please feel free to help! And open issues or discussions in the repo if you have problems or ideas how to help. Any improvements to the actual code beyond configuration should be pushed to the temporary [https://github.com/dimich-dmb/spi-ch341-usb/ upstream.]		The dimich-dmb fork of spi-ch341-usb works with 5.15+ kernels, but as you can see above it is not configured for the needs of the Pinedio-USB by default. I have started a branch in my fork to work on getting the driver pre-configured for our needs. The branch can be [https://github.com/UncleGrumpy/spi-ch341-usb/tree/pinedio found here.] Please feel free to help! And open issues or discussions in the repo if you have problems or ideas how to help. Any improvements to the actual code beyond configuration should be pushed to the temporary [https://github.com/dimich-dmb/spi-ch341-usb/ upstream.]
Line 358:		Line 359:

	The driver uses following CH341A pins for the SPI interface.		The driver uses following CH341A pins for the SPI interface.
	~~{\| class="wikitable"~~
	~~\| Pin \|\| Name \|\| Direction \|\| Function SPI (CH341A)~~
	\|-
	~~\| 18 \|\| D3 \|\| output \|\| SCK (DCK)~~
	\|-
	~~\| 20 \|\| D5 \|\| output \|\| MOSI (DOUT)~~
	\|-
	~~\| 22 \|\| D7 \|\| input \|\| MISO (DIN)~~
	\|-
	~~\| 15 \|\| D0 \|\| output \|\| CS0~~
	\|}

	The driver uses the following GPIO configuration. ~~I am~~ not ~~at all~~ sure these are the correct pins to use! ~~This is one area that I could really use some help with!!!~~		{\| class="wikitable"
	{\| class="wikitable		\| Pin \|\| Name \|\| Direction \|\| Function SPI (CH341A)
	\| CH341 Pin \|\| CH341A Name \|\| Function \|\| GPIO Name \|\| GPIO Configuration \|\| SX1262 connection		\|-
	\|-		\| 18 \|\| D3 \|\| output \|\| SCK (DCK)
	\| 7 \|\| INT# \|\| IRQ \|\| dio_irq \|\| Output \|\| DIO1 (IRQ)		\|-
	\|-		\| 20 \|\| D5 \|\| output \|\| MOSI (DOUT)
	\| 8 \|\| SLCT \|\| BUSY \|\| dio_busy \|\| Input \|\| BUSY		\|-
	\|-		\| 22 \|\| D7 \|\| input \|\| MISO (DIN)
	\| 26 \|\| RST# \|\| Hard Reset \|\| dio_reset \|\| Output \|\| NRESET		\|-
	\|}		\| 15 \|\| D0 \|\| output \|\| CS0
			\|}

			The driver uses the following GPIO configuration.

			{{Warning\|It is not sure if these are the correct pins to use!}}

			{\| class="wikitable
			\| CH341 Pin \|\| CH341A Name \|\| Function \|\| GPIO Name \|\| GPIO Configuration \|\| SX1262 connection
			\|-
			\| 7 \|\| INT# \|\| IRQ \|\| dio_irq \|\| Output \|\| DIO1 (IRQ)
			\|-
			\| 8 \|\| SLCT \|\| BUSY \|\| dio_busy \|\| Input \|\| BUSY
			\|-
			\| 26 \|\| RST# \|\| Hard Reset \|\| dio_reset \|\| Output \|\| NRESET
			\|}

	The function of these pins can be changed from user space by using libgpiod. The command line tools installed with the library (gpioset, gpioget, gpiodetect, gpioinfo...) can be used for bash scripts, etc. and applications should all use the libgpiod interfaces. The /sys/class/gpio interface has been removed from the kernel in 5.15, so any apps using /sys/class/gpio to access gpio pins are broken, or will be as distos update their kernels to 5.15 and beyond.		The function of these pins can be changed from user space by using libgpiod. The command line tools installed with the library (gpioset, gpioget, gpiodetect, gpioinfo...) can be used for bash scripts, etc. and applications should all use the libgpiod interfaces. The /sys/class/gpio interface has been removed from the kernel in 5.15, so any apps using /sys/class/gpio to access gpio pins are broken, or will be as distos update their kernels to 5.15 and beyond.

	GPIO pins can be listed with gpioinfo:		GPIO pins can be listed with gpioinfo:

	$ gpioinfo pinedio		$ gpioinfo pinedio

	The output should look similar to:		The output should look similar to:

	gpiochip1 - 3 lines:		gpiochip1 - 3 lines:
	line 0: "dio_irq" unused input active-high		line 0: "dio_irq" unused input active-high

Fxc: /* Armbian */

2023-03-30T11:32:17Z

Armbian

← Older revision		Revision as of 11:32, 30 March 2023
Line 56:		Line 56:
	Download:		Download:

	* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from ''mega.nz'' (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f)		* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from ''mega.nz'' (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f) {{Suspected license violation}}

	Notes:		Notes:

Fxc: /* Operating Systems */ Style

2023-03-24T21:42:55Z

Operating Systems: Style

← Older revision		Revision as of 21:42, 24 March 2023
Line 44:		Line 44:
	</gallery>		</gallery>

	=== Operating ~~Systems~~ ===		=== Operating systems ===

	Note: Pinedio Gateway carries the A64-LTS board. Based on ram specifications SOPINE images are also compatible.		Note: Pinedio Gateway carries the A64-LTS board. Based on ram specifications SOPINE images are also compatible.

Fxc: /* USB adapter */ style

2023-03-24T21:40:44Z

USB adapter: style

← Older revision		Revision as of 21:40, 24 March 2023
Line 63:		Line 63:

	== USB adapter ==		== USB adapter ==
	[[File:Pine64-lora-usb-adapter.jpg\|~~500px~~]]		[[File:Pine64-lora-usb-adapter.jpg\|thumb\|right\|The PINE64 USB LoRa adapter]]

	The ~~Pine64~~ USB LoRa adapter is based on the Semtech SX1262 LoRa module and the CH341 USB bus converter chip. The '''CH341''' chip can be configured in multiple mode to convert USB to various serial and parallel ports. In this case, it's configured in '''synchronous serial mode''', which allows this chip to convert from USB to the SPI bus needed to talk to the SX1262 LoRa module:		The PINE64 USB LoRa adapter is based on the Semtech SX1262 LoRa module and the CH341 USB bus converter chip. The '''CH341''' chip can be configured in multiple mode to convert USB to various serial and parallel ports. In this case, it's configured in '''synchronous serial mode''', which allows this chip to convert from USB to the SPI bus needed to talk to the SX1262 LoRa module:

	-------- --------------------------		-------- --------------------------

Fxc: /* Pins */

2023-03-24T21:40:08Z

Pins

← Older revision		Revision as of 21:40, 24 March 2023
Line 74:		Line 74:

	=== Pins ===		=== Pins ===
	[[File:Lora-usb-pins.jpg\|~~500px~~]]		[[File:Lora-usb-pins.jpg\|thumb\|right\|Pinout]]

	{\| class="wikitable"		{\|class="wikitable"

	!SX1262 Pin		!SX1262 Pin

Fxc: /* Armbian */ style

2023-03-24T21:37:46Z

Armbian: style

← Older revision		Revision as of 21:37, 24 March 2023
Line 52:		Line 52:
	The PineDio Gateway TTN/Chirpstack Image. Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.		The PineDio Gateway TTN/Chirpstack Image. Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.

	Debian image with (Default Choices: Chirpstack / TTN) software preinstalled / hardware enabled~~, available below~~.		Debian image with (Default Choices: Chirpstack / TTN) software preinstalled / hardware enabled.

	Download:		Download:

Fxc: /* Armbian */ Outsourced information to dedicated article as it is cluttering the article and too OS-specific for the main article

2023-03-24T21:37:24Z

Armbian: Outsourced information to dedicated article as it is cluttering the article and too OS-specific for the main article

@@ Line 50: / Line 50: @@
 ==== Armbian ====
-Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.
+The PineDio Gateway TTN/Chirpstack Image. Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.
 Debian image with (Default Choices: Chirpstack / TTN) software preinstalled / hardware enabled, available below.
@@ Line 57: / Line 56: @@
 Download:
-* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from mega.nz (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f)
+* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from ''mega.nz'' (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f)
-===== Check the ttn-gateway =====
+Notes:
- journalctl -u ttn-gateway
+* Additional notes regarding Armbian on the Pinedio can be found in the article [[Pinedio: Armbian Notes]]
 == USB adapter ==

Fxc: /* Operating Systems */ style fixes

2023-03-24T21:33:18Z

Operating Systems: style fixes

← Older revision		Revision as of 21:33, 24 March 2023
Line 51:		Line 51:

	Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.		Gateway Hardware based on Pine64 A64-LTS + RAK5146 + GPS. Hardware-compatible with SOPINE images.
			PineDio Gateway TTN/Chirpstack Image'''
	~~'''~~PineDio Gateway TTN/Chirpstack Image'''

	Debian image with (Default Choices: Chirpstack / TTN) software preinstalled / hardware enabled, available below.		Debian image with (Default Choices: Chirpstack / TTN) software preinstalled / hardware enabled, available below.

	Download:		Download:

	* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from mega.nz (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f)		* [https://mega.nz/file/hLVAWLDT#DMFOugfIHaVj3dI30YPHug-duKow4nGUt6uakEc_xmY PineDio-RAK-Armbian_02-05-2023.img.xz (Linux Kernel 5.15.89-sunxi)] from mega.nz (SHA256: cdb9bd528981c47b68f121b4819ee870631c67dd5d125fb0ea3d79cae7ce4ac1, SHA512: dde9123542329dd37d29ebab695ddd8a0fe1a52e7c05f51ff7554d5a70224c30bd4a28d31526e84c89c78cd76f351487499dd8a1ab83baec2e8d00a6ff00874f)

	~~'''~~Check ttn-gateway		===== Check the ttn-gateway =====

	journalctl -u ttn-gateway		journalctl -u ttn-gateway

	-- Journal begins at Fri 2023-03-24 04:53:25 PDT, ends at Fri 2023-03-24 11:10:25 PDT. --		-- Journal begins at Fri 2023-03-24 04:53:25 PDT, ends at Fri 2023-03-24 11:10:25 PDT. --
Line 96:		Line 96:
	Mar 24 04:53:25 pine-gateway ttn-gateway[1992]: # BEACON rejected: 0		Mar 24 04:53:25 pine-gateway ttn-gateway[1992]: # BEACON rejected: 0

	~~'''~~Switch ~~Between~~ Chirpstack / TTN (TheThingsNetwork)~~'''~~		===== Switch between Chirpstack / TTN (TheThingsNetwork) =====

	gateway-config		Use the command <code>gateway-config</code> to switch between Chirpstack / TTN (TheThingsNetwork).

	~~First Select~~:		Then select:

	Setup RAK Gateway Channel Plan		Setup RAK Gateway Channel Plan

	Next ~~For~~ TTN (TheThingsNetwork) ~~Select~~:		Next for '''TTN (TheThingsNetwork)''' select:

	Server is TTN		Server is TTN

	'''or'''		Or for '''Chirpstack''' select:

	~~Next For Chirpstack Select~~:

	Server is Other server		Server is Other server

	~~'''Accessing Chirpstack Admin Page'''~~		===== Access =====

	~~Point~~ web browser to:		The Chirpstack admin page can be accessed by point the web browser to <code>http://gatewayIPaddress:8080</code>.

	~~http~~://~~gatewayIPaddress:8080~~		{\| class="wikitable"
			!colspan="2" style="background: #a7d7f9;"\| Default credentials
			\|-
			! Default Chirpstack Credentials
			\| <code>admin/admin</code>
			\|-
			! SSH Credentials
			\| <code>pinedio/SoPinePass!!!</code>
			\|}

	~~'''Default Chirpstack Credentials'''~~		===== Changing EUI =====

	~~login: admin~~
	~~password: admin~~

	~~'''SSH Credentials'''~~

	~~Login: pinedio~~
	~~password: SoPinePass!!!~~

	~~'''~~Changing EUI~~'''~~

	EUI stored in file:		EUI stored in file:
Line 138:		Line 134:
	(edit EUI file above if you wish change it, and run: sudo systemctl restart ttn-gateway)		(edit EUI file above if you wish change it, and run: sudo systemctl restart ttn-gateway)

	~~'''~~Additional Shell Commands~~'''~~		===== Additional Shell Commands =====

	~~'''View Gateway ID/EUI'''~~

	~~gateway-version~~

	~~'''Restart Packet Forwarder~~/~~Concentrator'''~~		View gateway ID/EUI <code>gateway-version</code>

	sudo systemctl restart ttn-gateway		Restart packet forwarder / concentrator using <code>sudo systemctl restart ttn-gateway</code>

	~~'''~~Check ~~Status'''~~		Check status using <code>sudo systemctl status ttn-gateway</code>

	~~sudo systemctl status ttn-gateway~~		===== Enabling Concentrator/GPS =====

	~~'''Enabling Concentrator/GPS Steps (~~Below ~~Already Completed For Above Image Download)'''~~		Below steps are already completed for the above images:

	Inside armbian-config -> system -> Bootenv (edit boot environment), enter the following 2 lines (to create spidev0.0):		Inside armbian-config -> system -> Bootenv (edit boot environment), enter the following 2 lines (to create spidev0.0):
Line 161:		Line 153:
	Or you may hand edit: /boot/armbianEnv.txt to add the above overlays/param_spidev_spi_bus lines.		Or you may hand edit: /boot/armbianEnv.txt to add the above overlays/param_spidev_spi_bus lines.

	~~Save. Reboot~~.		Then save and reboot.

	After rebooting you should see a new device /dev/spidev0.0. This will be the concentrator device for gateway related setup.		After rebooting you should see a new device /dev/spidev0.0. This will be the concentrator device for gateway related setup.