1
0
mirror of https://github.com/DigitalDevices/octonet.git synced 2023-10-10 13:36:52 +02:00

Update README.md instructions that actually build

Questions:
Dear @mvoelkel and/or @rjkm please update/bisect both repositories to the latest commit (933779a/cd19e9e I use as example) that actually build?

Is libxp-dev really necessary for building?

The image is around 5.7MB, according to the specs there is 256MB of flash does it mean I can safely flash a firmware that is ~12MB or maybe 200MB?

Please add a JTAG "openocd.cfg" for this target/board so a Raspberry Pi user can fix bad flash or bricked hardware by hackattack.
This commit is contained in:
Walter Sonius 2018-11-07 14:19:43 +01:00 committed by GitHub
parent f1e6470651
commit f2c21e896b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

108
README.md
View File

@ -1,68 +1,92 @@
# OctopusNet
# OctopusNet Buildroot
###Prepare for Building
On Debian/Ubuntu (as root or using sudo):
### Prepare
For building on Debian/Ubuntu run the following commands(remove sudo if already root user):
```
>apt-get install build-essential bison flex gettext libncurses5-dev texinfo autoconf automake libtool
>apt-get install libpng12-dev libglib2.0-dev libgtk2.0-dev gperf libxt-dev libxp-dev
>apt-get install rsync git subversion mercurial
sudo apt-get -y install build-essential bison flex gettext libncurses5-dev texinfo autoconf automake libtool \
libpng12-dev libglib2.0-dev libgtk2.0-dev gperf libxt-dev rsync git subversion mercurial bc \
#libxp-dev missing in Debian9/Ubuntu16.04
```
* Check if 'bash' is the default shell (Debian/Ubuntu standard is dash)?
```
echo $0
#or
echo $SHELL
```
* If output is "-dash" instead of "-bash" run following command and select "no"!
```
sudo dpkg-reconfigure dash
```
* Ensure bash ist default shell (Debian/Ubuntu standard is dash):
Clone the "octonet" and "dddvb" repositories and reset both to a certain commit that actually builds:
```
>dpkg-reconfigure dash
```
and select no.
* Clone the octonet and ddvb repositories:
git clone -b master https://github.com/DigitalDevices/dddvb.git dddvb
cd dddvb
git reset --hard 933779a
#git show #check if current commit is indeed 933779a press 'q' to exit
cd ..
git clone -b master https://github.com/DigitalDevices/octonet.git octonet
cd octonet
git reset --hard cd19e9e
#git show #check if current commit is indeed cd19e9e
./mk.patch
```
>git clone -b master https://github.com/DigitalDevices/octonet.git octonet
>git clone -b master https://github.com/DigitalDevices/dddvb.git dddvb
>cd octonet
>./mk.patch
* Fix Buildroot broken url for i2c-tools!
```
If needed replace branch (master) and repository path with your own.
###Building
Complete build (needed once)
```
>./mk.all
sed -i "s|http://dl.lm-sensors.org/i2c-tools/releases|http://oe-lite.org/mirror/i2c-tools|" buildroot/package/i2c-tools/i2c-tools.mk
```
Rebuild main firmware
```
>./mk
```
###Installing
* Create a subdirectory octonet on a local webserver, enable directory listing.
### Building
Run the following command for a complete build (needed once):
```
>cp buildroot/output-octonet/images/octonet.* <your webserver root>/octonet
./mk.all
```
* For rebuilding main firmware just run:
```
./mk
```
On some servers a .htaccess file with:
```
Options +Indexes
```
in the octonet directory might be necessary.
When building succeeds (after ~20 minutes on a old i7quadcore) the size of the default custom firmware image will be ~5.7MB big and can be found in:
```
ls -la buildroot/output-octonet/images
ls -la buildroot/output-oc
```
### Installing
For upgrading the firmware within the OctopusNet webinterface, you must point it to a local webserver holding these (custombuild) firmware files in a subdirectory "octonet" that uses directory listing. The following commands will let you install a webserver on the very same machine your were building firmware and serve the custom firmware files.
```
sudo apt-get -y install lighttpd
echo 'dir-listing.activate = "enable"' | sudo tee -a /etc/lighttpd/lighttpd.conf
sudo systemctl restart lighttpd.service
sudo mkdir /var/www/html/octonet
sudo cp buildroot/output-octonet/images/octonet.* /var/www/html/octonet/
hostname -I #<WebServer IP>
```
* Check with your webbrowser if the following URL will show a directory listing:
```
http://<WebServer IP>/octonet
```
Configure your OctopusNet(s) to use your buildmachine/webserver as a updateserver on the following URL:
* Configure your OctopusNet(s) to use your webserver as update server:
```
http://<OctopusNet IP>/updateserver.html
```
Initiate update from the OctopusNet
Change the current updateserver address to ipaddress of the <WebServer IP> and Initiate update from the OctopusNet.
Note: for security reasons only private ip addresses (10.0.0.0/8, 172.16.0.0/12, 192.168,0.0/16) are accepted
You can find details about the OctopusNet hardware, the flash memory map and the boot process
in dddvb/docs/octopusnet in the dddvb repo!
You can find details about OctopusNet its hardware, flash memory, boot process and stock firmware:
* [dddvb/docs/octopusnet](https://github.com/DigitalDevices/dddvb/blob/master/docs/octopusnet)
* [firmware archive](http://download.digital-devices.de/download/linux/octonet/)