https://docs.halium.org/en/latest/supplementary/index.html

Device Overview
Hardware Enablement
How 2 Document

These three links lead to 404, while they are already written: https://github.com/Halium/docs/tree/master/supplementary

So I ran into this trying to port halium to the OnePlus 5, but libssl-dev is required to build hybris-boot and doesn't seem to be listed as a required build library. It might not hurt to have it added. HTML is not a language I know at all, so I wouldn't be the one to fix that.

Hey, I have a samsung device....
I built hybris-boot, but i stucked at samsung logo screen, so I tried to use telnet debugging in init script.
After a week of trying, I found that the issue was the mac address.
This issue happens when the output of $ ip addr is something like:

6: enp0s29u1u3: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
link/ether 00:00:00:00:00:00 brd ff:ff:ff:ff:ff:ff

(I pasted only my rndis interface)
As you can see, there is "link/ether 00:00:00:00:00:00" in the second line. (the "brd ff:ff:ff:ff:ff:ff" is useless for us). This means that there is no MAC address assigned to the interface, and if I try to bring it up with $ ip link set MyInterface up , I'll get:

RTNETLINK answers: Cannot assign requested address

To get rid of this error, you just have to assign a MAC address with:

$ ip link set interface address 02:01:02:03:04:08

Change "interface" with your RNDIS interface name.
Also 02:01:02:03:04:08 is just an example. You can set whetever MAC you want, it just need to be a "valid" mac. Otherwise the one in the example will work, so, there's no need to change it.

After assigned the MAC address you can bring the interface up with:

ip link set interface up

Still change "interface" with your RNDIS interface name

When trying to sync to the repo I get this error....

Traceback (most recent call last):
File "/home/aaron/halium/.repo/repo/main.py", line 56, in
from subcmds.version import Version
File "/home/aaron/halium/.repo/repo/subcmds/init.py", line 38, in
['%s' % name])
File "/home/aaron/halium/.repo/repo/subcmds/upload.py", line 27, in
from hooks import RepoHook
File "/home/aaron/halium/.repo/repo/hooks.py", line 472
file=sys.stderr)
^
SyntaxError: invalid syntax

I am trying to build for a Samsung tab 4.7.0 (degaswifi) any help would be appreciated.

It would help me if someone could document how I can connect to the internet from the device.

In the porting guide we have described how to setup local networking between your development machine and the device via usb. I can ping both ways but I can't figure out how to connect to the internet.

Your docs state Android 10 or LineageOS 18.1 support for Halium 10

but shouldnt it be LineageOS 17.1 which is based on Android 10 and not 18.1 which is based on Android 11
https://github.com/Halium/docs/blob/master/porting/get-sources.rst#initialize-and-download-source-tree

the jekyll theme isn't really optimal for our document. There should be an overview table (however it's called what wikipedia has too) and the main view should be wider. maybe we can find a nicer theme for these things

There are too many questions, and we need to document them on website and docs.

On the Get sources page of the build docs, I wasn't sure about where to put vendor blobs.

for example is it
project_root/vendor/handset
or
project_root/vendor/manufacturer/handset

The matrix channel mentioned in the documentation appears to be private. Then should the doc be updated, to explain how to request to join that channel?

hi,
Many users would like to know if their device is ported or what are the current status.
When coming from https://devices.ubuntu-touch.io/ or halium.org or halium doc, it is not so easy to find the link https://github.com/Halium/projectmanagement/issues
Nevertheless, it is maybe the first question of people interested in UT.
I think we should do something about it

Is jekyll the correct tool to use for docs pages? Would it not be better to use a tool made for docs like sphinx (and host it on https://readthedocs.org/) then we can make "easy to navigate" and nice looking docs like this http://docs.octoprint.org/

Please consider for Pull Request for Supplementary Device for the Samsung Galaxy Note 4 (trltexx).

trltexx

https://github.com/gripfastistech/trltexx/blob/master/trltexx.rst

Please advise for revision/information/etc.

@doniks Hi again, can you please explain me the way I can somehow mention the existence of my self-made tool: AutoFix-MKVC? You can read about it and its goals on the repo page. Sincerely waiting for your reply, scriptSQD.

Hi, just realized that all pages inside /docs/supplementary and /docs/porting are displayed and linked correctly inside github but transition via sphinx to Read the docs seems to break these.

Sooner or later one has to update the source tree to get upstream changes.

Everytime I embark about it it becomes a mess. Could some repo/git wizzard please document how to do this properly?

I try usually start with repo sync then I cycle between repo sync --force-sync something/or/another after guessing on some cryptic repo errors. I repeat this until I can't find any cryptic errors anymore. Just now, I did it and it took a good dozen times.

If I have any local work in progress code changes which I am not ready to publish to a public branch it gets a lot more complicated even. Then I get errors like error: Cannot remove project "some/project": uncommitted changes are present. Now starts a fun process of making backups by copying files with local modifications around, or creating other git branches, then deleting changes, until repo sync passes, then even more fun of trying to get my work in progress changes back.

There has to be a sane way to do this.