Armbian OS instruction

author	version	line-number	content
		1	Table of Contents：
		2
		3	{{toc/}}
		4
		5
		6
		7
		8	= 1. Overview =
		9
		10
		11	This is a general instruction for the use of Armbian base OS of Dragino devices. Current models include:
		12
		13	* HP0A
		14	* HP0C
		15	* LPS8v2
		16	* MS20
		17
		18	= 2. Development Guide =
		19
		20
		21	For advanced users to develop Driver/ Linux etc
		22
		23
		24
		25	== 2.1 How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
		26
		27
		28
		29	=== (% style="color:blue" %)Step 1. Clone dragino-fwd package(%%) ===
		30
		31
		32	(% style="color:red" %)Requirements:
		33
		34	(% class="box infomessage" %)
		35	(((
		36	sudo apt install -y libsqlite3-dev
		37	sudo apt install -y libftdi1-dev
		38	)))
		39
		40
		41	(% style="color:red" %)Run command clone dragino-fwd package:
		42
		43	(% class="box infomessage" %)
		44	(((
		45	git clone https:~/~/github.com/dragino/dragino_fwd_src.git
		46	)))
		47
		48	[[image:image-20220527151010-1.png]]
		49
		50
		51
		52	=== (% style="color:blue" %)Step 2. Compile dragino_fwd(%%) ===
		53
		54
		55	(% style="color:red" %)After cloning is complete, Run the command starts compiling:
		56
		57	(% class="box infomessage" %)
		58	(((
		59	Compile HP0C/HP0A fwd： ./hp0z-make-deb.sh c
		60	)))
		61
		62	The following example compilers HP0C fwd.
		63
		64	[[image:image-20220527153913-3.png]]
		65
		66
		67	*When the compilation is complete a draginofwd-.deb package is generated.**
		68
		69	[[image:image-20220527154311-4.png\|\|height="385" width="773"]]
		70
		71
		72
		73	=== (% style="color:blue" %)Step 3. Install the dragino_fwd(%%) ===
		74
		75
		76	(% style="color:red" %)Run command:
		77
		78	(% class="box infomessage" %)
		79	(((
		80	dpkg -i draginofwd-*.deb
		81	)))
		82
		83	[[image:image-20220527154811-5.png]]
		84
		85
		86
		87	=== (% style="color:blue" %)Step 4. Test(%%) ===
		88
		89
		90	Check the dragino_fwd log:
		91
		92	(% class="box infomessage" %)
		93	(((
		94	journalctl -u draginofwd -f
		95	)))
		96
		97	[[image:image-20220527165221-7.png\|\|height="182" width="931"]]
		98
		99
		100	Start/stop dragino_fwd via systemctl:
		101
		102	(% class="box infomessage" %)
		103	(((
		104	systemctl start draginofwd
		105	systemctl stop draginofwd
		106	)))
		107
		108
		109
		110	== 2.2 How to clone Complete OS on the EMMC to SD card ==
		111
		112
		113
		114	== 2.3 How to flash SD card to (eMMC) device's built-in Memory ==
		115
		116
		117	=== 2.3.1 Prepare an SD card with OS. ===
		118
		119	//Preparations://
		120
		121	~1. Prepare an SD card and a// card reader device//
		122
		123	2. Formatting the SD card (//Make sure the SD card is empty//)
		124
		125	3. //Download the OS image from [[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]: ( File format dragino-lps8v2-1.7.img )//
		126
		127	4. //A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] )//
		128
		129
		130	=== 2.3.2 Flash SD card to device's eMMC. ===
		131
		132	//1. Open the device's enclosure, and put the SD card into the SD card slot//
		133
		134	//2. Power on the device and access the gateway's CLI via the serial port.//
		135
		136	//3. Login and run the below command to flash.//
		137
		138
		139	(% style="color:red" %)Run command:
		140
		141	(% class="box infomessage" %)
		142	(((
		143	nand-sata-install
		144	)))
		145
		146	[[image:image-20220602112051-1.png]]
		147
		148
		149	Select the "Boot from eMMC - system on eMMC"
		150
		151	[[image:image-20220602112058-2.png\|\|height="292" width="646"]]
		152
		153	[[image:image-20220602112106-3.png\|\|height="301" width="643"]]
		154
		155
		156	Select the "1 ext4"
		157
		158	[[image:image-20220602112113-4.png\|\|height="271" width="642"]]
		159
		160
		161	It takes 4-5 minutes to burn from SD card to eMMC
		162
		163	[[image:image-20220602112119-5.png\|\|height="309" width="641"]]
		164
		165	[[image:image-20220602112125-6.png\|\|height="281" width="640"]]
		166
		167	[[image:image-20220602112131-7.png\|\|height="241" width="638"]]
		168
		169
		170	(% style="color:red" %)Note: After the flash is complete, power off the device and then remove the SD card.
		171
		172
		173	= 3. Package Maintain Note =
		174
		175