Convert uC-specific Information and Pinouts to a table about free-pdk.github.io HOT 28 CLOSED

We could also have a column that shows EasyPdkProg support with a minimum version #, or 'in development', or 'read-only', or blank depending on what the support level is.

from free-pdk.github.io.

Edit: Maybe the main layout should also be a bit wider in its default desktop configuration.

I was thinking the same thing. 👍

from free-pdk.github.io.

Oh my, it took me more than one hour to figure out how to override the width settings. But now I should be able to address this...

from free-pdk.github.io.

Ok, all fixed. I hope I did not do something un-jekyllik with the font size.

I'll leave the <br> issue for another day. No good idea how to tackle this now without creating another mess.

from free-pdk.github.io.

Ok, It's live now. Closing this issue.

from free-pdk.github.io.

Not as easy, as the markdown tables are quite inflexible and immediately break the layout. It may be necessary to reduce the number of columns further.

from free-pdk.github.io.

Not as easy, as the markdown tables are quite inflexible and immediately break the layout. It may be necessary to reduce the number of columns further.

You could also use an HTML table in the markdown file, if that is easier.
Regarding the number of columns / width of the table: We should be able to use some CSS trickery to make the table horizontally scrollable (similar to the table-responsive class used by Bootstrap: https://getbootstrap.com/docs/4.5/content/tables/#always-responsive).

from free-pdk.github.io.

Ah, that's a nice table class. How do we get it into this project?

Edit: Maybe the main layout should also be a bit wider in its default desktop configuration.

from free-pdk.github.io.

Oh no, didn't you see #14?

from free-pdk.github.io.

Oh no, didn't you see #14?

oops - i should not multitask so much. Going to merge everything.

I now added added a table. Some device information still needs to be added. Let me see whether your change helps making it dynamic.

from free-pdk.github.io.

I can help lookup / confirm device information. What still needs to be added?

from free-pdk.github.io.

I'll just use your table above to populate the remainder.

I am not sure about the OSS status for every device, though. Are all of the currently listed devices supported?

Other than that, there are still chips missing from here: https://github.com/free-pdk/free-pdk.github.io/tree/development/chips

from free-pdk.github.io.

I'll just use your table above to populate the remainder.

Ok, that should work.

One note... instead of saying ADC: 1x 8-bit, I think we can just say ADC: 8-bit, or ADC: 12ch 8-bit. It is probably assumed that there is only one actual ADC.

Also, we can link the Arch column to the appropriate instruction set html files.

Did we decide whether or not to have a column to the official Padauk website for each device from this table?

I am not sure about the OSS status for every device, though. Are all of the currently listed devices supported?

I believe they are all supported now, but some of them require the 'development' branch of the programmer. That's why I was thinking that maybe we would specific a minimum version number for each IC. The current release 1.2 officially supports PFS154, PFS173, and PMS150C (not sure about PMS15A). The rest of them require the not yet released 'development' branch I believe. I'm not sure if there is a previous (before 1.2) version that supported some of these or not? Maybe the programmer needs a CHANGELOG...

Other than that, there are still chips missing from here: https://github.com/free-pdk/free-pdk.github.io/tree/development/chips

Which chips are missing?

Just noticed the <br>s in the chip files. That feels wrong to me. Are those actually needed for proper layout?

from free-pdk.github.io.

One note... instead of saying ADC: 1x 8-bit, I think we can just say ADC: 8-bit, or ADC: 12ch 8-bit. It is probably assumed that there is only one actual ADC.

Good proposal. Done.

I am not sure about the OSS status for every device, though. Are all of the currently listed devices supported?

I believe they are all supported now, but some of them require the 'development' branch of the programmer. That's why I was thinking that maybe we would specific a minimum version number for each IC. The current release 1.2 officially supports PFS154, PFS173, and PMS150C (not sure about PMS15A). The rest of them require the not yet released 'development' branch I believe. I'm not sure if there is a previous (before 1.2) version that supported some of these or not? Maybe the programmer needs a CHANGELOG...

Hm, indeed. Instead of "Yes", we should probably add the minimum version of SDCC and the programmer. But that will be quite tedious...

Other than that, there are still chips missing from here: https://github.com/free-pdk/free-pdk.github.io/tree/development/chips

Which chips are missing?

PFC154, PFC232 come to mind, but maybe there are also others.

from free-pdk.github.io.

I am not sure about the OSS status for every device, though. Are all of the currently listed devices supported?

I believe they are all supported now, but some of them require the 'development' branch of the programmer. That's why I was thinking that maybe we would specific a minimum version number for each IC. The current release 1.2 officially supports PFS154, PFS173, and PMS150C (not sure about PMS15A). The rest of them require the not yet released 'development' branch I believe. I'm not sure if there is a previous (before 1.2) version that supported some of these or not? Maybe the programmer needs a CHANGELOG...

Hm, indeed. Instead of "Yes", we should probably add the minimum version of SDCC and the programmer. But that will be quite tedious...

Yeah, not sure what to say about SDCC. Technically support started in 3.9.0 I believe, but wasn't really worth using until 4.0.0. And a lot of bugs/improvements have been made since then.

The programmer should be easier to figure out though. Unless we are trying to separate out RO support vs. full support. I vote just focus on full support, cause that is probably what most people will care about.

Other than that, there are still chips missing from here: https://github.com/free-pdk/free-pdk.github.io/tree/development/chips

Which chips are missing?

PFC154, PFC232 come to mind, but maybe there are also others.

I didn't think those were supported yet. I think PFC154 is in progress with the programmer (and working fine with SDCC), but isn't PFC232 a 16-bit IC which isn't yet part of SDCC? Are we wanting to add all devices, or only ones where support is at least in progress?

from free-pdk.github.io.

Hm ok, let's skip the PFC232. It's not yet available, anyways.

from free-pdk.github.io.

Moving these out of the edit that I snuck in that you probably didn't see...

We can link the Arch column to the appropriate instruction set html files.

Did we decide whether or not to have a column to the official Padauk website for each device from this table?

Just noticed the <br>s in the chip files. That feels wrong to me. Are those actually needed for proper layout?

from free-pdk.github.io.

Just noticed the <br>s in the chip files. That feels wrong to me. Are those actually needed for proper layout?

I agree, it's not nice. It's needed create proper breaks for the timer entry. Otherwise it's too long for the table.

from free-pdk.github.io.

Did we decide whether or not to have a column to the official Padauk website for each device from this table?

It's actually already implemented. Clicking on the device name links to the padauk homepage. It's not 100% obvious, but there is only so much space in the table.

from free-pdk.github.io.

Just noticed the <br>s in the chip files. That feels wrong to me. Are those actually needed for proper layout?

I agree, it's not nice. It's needed create proper breaks for the timer entry. Otherwise it's too long for the table.

What does that do to the 'detail' page? Can the breaks be handled by word wrap in css instead? Or, can the table code insert the <br>'s?

from free-pdk.github.io.

Did we decide whether or not to have a column to the official Padauk website for each device from this table?

It's actually already implemented. Clicking on the device name links to the padauk homepage. It's not 100% obvious, but there is only so much space in the table.

Ahh ok. Would it make more sense to flip the links? So, keep the user on this website when they click on the main link (i.e. clicking on the device takes them the detail/pinout page) and have the sub-link take them to Paduak's website.

from free-pdk.github.io.

True

from free-pdk.github.io.

What does that do to the 'detail' page? Can the breaks be handled by word wrap in css instead? Or, can the table code insert the <br>'s?

It would mean introducing a different separator or break it up into two entries. Neither of those options in particularily nice.

from free-pdk.github.io.

What does that do to the 'detail' page? Can the breaks be handled by word wrap in css instead? Or, can the table code insert the <br>'s?

It would mean introducing a different separator or break it up into two entries. Neither of those options in particularily nice.

For the PWM, using a comma and splitting on that in the table code could work. But that wouldn't work quite as nice for the Timers... unless maybe the data was structured like T16, T2/T3. Or reverse that... use '/' as the separator and leave the comma between T2 and T3 alone.

Also, it looks like The PMS154C should have 2x for 8-Bit PWM.

Maybe make the main link slightly larger, and the Padauk link slightly smaller?

The COMP column could be renamed to CMP possibly. That's what Padauk calls it.

Looking pretty good by the way! 👍

from free-pdk.github.io.

PMS154C currently goes to the wrong product page. The correct one is: http://www.padauk.com.tw/en/product/show.aspx?num=14&kind=41

from free-pdk.github.io.

oh, it looks like we are missing the PMS171B, which is also supported in the development branch. I'll working on a separate PR to add pinouts and chip support.

I'll make a separate issue for that too.

from free-pdk.github.io.

<br> issue is now also addressed in development branch.

from free-pdk.github.io.

<br> issue is now also addressed in development branch.

Looks like a reasonable enough approach. 👍

from free-pdk.github.io.